Merchant Asynchronous Notifications
The merchant has the option to use Intrapay server-to-server notifications mechanism. These are very useful especially for Web Redirect transactions, for such cases when the customer / card holder's browser or connection have issues. We strongly advise our merchants to use it for this flow.
However, these notifications would also help for actions triggered from our Backoffice, either by our staff or merchant's operators (such as Refund, Chargeback etc) - actions that alter the transaction state.
The Intrapay system will send a HTTP POST to the Merchant`s Servers using the `notifyURL` parameter set in the initial transaction call or in the redirect call. Please take note that the `notifyURL` defined needs to be in HTTPS for our server to send information to your server. This call will contain the exact parameters as in the Web Redirect examples for customer redirect back but without the `amount` and `currency` parameters. See below further details:
Merchant Asynchronous Notifications fields
|Order (pSign)||Field Name||Details||Min||Max||Type||Required|
|01||responseCode||Response code status||1||1||Number||Yes|
|02||reasonCode||Reason code - detailed status information||1||3||Number||Yes|
|03||transactionID||API transaction ID||1||64||String||Yes|
|04||orderID||The unique Merchant Order ID||1||64||String||Yes|
|05||executed||The execution date/time representation; format (YYYY-mm-dd HH:mm:ss)||1||19||String||Yes|
|06||bankResultCode||Acquiring Bank result code||1||32||String||No*|
|07||bankAuthCode||Acquiring Bank authorize code||1||32||String||No*|
|08||pSign||The SHA signature used to secure protocol||40||40||String||Yes|
* Please note that `bankResultCode` and `bankAuthCode` fields may not returned, or they could be empty - depending on the acquirer or transaction result.
Example Merchant Asynchronous Notifications (Server to Server):
[POST URL] [MERCHANT'S URL] (from initial transactional call used in `notifyURL` field)
responseCode=1&reasonCode=1 &transactionID=20130221-2AE33B098A974FD66012-DF74FE85577B85B332B &orderID=129834&executed=2012-03-16+14%3A02%3A29 &bankResultCode=018021&bankAuthCode=690345 &pSign=ef03730ad03613bf50693e1325f00d2bda3c3346