Webhooks enable real-time notifications and data transfer between systems by sending HTTP POST requests to a specified call back URL when specific events occur. Note: It might happen that we might call webhook multiple times with the same parameters. You are requested to handle such cases at your end using a client transaction ref field.
{
"StatusCode": 1,
"Message": "Credited to beneficiary Name on DD/MM/YY HH:mm:ss ",
"Data": {
"TransactionId":120120XX,
“UTR”: 1213456
"Description": "Credited to beneficiary Name on DD/MM/YY HH:mm:ss ",
"TransactionStatus": 1,
"ClientOrderId": "123456789xumNDYt0",
"PaymentMode": "IMPS",
"Amount": 12345.00000,
"Date": " DD/MM/YY HH:mm:ss ",
"Checksum":
"Iu+6blLqZ8lKRcXXXXXXXXXwfh9vcu4ljJXXXXXYYGHVjAZmMhcIqczFSkvXmo9LLdzGADNOUupRi
fQFsjbGLZkVAQ6kemmxd10akTOSJmJ14PyWKFJ+TFNEurnkasRnAbqxZCVhSu8ONmVw
p+KvdP/0gX37B0oC6qDSY/vN/BWpxTIeD6MjNzK8HFsqpXiQa5MOp476dmxP6E0bmHa
VZ3fA9o+Fi6F0afBOBVPZf1KWC5w7ZI2wEINcDFMZmv9953KpEIVJXQrhuc4XwPvX8AJ
m70057S1iBSiseuTVEMHr2lkQrBIThU4O42Es034kCWyitbak0dEwD34ljdEsDdahJsqg=="
}
}
Response Parameter:
| Key | Type | Description |
|---|---|---|
| statusCode | Integer | 1=> In case statusCode is 1 get the final status from status parameter. Else ignore. |
| Message | String | Transaction message |
| Data | NULL | |
| TransactionId | Integer | Unique Transaction Reference Number of Distril |
| UTR | Integer | Unique transaction Reference |
| Description | String | Description |
| TransactionStatus | Integer | Transaction Status: 1 = Success/2 = Pending/ 3 = Processing/0 = Failure/ 4 = Reversal/ 5 = Cancelled / 6 = Expired |
| OrderId | String | Unique Client Transaction Reference Number |
| PaymentMode | String | IMPS |
| Amount | Integer | Txn amount |
| Date | String | Txn Date |
| Checksum | String (This is optional verification) | You can Use the Checksum to verify if the request has not been tampered with. To verify the Checksum at your end, you need your webhook secret key along with the payload. Step 1: Generate the checksum at your end using the payload and secret key at your end. Use AES-128 to generate checksum. IV will be default as 1234567890123456. Step 2: Convert the generated checksum to base64 string. Step 3: Match your generated checksum and the checksum you received in the webhook. If it matches accept the webhook else reject. |