---
page_title: Incoming Mandate Status
product: UPI TPAP SDK
platform: React Native
page_source: https://juspay.io/in/docs/upi-tpap-sdk/react-native/backend-apis/incoming-mandate-status
openapi: https://juspay.io/in/docs/api/swagger?document=https%3A%2F%2Fjuspay.io%2Fin%2Fdocs%2Fupi-tpap-sdk%2Freact-native%2Fbackend-apis%2Fincoming-mandate-status%3Fversion%3Ddefault
llms_txt: https://juspay.io/in/docs/llms.txt
product_llms_txt: https://juspay.io/in/docs/upi-tpap-sdk/llms.txt
---

## API Version: default


## Incoming Mandates Status



This is a Server-to-Server API that takes org_mandate_id and issuing_psp as a path variable and returns the status of the order along with other details. ## Endpoints:
- Sandbox: https://sandbox.juspay.in/upi/inapp/mandate/status

- Production: https://api.juspay.in/upi/inapp/mandate/status

## Request Type: 
GET

## Content-Type: 
application/json

## Headers:

#### x-merchantid:
Merchant ID provided by Juspay
- Value: Example: merchant-id
- Tags: string, required
## Sample Code Snippets:
### Code Snippets:

#### Shell Code Snippet:

```shell
{"success":false,"message":"Failed to fetch snippet"}
```

### Sample Response:

#### JSON:
```plaintext
{"success":false,"message":"Failed to fetch snippet"}
```

## Query Parameters:

#### org_mandate_id:
Org mandate id of the mandate
- Value: Example: YJP11gsqszvoufoceulauTfJQFDwLgreWnY
- Tags: string, required

#### issuing_psp:
Issuing psp name
- Value: Example: YES_BIZ
- Tags: string, required
## API Responses:
### 200:

#### payer_vpa:
- Description: Vpa of the upi user who sent the payment.
- Tags: string

#### payer_merchant_customer_id:
- Description: Merchant generated unique id for customer who sent the payment.
- Tags: string

#### payee_vpa:
- Description: Vpa of the upi user who received the payment.
- Tags: string

#### payee_mcc:
- Description: payee Merchant Category Code
- Tags: integer

#### merchant_id:
- Description: Unique id for merchant.
- Tags: string

#### merchant_channel_id:
- Description: Unique id for the channel via which request is made.
- Tags: string

#### masked_account_number:
- Description: Masked account number for the customer bank account used for transaction. Only if gatewayResponseCode is non 'U69'.
- Tags: string

#### bank_code:
- Description: IIN for the customer bank account used for transaction. Only if gatewayResponseCode is non 'U69'.
- Tags: string

#### bank_account_unique_id:
- Description: Unique hash for the customer bank account used for transaction. Only if gatewayResponseCode is non 'U69'.
- Tags: string

#### ref_url:
- Description: Invoice as sent by merchant or reference to the transaction in the form of url.
- Tags: string

#### merchant_request_id:
- Description: Merchant generated request id as passed in the collect request. Only if gatewayResponseCode is not 'U69'.
- Tags: string

#### gateway_transaction_id:
- Description: UPI request id returned by gateway for the transaction.
- Tags: string

#### gateway_response_code:
- Description: Response code returned by gateway for the transaction. [Click here](../resources/error-codes) for mandate gateway response codes.
- Tags: string

#### gateway_reference_id:
- Description: Customer reference number (rrn) for the transaction.
- Tags: string

#### message:
- Description: response message returned by gateway for the transaction.
- Tags: string

#### date_created:
- Description: Timestamp of when the payment
- Tags: string

#### amount:
- Description: Amount for which customer made the payment.
- Tags: double

#### mandate:
- Description: Object containing mandate details
- Tags: JSON
### 400:

#### status:
- Description: Bad Request

#### error_code:
- Description: Details of keys missing
- Value: Example: Mandatory fields are missing

#### error_message:
- Description: Further Details of keys missing
### 401:

#### status:
- Description: error

#### error_code:
- Description: access_denied
### 500:

#### status:
- Description: error

#### error_code:
- Description: Internal server Error


---

## See Also

- [P2P Transaction Status](https://juspay.io/in/docs/upi-tpap-sdk/react-native/backend-apis/p2p-transaction-s)
- [Refund API](https://juspay.io/in/docs/upi-tpap-sdk/react-native/backend-apis/refund-api)