--- page_source: https://docs.juspay.io/upi-inapp/android/backend-apis/p2p-transaction-s page_title: P2P Transaction Status --- ## API Version: default ## P2P Transaction Status This is a Server-to-Server API that takes upi_request_id, issuing_psp and transaction_type as a path variable and returns the status of the order along with other details. ## Endpoints: - Sandbox: https://sandbox.juspay.in/upi/inapp/transactions/status - Production: https://api.juspay.in/upi/inapp/transactions/status ## Request Type: GET ## Content-Type: application/json ## Authorization: #### Basic Auth: Consists of two parts. * Username: API Key obtained from Juspay dashboard * Password: Empty string - Value: Example: MUQ2QUZEQzhFQTY0OUU5QTIxQzNFNTQwNkFDMEZCOg== - Tags: Base64 Encoded username:password, required ## Headers: #### x-merchantid: Merchant ID provided by Juspay - Value: Example: merchant-id - Tags: string, required ## Sample Code Snippets: ### Code Snippets: #### Shell Code Snippet: ```shell curl --location --request GET '{endpoint}/upi/inapp/transactions/status?upi_request_id={upiRequestId}&issuing_psp={issuingPsp}&transaction_type={txnType}' \ --header Content-Type:application/x-www-form-urlencoded'\ --header'x-merchantid: stock ' --header 'Authorization: Basic OTc5Mzcx*****czRTlGOg==' ``` ### Sample Response: #### JSON: ```plaintext { "upi": { "payer_vpa": "0f0c1958c13847e9b53e53b82a46551f@ypay", "payer_mobile_number": "917829808362", "payer_merchant_customer_id": "0ecf736f-8268-4670-b148-b9b2912f0df7", "payee_vpa": "growwuat@ypay", "payee_name": "groww", "payee_mcc": "1520", "merchant_id": "GROWWUAT", "merchant_channel_id": "GROWWUATAPP", "masked_account_number": "XXXXXXXXXX890125", "bank_code": "500004", "bank_account_unique_id": "a793d32345d83bca048d9184559d12d8f2a6267c480140e3fc7cb12b7bda1446" }, "transaction": { "seq_number": "1", "ref_url": "https://www.juspay.com/", "merchant_request_id": "eulmTPi4eaUV3HgCkqk", "gateway_transaction_id": "AXBd4353cfd54e549a6bf8bf44683d27f5e", "gateway_response_code": "00", "gateway_reference_id": "204209453129", "custom_response": "{}" }, "payment_method_type": "UPI", "payment_method": "UPI", "message": "Your transaction is successful", "date_created": "2022-02-11T09:59:32Z", "amount": "5000.00" } ``` ## Query Parameters: #### upi_request_id: Request id of the transaction whose status is to be checked - Value: Example: AXBd4353cfd54e549a6bf8bf44683d27f5e - Tags: string, required #### issuing_psp: Issuing psp name - Value: Example: YES_BIZ - Tags: string, required #### transaction_type: Type of transactions:**MERCHANT_CUSTOMER_RECEIVED_MONEY** - To get a final response for an incoming money to a customer via payMERCHANT_CUSTOMER_CREDITED_VIA_COLLECT - To get a final response for an incoming money via collect approval/declined**MERCHANT_CUSTOMER_DEBITED_FOR_MERCHANT_VIA_PAY** - To get final response for P2M pay transaction (customer paying money to same merchant)**MERCHANT_CUSTOMER_DEBITED_VIA_PAY** - To get final response for SEND_MONEY transaction (customer paying money to different merchant or customer)**MERCHANT_CUSTOMER_DEBITED_FOR_MERCHANT_VIA_COLLECT** - To get a final response for a outgoing collect approval/declined for same merchant**MERCHANT_CUSTOMER_DEBITED_VIA_COLLECT** - To get a final response for a outgoing collect approval/declined for different merchant or customer**MERCHANT_CUSTOMER_COLLECT_REQUEST_SENT** - Outgoing Collect Request from Customer - 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: string #### 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 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 ### 400: #### status: - Description: Bad Request - Tags: string #### error_code: - Description: Details of keys missing - Value: Example: Mandatory fields are missing - Tags: string #### error_message: - Description: Further Details of keys missing - Tags: string ### 401: #### status: - Description: error - Tags: string #### error_code: - Description: access_denied - Tags: string ### 500: #### status: - Description: error - Tags: string #### error_code: - Description: Internal server Error - Tags: string