To integrate with Shinkansen’s payment network, participants must implement the following webhooks to receive real-time notifications regarding transaction processing events.
Receive Responses
This webhook handles the final response of payment transactions initiated by the participant. It provides confirmation of the transaction outcome and includes the following details:
- Transaction status:
okorerror - Response status:
approvedor response code from IFR/CCA - Network metadata including timestamps and authorization code
This webhook ensures that participants are informed of the definitive outcome of their outgoing requests.
Receive Transactions
This webhook is triggered when the participant receives a request to process an incoming electronic funds transfer (TEF). These transactions may originate from:
External banks or payment institutions connected via clearing houses (e.g., RedBanc, CCA)
The participant is expected to process the incoming transaction in accordance with the agreed service levels and business rules.
Receive Reversals
This webhook notifies the participant about conditional reversal requests that may arise due to various operational scenarios, including but not limited to:
- Timeout when no response is received from the IFR (Institution Forward Receiver)
- Failure to deliver the transaction response to the IFO (Institution Forward Originator)
- Network issues like MAC validation failures reported by the IFO
These notifications help participants maintain data consistency and manage exception handling processes properly.