Notification/Callback
Merchant needs to provide notificationUrl in the initial request, where he’ll receive notification response from platform upon completion of transaction.
Successful & fail response specification:
| Parameter | Description | Format | Required |
|---|---|---|---|
| paymentId | Transaction ID of previously placed successful transaction. | N10 [0-9] |
Yes |
| status | Status of the transaction. You can refer status descriptions for more detailed information. | AN255 [a-zA-Z0-9] |
Yes |
| transactionStatus | Status of the transaction processed. Possible values are, ‘Y’ – Successfully processed ‘N’ – Failed ‘P’ – Pending ‘3D’ – Pending for 3D authentication ‘C’ – Cancelled |
A2 [Y|N|P|3D|C] |
Yes |
| paymentBrand | Type of Card while placing the transaction.For ex: VISA, MC | AN32
[a-zA-Z0-9] {1,32} |
Yes |
| paymentMode | Payment method for paying amount.For ex: CC for Credit Cards | AN32
[a-zA-Z0-9] {1,32} |
Yes |
| firstName | First name of the cardholder. | AN50 [A-Za-z0-9] |
Optional |
| lastName | Last name of the cardholder. | AN50 [A-Za-z0-9] |
Yes |
| amount | Amount of the transaction. The dot needs to add to separate the decimal. | N13
[0-9]{1,10}\.[0-9]{2} |
Yes |
| currency | Currency of the transaction. | A3
[a-zA-Z]{3} |
Yes |
| descriptor | Display name of the merchant. | AN127 [a-zA-Z0-9\\p{Space}\\,]+[a-zA-Z0-9\\p{Space}\\,]+ |
Conditional |
| merchantTransactionId | Unique ID sent at the time of transaction. | AN100 [a-zA-Z0-9\\p{Space}\\-_.]{1,100} |
Conditional |
| remark | Transaction remark from respective gateway. | AN255 [a-zA-Z0-9] |
Yes |
| tmpl_amount | Customized amount of customer, template amount can be same as transaction amount. | N13 [0-9]{1,10}\\.[0-9]{2} |
No |
| tmpl_currency | Currency of the customized amount to facilitate customer, template currency can be same as transaction currency, Accept only 3 character currency code in capital letters. | A3 [A-Z]{3} |
No |
| checksum | MD5 checksum generated using merchant credentials for request authentication. | AN32 [a-fA-F0-9]{32} |
Yes |
| result.code | Response code indicating the transaction status. | AN11 [0-9\.]{2,11} |
Yes |
| result.description | Description corresponding to the response code. | AN255 [a-zA-Z0-9\\p{Space}\\,]+[a-zA-Z0-9\\p{Space}\\,]+ |
Yes |
| customer.email | Email address of the customer. | AN100 [A-Za-z0-9._%'-]+@[A-Za-z0-9.-]+\\.[a-zA-Z]{2,100} |
Yes |
| customer.id | Customer ID in merchant’s system. | AN20 [A-Za-z0-9] |
Conditional |
| card.bin | Customer card number (PAN). | N19 [0-9]{13,19} |
Yes |
| card.lastFourDigits | Last four digits of the payment card. | N4 [0-9]{4} |
Yes |
| card.last4Digits | Last four digits of the payment card. | N4 [0-9]{4} |
Yes |
| card.expiryMonth | Card expiry month. | N2 [0-9] |
Yes |
| card.expiryYear | Card expiry year. | N4 [0-9] |
Yes |
| timestamp | Shows at what time the transaction has been placed. | date yyyy-MM-dd hh:mm:ss |
Yes |
| eci | eci is the two or three digit code that is returned by the credit card processing networks and issuing banks.For VISA eci code is (05,06,07)and for MasterCard eci code is(01,02). | N3 [0-9] |
Optional |
| bankReferenceId | Unique transaction id at Bank side | AN32 N[0-9\-] |
Optional |
| terminalId | terminalid at the gateway side | AN32 N6[0-9]{1,6} |
Optional |
Payin Successful Response
Payin Fail Response