AI Router sends a server-to-server (S2S) response in key-value pairs on the webhook configured and on callback URL. Payment Success Webhook response is sent for the final transaction status i.e. success or failed. This webhook for payment status can be configured from merchant dashboard.
Body
| Attributes | Description | Type |
|---|---|---|
| ORDERID | OrderId passed in the request Example: OREDRID_98765 |
String |
| MID | Merchant ID passed in the request Example: YOUR_MID_HERE |
String |
| TXNID | Unique reference number generated at AI router side for each transaction Example: 202005081112128XXXXXX68470101509706 |
String |
| TXNAMOUNT | Payment transaction Amount Example: 1.00 |
String |
| CURRENCY | Payment currency type Example: INR |
String |
| PAYMENTMODE | Payment Mode used in payment Example: PPI |
String |
| TXNDATE | Transaction Date Example: 7/24/2020 15:13:02 |
String |
| STATUS | This parameter indicates the status of an API call. Example: TXN_SUCCESS |
String |
| RESPCODE | This is the resultCode corresponding to a particular message and is returned to the merchant. Its maximum length is 64. For a list of different RESPCODE and RESPMSG please refer to the PDF. Example: 01 |
String |
| RESPMSG | This parameter is the result message which contains information about the result. Example: Txn Success |
String |
| GATEWAYNAME | Name of the gateway used to process the transaction, this is the payment aggregator chosen to process the transaction. Example: PAYTM, BILLDESK |
String |
| GATEWAYINFO | Response provided by the gateway during payment or transaction. | String |
| BANKTXNID | Unique reference number generated at the bank side for each transaction Example: 62909899 |
String |
| BANKNAME | Bank Name used in payment Example: WALLET |
String |
| CHECKSUMHASH | AI router validates the request and ensures that parameters are not tempered by verifying the signature in the request. For creating the checksum (signature) refer to the steps given in Checksum Logic. | String |
| GATEWAYRESULTINFOCODE | Result code from payment gateways / aggregators | String |
| GATEWAYRESULTINFOMSG | Result message from payment gateways / aggregators | String |
Success
Payment Gateway
QR Code
Payment Links
Payment Invoice
Subscriptions
International Merchants
AI Router
Food Wallet
Paytm Cash
Paytm Gold
Smart Retail
POS Hardware
{
"GATEWAYNAME":"Paytm",
"PAYMENTMODE":"NB",
"TXNDATE":"2022-05-22",
"TXNDATETIME":"2022-05-22 22:17:46.0",
"CUSTID":"0007804105",
"STATUS":"TXN_SUCCESS",
"MID":"YOUR_MID_HERE",
"ORDERID":"REN2205223CJHVBQCRNG",
"CURRENCY":"INR",
"TXNID":"20220522XXXX12809100168156603280537",
"TXNAMOUNT":"11451.90",
"BANKTXNID":"20220522111212800100168934054879098",
"BANKNAME":"State Bank of India",
"RESPMSG":"Txn Success",
"RESPCODE":"01",
"MERC_UNQ_REF":"",
"CHECKSUMHASH":"Vt1V3/qLkJ6lwfbHbTPfMLdW/M4Muyw2netnjTnqxYqz/kLqSbjb6tccUGVr8tVzpjpNUF5BohBPwchec6I+KOcByre1t0L5jiEGW6vNvI8=",
"RRN":"IGANPYQPO8",
"GATEWAYINFO":"{\"TXNID\":\"20220522111212800100168934054879098\",\"BANKTXNID\":\"IGANPYQPO8\",\"ORDERID\":\"REN2205223CJHVBQCRNG\",\"TXNAMOUNT\":\"11451.90\",\"STATUS\":\"TXN_SUCCESS\",\"TXNTYPE\":\"SALE\",\"GATEWAYNAME\":\"SBI\",\"RESPCODE\":\"01\",\"RESPMSG\":\"Txn Success\",\"BANKNAME\":\"SBI\",\"MID\":\"MERCH64129621595501\",\"PAYMENTMODE\":\"NB\",\"REFUNDAMT\":\"0.00\",\"TXNDATE\":\"2022-05-22 22:18:46.0\",\"UDF_1\":\"20220522325548145315\"}"
}
Failure
{
"GATEWAYNAME":"Paytm",
"PAYMENTMODE":"NB",
"TXNDATE":"2022-05-24",
"TXNDATETIME":"2022-05-24 22:51:47.0",
"CUSTID":"",
"STATUS":"TXN_FAILURE",
"MID":"YOUR_MID_HERE",
"ORDERID":"REN240522WTK0QFAS2M7",
"CURRENCY":"INR",
"TXNID":"20220524XXXX12809100168274403277312",
"TXNAMOUNT":"11082.06",
"BANKTXNID":"20220524111212800100168477054924419",
"BANKNAME":"Axis Bank",
"RESPMSG":"Your payment has been declined by your bank. Please try again or use a different method to complete the payment.",
"RESPCODE":"227",
"MERC_UNQ_REF":"",
"CHECKSUMHASH":"p/CE3ZyQqFk0XypY24G/JRONcf2U0IlXtGx9a1zeHDLLLLk+cro5vb3WIWpcdMvdJ10pNSWDJnQiedt1BBjArG0Sc79SSD6ncvcx7HEIcMo=",
"AUTHCODE":"",
"RRN":"",
"GATEWAYINFO":"{\"TXNID\":\"20220524111212800100168477054924419\",\"BANKTXNID\":\"\",\"ORDERID\":\"REN240522WTK0QFAS2M7\",\"TXNAMOUNT\":\"11082.06\",\"STATUS\":\"TXN_FAILURE\",\"TXNTYPE\":\"SALE\",\"GATEWAYNAME\":\"AXIS\",\"RESPCODE\":\"227\",\"RESPMSG\":\"Looks like you have abandoned the payment. Please try again\",\"BANKNAME\":\"AXIS\",\"MID\":\"MERCH64129621595501\",\"PAYMENTMODE\":\"NB\",\"REFUNDAMT\":\"0.0\",\"TXNDATE\":\"2022-05-24 22:51:54.0\",\"UDF_1\":\"20220524326341974827\"}"
}
