---
page_source: https://juspay.io/in/docs/upi-merchant-stack/docs/transactions/transaction-status-360
page_title: Transaction Status 360
---

## API Version: default


# Transaction Status 360



This api will be used for getting the status for P2M transaction and the response will be similar to callback response for the `transactionType` passed in the request.

Below are the possible values for `transactionType`


| transactionType | Callback Type |
|---|---|
| MERCHANT_CREDITED_VIA_PAY	 | Pay Callback (Incoming Money to Merchant) |
| MERCHANT_CREDITED_VIA_COLLECT	 | Collect Callback (Incoming Money to Merchant) |


**Transaction Status responseCode** 


| responseCode | HTTP | Meaning |
|---|---|---|
| REQUEST_NOT_FOUND | 200 | This error will be given in case transaction was not created using any such merchantRequestId or upiRequestId |
| REQUEST_EXPIRED | 200 | This error will be returned for user dropout based on sent expiry time during Register Intent. |
| DROPOUT | 200 | Only given for UPI Plugin flow based on InApp SDK response [errorCode-errorMessage] |
## Endpoints:
- Production: {{host}}/api/{{uri}}/merchants/transactions/status360

## Request Type: 
POST

## Content-Type: 
application/json

## Headers:

#### jpupi-routing-id:
For mandate execution related transactions, the Header value should be same as of **originalMerchantRequestId**  sent in request body.

For any other transactions, the Header value should be same as of **merchantRequestId**  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:
### Parameters:

#### merchantRequestId:
- Description: **merchantRequestId**  of the transaction whose status is to be checked.
- Tags: String, mandatory

#### transactionType:
- Description: Type of transaction.
- Tags: String, Mandatory

#### transactionTimestamp:
- Description: Timestamp of the transaction. Passing this parameter will help PSP to optimize the status retrieval for the transaction.

**Format:**  YYYY-MM-DDTHH:MM:SS+05:30
- Tags: String, Optional

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

#### 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
### For Dynamic VPA :

#### upiRequestId:
- Description: In case of dynamic Vpa resolution, pass this field.
- Value: value
- Tags: String, Mandatory
## API Responses:
### 200:

#### status:
- Description: PSP 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 the payment.
      
      **Values:** Amount in two decimals. Decimals are mandatory.
    - Tags: String, Mandatory
  - **BankAccountUniqueId**:
    - Description: Unique id for the selected bank account.
      
      **Values:** As passed in the request.
    - Tags: String, Mandatory
  - **BankCode**:
    - Description: Bank code of the account which was used.
      
      Value: Valid bank IIN.
    - Tags: String, Mandatory
  - **CustomResponse**:
    - Description: Stringified JSON parameter for future use.
    - Tags: String, Mandatory
  - **GatewayPayerResponseCode**:
    - Description: Response code returned by gateway.
    - Tags: String, Optional
  - **GatewayPayeeResponseCode**:
    - Description: Response code returned by gateway.
    - Tags: String, Optional
  - **GatewayPayerReversalResponseCode**:
    - Description: Response code returned by gateway.
    - Tags: String, Optional
  - **GatewayPayeeReversalResponseCode**:
    - Description: Response code returned by gateway.
    - Tags: String, Optional
  - **GatewayReferenceId**:
    - Description: Reference id returned by the gateway.
    - Tags: String, Mandatory
  - **GatewayResponseCode**:
    - Description: Response code returned by gateway.
    - Tags: String, Mandatory
  - **GatewayResponseMessage**:
    - Description: Response message for code returned by gateway.
    - Tags: String, Mandatory
  - **GatewayResponseStatus**:
    - Description: Response status returned by gateway.
    - Tags: String, Optional
  - **GatewayTransactionId**:
    - Description: Transaction id returned by gateway.
    - Tags: String, Mandatory
  - **MerchantId**:
    - Description: Unique id for the merchant as passed in request headers.
    - Tags: String, Mandatory
  - **OrgMandateId**:
    - Description: Refers to upiRequestId used during creation of mandate.
      
      As passed for upiRequestId in the request.
    - Tags: String, Optional
  - **PayeeMcc**:
    - Description: MCC code of the merchant.
    - Tags: String, Mandatory
  - **PayeeMerchantCustomerId**:
    - Description: Merchant generated unique id for customer who received the payment. Only if it is an onus P2P transaction.
    - Tags: String, Mandatory
  - **PayeeVpa**:
    - Description: Vpa of the upi user who received the payment.
    - Tags: String, Mandatory
  - **PayerName**:
    - Description: Name of the payer to whom collect request was sent.
    - Tags: String, Optional
  - **RefUrl**:
    - Description: Invoice as sent by merchant or reference to the transaction in the form of url.
    - Tags: String, Mandatory
  - **RiskScore**:
    - Description: RiskScore shared by NPCI or Bank.
    - Tags: String, Optional
  - **SeqNumber**:
    - Description: Denotes the recurring cycle of mandate execution. Will be received only during mandate executions. It will only be present in case of mandate request.
    - Tags: String, Optional
  - **TransactionTimestamp**:
    - Description: Timestamp of when the payment was received. 
      
      **Format:** (YYYY-MM-DDTHH:MM:SS+05:30).
    - Tags: String, Mandatory
  - **Type**:
    - Description: Event type of the transaction.
    - Tags: String, Mandatory
  - **Umn**:
    - Description: Vpa used for execution of mandate.
    - Tags: String, Optional
  - **MerchantChannelId**:
    - Description: Unique id for the merchant channel as passed in request headers.
    - Tags: String, Mandatory
  - **MerchantRequestId**:
    - Description: Merchant generated unique id for collect request.
      
      **Constraint** : Max 35 characters & Alphanumeric.
    - Tags: String, Mandatory
  - **PayerAccountHash**:
    - Description: As passed in the request body.
    - Tags: Array Of String, Conditional
- Tags: Json String, Mandatory

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

Example: "{\"udf1\":\"value1\",\"udf2\":\"value2\",…}"
- Tags: stringified JSON, Optional