---
page_source: https://juspay.io/in/docs/upi-merchant-stack/docs/mandates/notification-status
page_title: Notification Status
---

## API Version: default


## Notification Status



This api will be used by Merchant for checking the status of the mandate notification.## Endpoints:
- Production: {{host}}/api/{{uri}}/merchants/mandates/webNotify/status

## Request Type: 
POST

## Headers:

#### jpupi-routing-id:
Header value should be same as of **originalMerchantRequestId**  sent in request body
- Tags: String, Mandatory
## Sample Code Snippets:
### Code Snippets:

#### Shell Code Snippet:

```shell
{"success":false,"message":"No Data found for the given path"}
```

### Sample Request and Response:

#### Request:
```json
{"success":false,"message":"No Data found for the given path"}
```

#### Response:
```json
{"success":false,"message":"No Data found for the given path"}
```

## Body Parameters:
### Request parameters:

#### merchantRequestId:
- Description: **merchantRequestId**  of the Notification whose status is to be checked.
- Value: value
- Tags: String, Mandatory

#### iat:
- Description: Current Epoch Unix timestamp string. Has to be of 13 digit in Milliseconds.

Example: 1496918882000.
- Tags: String, Mandatory

#### originalMerchantRequestId:
- Description: Merchant request of the **original create mandate request.** 
- Tags: String, Optional But Mandatory For New Integration

#### udfParameters:
- Description: Merchant Defined Parameters

Example: "{\"udf1\":\"value1\",\"udf2\":\"value2\",…}"**Note** : Few special characters are not allowed. Regex for the characters which are not allowed : **^[^/#-()*!%~`]+$** 
- Tags: Stringified JSON, Optional
## API Responses:
### 200:

#### status:
- Description: Status of the API.

**Values:** SUCCESS, FAILURE.
- Tags: String, Mandatory

#### responseCode:
- Description: PSP response code for the API.

**Values:** Refer Codes Guide in Resource Section.
- Tags: String, Mandatory

#### responseMessage:
- Description: PSP response message for the API.

**Values:** Refer Codes Guide in Resource Section.
- Tags: String, Mandatory

#### payload:
- Value:
  - **Amount**:
    - Description: Amount for which merchant requested the mandate
      
      **Values:** As passed in request
    - Tags: String, Mandatory
  - **GatewayResponseCode**:
    - Description: Response code returned by gateway for the notification.
      
      **Values:** 00
    - Tags: String, Mandatory
  - **GatewayResponseMessage**:
    - Description: Response message returned by gateway for the transaction.
    - Tags: String, Mandatory
  - **GatewayResponseStatus**:
    - Description: Response message returned by gateway for the notification.
    - Tags: String, Mandatory
  - **GatewayTransactionId**:
    - Description: upiRequestId as passed on request
    - Tags: String, Mandatory
  - **MerchantChannelId**:
    - Description: Unique id for the channel via which request is made.
      
      **Values:** As passed in request.
    - Tags: String, Mandatory
  - **MerchantId**:
    - Description: Unique id for merchant.
      
      **Values:** As passed in request.
    - Tags: String, Mandatory
  - **MerchantRequestId**:
    - Description: Merchant generated unique id for collect request.
      
      **Constraint** : Max 35 characters & Alphanumeric.
    - Tags: String, Mandatory
  - **NextExecution**:
    - Description: Mandate execution time in minutes from current time.
      
      **Format:** String with proper date format (YYYY-MM-DDTHH:MM:SS+05:30).
    - Tags: String, Mandatory
  - **OrgMandateId**:
    - Description: gatewayMandateId returned in create mandate.
      
      **Values:** As passed for gatewayMandateId in webMandate request.
    - Tags: String, Mandatory
  - **Umn**:
    - Description: umn returned in create mandate callback.
      
      **Values:** As passed in request.
    - Tags: String, Mandatory
  - **SeqNumber**:
    - Description: Sequence Number of execution.
    - Tags: String, optional
  - **GatewayReferenceId**:
    - Description: Customer reference number (rrn) for the transaction.
    - Tags: String, optional
- Tags: json, Mandatory

#### udfParameters:
- Description: Merchant Defined Parameters

Example: "{\"udf1\":\"value1\",\"udf2\":\"value2\",…}"
- Tags: Stringified JSON, optional