---
title: Notify API
description: Send advance notifications for upcoming subscription or mandate debits.
---

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.

#### POST

```
https://payments.airpay.co.in/pay/v4/api/mandates/notify.php
```

## 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

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| subscription_id  required | Numeric  <br>(1–10) | Unique identifier assigned to the subscription or mandate. |
| notification_id  required | Alphanumeric | Unique order reference associated with the transaction. |
| amount  required | Numeric  <br>(1–10) | Transaction amount to be executed under the mandate. |
| execution_times  required | Alphanumeric  <br>(Date (dd/mm/yyyy)) | Scheduled execution date for the transaction or subscription debit. |

## Success 200

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| merchant_id  required | Numeric | Unique identifier assigned to the merchant. |
| orderid  required | Alphanumeric<br>(`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. |