Notify API
Send advance notifications for upcoming subscription or mandate debits. Ensures customers remain informed about recurring charges, enhancing transparency and reducing the risk of failed payments.
https://payments.airpay.co.in/pay/v4/api/mandates/notify.phpHeader
Section titled “Header”| Parameter | Type Value | Description | Value Like |
|---|---|---|---|
| Content-Type required | String | The Content-Type header specifies the media type of the request or response body, allowing the receiver to correctly interpret the For XML data, use application/xml. | For JSON: application/json,For XML: application/xml |
Request Body
Section titled “Request Body”| Parameter | Type Value | Description | Value Like |
|---|---|---|---|
| subscription_id required | Numeric (1–10) | Unique identifier assigned to the subscription or mandate. | |
| notification_id required | Alphanumeric | Unique order reference associated with the transaction. | |
| amount required | Numeric (1–10) | Transaction amount to be executed under the mandate. | |
| execution_times required | Alphanumeric (Date (dd/mm/yyyy)) | Scheduled execution date for the transaction or subscription debit. |
Success 200
Section titled “Success 200”| Parameter | Type Value | Description | Value Like |
|---|---|---|---|
| merchant_id required | Numeric | Unique identifier assigned to the merchant. | |
| orderid required | Alphanumeric ( 10-200) | Unique order reference number for the transaction. | |
| ap_transactionid required | Numeric | Transaction ID assigned by the payment gateway. | |
| amount required | Numeric | Transaction amount. | |
| status_code required | Numeric | Status code representing the transaction result. | 211 = InProcess, 400 = Failed |
| notification_status required | String | Status text representing the payment state. | INPROCESS, SUCCESS, FAILED |
| message required | String | Status message describing transaction result or reason. |