--- page_title: List Complaint product: UPI TPAP SDK platform: Android page_source: https://juspay.io/in/docs/upi-tpap-sdk/android/headless-process-payloads/list-complaint llms_txt: https://juspay.io/in/docs/llms.txt product_llms_txt: https://juspay.io/in/docs/upi-tpap-sdk/llms.txt --- ## List Complaint This API can be used to list all complaints. ### Process Parameters ## Request Payload - **RequestId**: - Description: Unique uuid-v4 string - Value: Example: abcd-12345-abcd-12345 - Tags: String, Mandatory - **Service**: - Description: Value: in.juspay.hyperapi - Tags: String, Mandatory - **Payload**: - Description: Parameters required to call Hyper SDK API - Value: - **Action**: - Description: Operation to be performed in the SDK - Value: upiListPendingComplaints - Tags: String, Mandatory - **Limit**: - Description: Maximum number of rows to be returned. Used for pagination - Value: eg. Number > 0 - Tags: String, Mandatory - **Offset**: - Description: Offset for rows to be returned. Used for pagination - Value: Number >= 0 - Tags: String, Mandatory - **MerchantKeyId**: - Description: Key ID to identify the public-private key pair used for signature generation. - Tags: String, Mandatory - **SignaturePayload**: - Description: Signature payload is a stringified JSON of the details mentioned in the below table. - Value: - **Merchant_id**: - Description: Unique identifier associated with an account created by juspay. Ex: stock - Value: stock - Tags: String, Mandatory - **Customer_id**: - Description: Any unique reference associated with your customer. - Tags: String, Mandatory - **Timestamp**: - Description: Time when request is created in milliseconds. - Tags: String, Mandatory - Tags: String, Mandatory - **Signature**: - Description: Signature generated for the signaturePayload . - Tags: String, Mandatory - Tags: JSON, Mandatory ## Response Payload - **RequestId**: - Description: Unique uuid-v4 string - Value: Example: abcd-12345-abcd-12345 - Tags: String - **Service**: - Description: Value: in.juspay.hyperapi - Tags: String - **Payload**: - Description: Response Parameters - Value: - **Action**: - Description: Operation performed in the SDK - Value: upiListPendingComplaints - Tags: String, Mandatory - **Status**: - Description: Status of the API call. - Value: SUCCESS, FAILURE - Tags: String, Mandatory - **ResponseCode**: - Description: PSP response code for the API - Tags: String, Mandatory - **ResponseMessage**: - Description: PSP response message for the API - Tags: String, Mandatory - **ComplaintsList**: - Description: Array of ListPendingComplaintPayload - Value: - **PayerVpa**: - Description: Payer Vpa - Tags: String, Mandatory - **PayeeVpa**: - Description: Payee Vpa - Tags: String, Mandatory - **OrgTxnStatus**: - Description: Original Transaction Status - Tags: String, Mandatory - **MerchantCustomerId**: - Description: Merchant generated unique profile id for customer as passed in the request - Tags: String, Optional - **CustomerMobileNumber**: - Description: masked phone number of the customer - Value: - Tags: String, Optional - **TransactionUpiRequestId**: - Description: Unique Transaction Request id on which status check is required. - Tags: String, Mandatory - **UpiRequestId**: - Description: Unique request id for upi transaction - Tags: String, Mandatory - **Crn**: - Description: Complaint reference number returned by NPCI - Value: eg. 302570532 - Tags: String, Optional - **OrgTxnDate**: - Description: Original Transaction Date - Tags: String, Mandatory - **ComplaintDate**: - Description: Date of complaint - Tags: String, Mandatory - **Status**: - Description: Current Status of the transaction - Tags: String, Mandatory - **Remarks**: - Description: Remarks or reason for complaint - Tags: String, Mandatory - **ReqAdjAmount**: - Description: Amount of transaction sent in request - Value: 100.00 - Tags: String, Mandatory - **ReqAdjCode**: - Description: Reason code for complaint sent in request - Value: 1082 - Tags: String, Mandatory - **ReqAdjFlag**: - Description: Reason flag for complaint sent in request - Value: eg. PBRB - Tags: String, Mandatory - Tags: Array of JSON, Mandatory - **MerchantId**: - Description: Unique id for the merchant as passed in request - Tags: String, Mandatory - **MerchantChannelId**: - Description: Unique id for the merchant channel as passed in request - Tags: String, Mandatory - **OtherInfo**: - Description: As passed in request - Tags: String, Optional - Tags: JSON - **Error**: - Description: Possible values :- true/false - Tags: Boolean - **ErrorMessage**: - Description: Error Message - Tags: String - **ErrorCode**: - Description: Error Code - Tags: String - **Event**: - Description: Value: process_result - Tags: String #### Code Snippets: - #### Java Code Snippet: ```java { "service": "in.juspay.hyperapi", "requestId": "095fa47e-b528-457d-8310-faece4c37814", "payload": { "action": "upiListPendingComplaints", "limit": 100, "offset": 0, "signature": "", "signaturePayload": "", "merchantKeyId": "1234" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1641533238616" } ``` #### Kotlin Code Snippet: ```kotlin { "service": "in.juspay.hyperapi", "requestId": "095fa47e-b528-457d-8310-faece4c37814", "payload": { "action": "upiListPendingComplaints", "limit": 100, "offset": 0, "signature": "", "signaturePayload": "", "merchantKeyId": "1234" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1641533238616" } ``` ## Sample Code Snippets: ### Request snippets: #### Request Code Snippet: ```request // block:start:listTransactionsReqH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "signaturePayload": "", "signature": "GFe…………………..w==", "merchantKeyId": "1234", "limit": "100", "offset": "0", "action": "upiTransactionList", } } "signaturePayload": { "merchant_id": "stock", "timestamp": "1639147293629" "customer_id":"9876543210", } // block:end:listTransactionsReqH // block:start:listTransactionsRespH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "status": "SUCCESS", "merchantChannelId": "STOCKAPP" "merchantCustomerId": "9876543210" "merchantId": "stock" "txnList": [ { }, { } ], "action": "upiTransactionList" }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:listTransactionsRespH // block:start:transactionStatusReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiTxnStatus", "signature": "", "signaturePayload": "", "merchantKeyId":"1234", "upiRequestId": "", "transactionType": "CUSTOMER_DEBITED_VIA_PAY", "transactionTimestamp": "1639147293629", "vpa": "abc@xyz", "checkWithUdir":"true", } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1639147293629", } // block:end:transactionStatusReqH // block:start:transactionStatusRespH { "service": "in.juspay.hyperapi", "requestId": "f3d954b4-e9e2-4703-8758-c8b9a488d677", "payload": { "status": "SUCCESS", "udfParameters":"{}", "type":"CUSTOMER_DEBITED_VIA_PAY", "transactionTimestamp":"2016-11-25T00:00:00+05:30", "responseMessage":"SUCCESS", "responseCode":"SUCCESS", "refUrl":"https://www.abcxyz.com/", "payerVpa":"customer@xyz"", "payerMobileNumber":"919812388554", "payerMerchantCustomerId":"DEMO-CUST-1234", "payeeVpa":"customer1@abc", "payeeName":"abc", "payeeMcc":"7322", "merchantRequestId":"22209140384", "merchantId\":"ONECARD", "merchantCustomerId":"2955809234891040000", "maskedAccountNumber":"652912XXXXXXXX29", "gatewayTransactionId":"YJPfd78b8d61ca8472b99ef.....", "gatewayResponseMessage":"Transaction is approved", "gatewayResponseCode":"00", "gatewayReferenceId":"538593539023", "customResponse":"{}", "bankCode":"123456", "bankAccountUniqueId":"fb96f8b2b1ab0c070d0d894", "amount":"4923.00", "action":"upiTxnStatus" }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:transactionStatusRespH // block:start:raiseComplaintReqH { "service": "in.juspay.hyperapi", "requestId": "095fa47e-b528-457d-8310-faece4c37814", "payload": { "upiRequestId": "AUT699393106f865d1a9467c59725e6891f", "originalUpiRequestId": "AUT75533106f865d1a9wegrhjw9725e6891f" "adjAmount": "0.50", "adjFlag": "PBRB", "adjCode": "U010", "action": "upiComplaintRaise", "type":"COMPLAINT", "purpose": "00", "refUrl": "https://www.abcxyz.com/", "remarks": "Amount not credited", "signature": "", "signaturePayload": "", "merchantKeyId": "1234", } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1641533238616" } // block:end:raiseComplaintReqH // block:start:raiseComplaintRespH { "service": "in.juspay.hyperapi", "requestId": "f3d954b4-e9e2-4703-8758-c8b9a488d677", "payload": { "action": "upiComplaintRaise", "status": "SUCCESS", "responseCode": "SUCCESS", "responseMessage": "SUCCESS", "complaintRaisePayload": { "payerVpa": "123454306@1234", "payeeVpa": "83746598743@2312", "merchantId": "TEST", "merchantChannelId": "TESTAPP", "merchantCustomerId": "test-merchantcustomer-1", "customerMobileNumber": "919988776655", "merchantRequestId": "3764723469", "transactionAmount": "1.00", "reqAdjAmount": "0.50", "reqAdjFlag": "PBRB", "reqAdjCode": "U010", "crn": "941451534851394", "gatewayReferenceId": "123456", "gatewayComplaintId": "AUT699393106f865d1a9467c59725e6891f", "gatewayResponseCode": "00", "gatewayResponseStatus": "SUCCESS", "gatewayResponseMessage": "Your Complaint is Raised" } }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:raiseComplaintRespH // block:start:listPendingComplaintReqH { "service": "in.juspay.hyperapi", "requestId": "095fa47e-b528-457d-8310-faece4c37814", "payload": { "action": "upiListPendingComplaints", "limit": 100, "offset": 0, "signature": "", "signaturePayload": "", "merchantKeyId": "1234" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1641533238616" } // block:end:listPendingComplaintReqH // block:start:listPendingComplaintRespH { "service": "in.juspay.hyperapi", "requestId": "f3d954b4-e9e2-4703-8758-c8b9a488d677", "payload": { "action": "upiListPendingComplaints", "status": "SUCCESS", "responseCode": "SUCCESS", "responseMessage": "SUCCESS", "merchantId": "stock", "merchantChannelId": "stockAPP", "complaintList": [{ "upiRequestId": "72832032893287", "transactionUpiRequestId": "3764723469", "status": "SUCCESS", "reqAdjFlag": "PBRB", "reqAdjAmount": "0.50", "reqAdjCode": "U010", "remarks": "UPI", "payerVpa": "123454306@1234", "payeeVpa": "83746598743@2312", "orgTxnStatus": "SUCCESS", "orgTxnDate": "16683984398", "crn": "941451534851394", "complaintDate": "16683984398", }] }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:listPendingComplaintRespH // block:start:complaintStatusReqH { "service": "in.juspay.hyperapi", "requestId": "095fa47e-b528-457d-8310-faece4c37814", "payload": { "action": "upiComplaintStatus", "originalUpiRequestId": "APL699393106f8sbsbnbnns67c59725e6891f", "originalTransactionUpiRequestId": "APL699393106f865d1a9467c59725e6891f", "signature": "", "signaturePayload": "", "merchantKeyId": "1234" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1641533238616" } // block:end:complaintStatusReqH // block:start:complaintStatusRespH { "service": "in.juspay.hyperapi", "requestId": "f3d954b4-e9e2-4703-8758-c8b9a488d677", "payload": { "action": "upiComplaintStatus" "status": "SUCCESS", "responseMessage": "SUCCESS", "responseCode": "SUCCESS", "complaintStatusPayload": { "merchantChannelId": "stockAPP", "gatewayResponseStatus": "FAILURE", "merchantId": "stock", "gatewayComplaintId": "ICIJP22d737c1b544f7aa55f049ad84497b", "reqAdjAmount": "6600.00", "gatewayResponseMessage": "Transaction failed", "payerVpa": "something@handle", "merchantRequestId": "45f54883f5548ddac7bd4b16bd06e1d", "gatewayResponseCode": "U48", "gatewayReferenceId": "208409676817", "reqAdjCode": "U010", "crn": "UPI22032564889", "customerMobileNumber": "918086332344", "payeeVpa": "something@handle", "reqAdjFlag": "PBRB", "transactionAmount": "1.00", "merchantCustomerId": "090d5030-7d17-11ec-939b-b1ce4bc73875", "adjAmount": "0.50", "adjFlag": "PBRB", "adjCode": "U010", } } "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:complaintStatusRespH // block:start:collectApproveReqH { "service": "in.juspay.hyperapi", "requestId": "96ad03b7-c298-4702-9257-83ce9225485d", "payload": { "upiRequestId": "XXXXXXXXXXXXXXXXXXXXXXXX", "timestamp": "1639168104341.0", "signaturePayload": "", "signature": "GFetNZC/UQ5hJF+MnaZ1dCD25GSeyFmm2cBY+rIkOhZDnR+icvl95g/1Dx4B9p/KE/ILkyBNOGNO\nDUBnxoaFeqhGE1pP3krWHcD2H2dJSTmcv7BvxeJKMdw==\n", "payeeVpa": "XXXXXXXXXXXXXXXX@XXXXXXXX", "merchantKeyId": "1234", "customerVpa": "XXXXXXXXXXXXXXXX@XXXXXXXX", "amount": "1.00", "accountReferenceId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "action": "upiPayCollect", "clAuthMode": “MPIN"/“BIOMETRICS” } } "signaturePayload": { "merchant_id": "XXXXXX", "customer_id": "XXXXXX", "timestamp": "1639167811935", "amount": "5.00", "currency": "INR" } // block:end:collectApproveReqH // block:start:collectApproveRespH { "service": "in.juspay.hyperapi", "requestId": "96ad03b7-c298-4702-9257-83ce9225485d", "payload": { "transactionTimestamp": "2021-12-11T01:54:28+05:30", "status": "SUCCESS", "maskedAccountNumber": "XXXXXXXXXX998898", "gatewayTransactionId": "XXXXXXXXXXXXXXXXXXXXXXXX", "gatewayResponseMessage": "Your transaction is successful", "gatewayResponseCode": "00", "gatewayReferenceId": "XXXXXXXXXXXX", "payeeMcc": "0000", "customerVpa": "XXXXXX@XXXXXX", "customerMobileNumber": "XXXXXXXXXXXX", "bankCode": "500007", "bankAccountUniqueId": "XXXXXXXXXXXXXXXXXXXXXXXXX", "amount": "1.00", "refUrl": "https://www.abcxyz.com/", "action": "upiPayCollect", "clAuthMode": “MPIN"/“BIOMETRICS” }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:collectApproveRespH // block:start:collectDeclineReqH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "upiRequestId": "XXXXXXXXXXXXXXXXXXXXXXXX", "timestamp": "1639168319187.0", "signaturePayload": "", "signature": "GF.........\n", "payeeVpa": "XXXXXXXXXX@XXXXXX", "payeeName": "ABC", "merchantKeyId": "1234", "customerVpa": "XXXXXXXXX@XXXXX", "amount": "5.00", "accountReferenceId": "XXXXXXXXXXXXXXXX", "action": "upiDeclineCollect" } } "signaturePayload": { "merchant_id": "XXXXXX", "customer_id": "XXXXXX", "timestamp": "1639167811935", "amount": "5.00", "currency": "INR", "customerPhone": "9876543210", "customer_email": "abc@gmail.com" } // block:end:collectDeclineReqH // block:start:collectDeclineRespH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "transactionTimestamp": "2021-12-11T02:01:57+05:30", "status": "SUCCESS", "gatewayTransactionId": "XXXXXXXXXXXXXXXX", "gatewayResponseMessage": "Transaction declined", "gatewayResponseCode": "ZA", "gatewayReferenceId": "XXXXXXXX", "customerVpa": "XXXXXXXX@XXXXXXXX", "customerMobileNumber": "XXXXXXXX", "amount": "5.00", "refUrl": "https://www.abcxyz.com/", "action": "upiDeclineCollect" }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false, } // block:end:collectDeclineRespH // block:start:blockSpamReqH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "upiRequestId": "AXB50298319391657664494011", "signaturePayload": "", "signature": "", "shouldSpam": "false", "merchantKeyId" "1234", "shouldBlock": "true", "payeeVpa": "8809800980@stockaxis", "action": "upiBlockSpam" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1641533238616" } // block:end:blockSpamReqH // block:start:blockSpamRespH { "service": "in.juspay.hyperapi", "requestId": "93571360-f4bf-406e-9cae-75a21aaf1370", "payload": { "action": "upiBlockSpam", "bn": [...], "status": "SUCCESS", "gatewayResponseMessage": "", "gatewayResponseCode": "00", "responseMessage": "SUCCESS", "responseCode": "SUCCESS " }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:blockSpamRespH // block:start:blockVpaListReqH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "signaturePayload": "", "signature": "", "merchantKeyId": "1234", "limit": 100, "offset": 0, "action": "upiBlockedVpaList" } } ``` ### Response snippets: #### Response: ```plaintext // block:start:listTransactionsReqH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "signaturePayload": "", "signature": "GFe…………………..w==", "merchantKeyId": "1234", "limit": "100", "offset": "0", "action": "upiTransactionList", } } "signaturePayload": { "merchant_id": "stock", "timestamp": "1639147293629" "customer_id":"9876543210", } // block:end:listTransactionsReqH // block:start:listTransactionsRespH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "status": "SUCCESS", "merchantChannelId": "STOCKAPP" "merchantCustomerId": "9876543210" "merchantId": "stock" "txnList": [ { }, { } ], "action": "upiTransactionList" }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:listTransactionsRespH // block:start:transactionStatusReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiTxnStatus", "signature": "", "signaturePayload": "", "merchantKeyId":"1234", "upiRequestId": "", "transactionType": "CUSTOMER_DEBITED_VIA_PAY", "transactionTimestamp": "1639147293629", "vpa": "abc@xyz", "checkWithUdir":"true", } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1639147293629", } // block:end:transactionStatusReqH // block:start:transactionStatusRespH { "service": "in.juspay.hyperapi", "requestId": "f3d954b4-e9e2-4703-8758-c8b9a488d677", "payload": { "status": "SUCCESS", "udfParameters":"{}", "type":"CUSTOMER_DEBITED_VIA_PAY", "transactionTimestamp":"2016-11-25T00:00:00+05:30", "responseMessage":"SUCCESS", "responseCode":"SUCCESS", "refUrl":"https://www.abcxyz.com/", "payerVpa":"customer@xyz"", "payerMobileNumber":"919812388554", "payerMerchantCustomerId":"DEMO-CUST-1234", "payeeVpa":"customer1@abc", "payeeName":"abc", "payeeMcc":"7322", "merchantRequestId":"22209140384", "merchantId\":"ONECARD", "merchantCustomerId":"2955809234891040000", "maskedAccountNumber":"652912XXXXXXXX29", "gatewayTransactionId":"YJPfd78b8d61ca8472b99ef.....", "gatewayResponseMessage":"Transaction is approved", "gatewayResponseCode":"00", "gatewayReferenceId":"538593539023", "customResponse":"{}", "bankCode":"123456", "bankAccountUniqueId":"fb96f8b2b1ab0c070d0d894", "amount":"4923.00", "action":"upiTxnStatus" }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:transactionStatusRespH // block:start:raiseComplaintReqH { "service": "in.juspay.hyperapi", "requestId": "095fa47e-b528-457d-8310-faece4c37814", "payload": { "upiRequestId": "AUT699393106f865d1a9467c59725e6891f", "originalUpiRequestId": "AUT75533106f865d1a9wegrhjw9725e6891f" "adjAmount": "0.50", "adjFlag": "PBRB", "adjCode": "U010", "action": "upiComplaintRaise", "type":"COMPLAINT", "purpose": "00", "refUrl": "https://www.abcxyz.com/", "remarks": "Amount not credited", "signature": "", "signaturePayload": "", "merchantKeyId": "1234", } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1641533238616" } // block:end:raiseComplaintReqH // block:start:raiseComplaintRespH { "service": "in.juspay.hyperapi", "requestId": "f3d954b4-e9e2-4703-8758-c8b9a488d677", "payload": { "action": "upiComplaintRaise", "status": "SUCCESS", "responseCode": "SUCCESS", "responseMessage": "SUCCESS", "complaintRaisePayload": { "payerVpa": "123454306@1234", "payeeVpa": "83746598743@2312", "merchantId": "TEST", "merchantChannelId": "TESTAPP", "merchantCustomerId": "test-merchantcustomer-1", "customerMobileNumber": "919988776655", "merchantRequestId": "3764723469", "transactionAmount": "1.00", "reqAdjAmount": "0.50", "reqAdjFlag": "PBRB", "reqAdjCode": "U010", "crn": "941451534851394", "gatewayReferenceId": "123456", "gatewayComplaintId": "AUT699393106f865d1a9467c59725e6891f", "gatewayResponseCode": "00", "gatewayResponseStatus": "SUCCESS", "gatewayResponseMessage": "Your Complaint is Raised" } }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:raiseComplaintRespH // block:start:listPendingComplaintReqH { "service": "in.juspay.hyperapi", "requestId": "095fa47e-b528-457d-8310-faece4c37814", "payload": { "action": "upiListPendingComplaints", "limit": 100, "offset": 0, "signature": "", "signaturePayload": "", "merchantKeyId": "1234" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1641533238616" } // block:end:listPendingComplaintReqH // block:start:listPendingComplaintRespH { "service": "in.juspay.hyperapi", "requestId": "f3d954b4-e9e2-4703-8758-c8b9a488d677", "payload": { "action": "upiListPendingComplaints", "status": "SUCCESS", "responseCode": "SUCCESS", "responseMessage": "SUCCESS", "merchantId": "stock", "merchantChannelId": "stockAPP", "complaintList": [{ "upiRequestId": "72832032893287", "transactionUpiRequestId": "3764723469", "status": "SUCCESS", "reqAdjFlag": "PBRB", "reqAdjAmount": "0.50", "reqAdjCode": "U010", "remarks": "UPI", "payerVpa": "123454306@1234", "payeeVpa": "83746598743@2312", "orgTxnStatus": "SUCCESS", "orgTxnDate": "16683984398", "crn": "941451534851394", "complaintDate": "16683984398", }] }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:listPendingComplaintRespH // block:start:complaintStatusReqH { "service": "in.juspay.hyperapi", "requestId": "095fa47e-b528-457d-8310-faece4c37814", "payload": { "action": "upiComplaintStatus", "originalUpiRequestId": "APL699393106f8sbsbnbnns67c59725e6891f", "originalTransactionUpiRequestId": "APL699393106f865d1a9467c59725e6891f", "signature": "", "signaturePayload": "", "merchantKeyId": "1234" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1641533238616" } // block:end:complaintStatusReqH // block:start:complaintStatusRespH { "service": "in.juspay.hyperapi", "requestId": "f3d954b4-e9e2-4703-8758-c8b9a488d677", "payload": { "action": "upiComplaintStatus" "status": "SUCCESS", "responseMessage": "SUCCESS", "responseCode": "SUCCESS", "complaintStatusPayload": { "merchantChannelId": "stockAPP", "gatewayResponseStatus": "FAILURE", "merchantId": "stock", "gatewayComplaintId": "ICIJP22d737c1b544f7aa55f049ad84497b", "reqAdjAmount": "6600.00", "gatewayResponseMessage": "Transaction failed", "payerVpa": "something@handle", "merchantRequestId": "45f54883f5548ddac7bd4b16bd06e1d", "gatewayResponseCode": "U48", "gatewayReferenceId": "208409676817", "reqAdjCode": "U010", "crn": "UPI22032564889", "customerMobileNumber": "918086332344", "payeeVpa": "something@handle", "reqAdjFlag": "PBRB", "transactionAmount": "1.00", "merchantCustomerId": "090d5030-7d17-11ec-939b-b1ce4bc73875", "adjAmount": "0.50", "adjFlag": "PBRB", "adjCode": "U010", } } "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:complaintStatusRespH // block:start:collectApproveReqH { "service": "in.juspay.hyperapi", "requestId": "96ad03b7-c298-4702-9257-83ce9225485d", "payload": { "upiRequestId": "XXXXXXXXXXXXXXXXXXXXXXXX", "timestamp": "1639168104341.0", "signaturePayload": "", "signature": "GFetNZC/UQ5hJF+MnaZ1dCD25GSeyFmm2cBY+rIkOhZDnR+icvl95g/1Dx4B9p/KE/ILkyBNOGNO\nDUBnxoaFeqhGE1pP3krWHcD2H2dJSTmcv7BvxeJKMdw==\n", "payeeVpa": "XXXXXXXXXXXXXXXX@XXXXXXXX", "merchantKeyId": "1234", "customerVpa": "XXXXXXXXXXXXXXXX@XXXXXXXX", "amount": "1.00", "accountReferenceId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "action": "upiPayCollect", "clAuthMode": “MPIN"/“BIOMETRICS” } } "signaturePayload": { "merchant_id": "XXXXXX", "customer_id": "XXXXXX", "timestamp": "1639167811935", "amount": "5.00", "currency": "INR" } // block:end:collectApproveReqH // block:start:collectApproveRespH { "service": "in.juspay.hyperapi", "requestId": "96ad03b7-c298-4702-9257-83ce9225485d", "payload": { "transactionTimestamp": "2021-12-11T01:54:28+05:30", "status": "SUCCESS", "maskedAccountNumber": "XXXXXXXXXX998898", "gatewayTransactionId": "XXXXXXXXXXXXXXXXXXXXXXXX", "gatewayResponseMessage": "Your transaction is successful", "gatewayResponseCode": "00", "gatewayReferenceId": "XXXXXXXXXXXX", "payeeMcc": "0000", "customerVpa": "XXXXXX@XXXXXX", "customerMobileNumber": "XXXXXXXXXXXX", "bankCode": "500007", "bankAccountUniqueId": "XXXXXXXXXXXXXXXXXXXXXXXXX", "amount": "1.00", "refUrl": "https://www.abcxyz.com/", "action": "upiPayCollect", "clAuthMode": “MPIN"/“BIOMETRICS” }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:collectApproveRespH // block:start:collectDeclineReqH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "upiRequestId": "XXXXXXXXXXXXXXXXXXXXXXXX", "timestamp": "1639168319187.0", "signaturePayload": "", "signature": "GF.........\n", "payeeVpa": "XXXXXXXXXX@XXXXXX", "payeeName": "ABC", "merchantKeyId": "1234", "customerVpa": "XXXXXXXXX@XXXXX", "amount": "5.00", "accountReferenceId": "XXXXXXXXXXXXXXXX", "action": "upiDeclineCollect" } } "signaturePayload": { "merchant_id": "XXXXXX", "customer_id": "XXXXXX", "timestamp": "1639167811935", "amount": "5.00", "currency": "INR", "customerPhone": "9876543210", "customer_email": "abc@gmail.com" } // block:end:collectDeclineReqH // block:start:collectDeclineRespH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "transactionTimestamp": "2021-12-11T02:01:57+05:30", "status": "SUCCESS", "gatewayTransactionId": "XXXXXXXXXXXXXXXX", "gatewayResponseMessage": "Transaction declined", "gatewayResponseCode": "ZA", "gatewayReferenceId": "XXXXXXXX", "customerVpa": "XXXXXXXX@XXXXXXXX", "customerMobileNumber": "XXXXXXXX", "amount": "5.00", "refUrl": "https://www.abcxyz.com/", "action": "upiDeclineCollect" }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false, } // block:end:collectDeclineRespH // block:start:blockSpamReqH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "upiRequestId": "AXB50298319391657664494011", "signaturePayload": "", "signature": "", "shouldSpam": "false", "merchantKeyId" "1234", "shouldBlock": "true", "payeeVpa": "8809800980@stockaxis", "action": "upiBlockSpam" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1641533238616" } // block:end:blockSpamReqH // block:start:blockSpamRespH { "service": "in.juspay.hyperapi", "requestId": "93571360-f4bf-406e-9cae-75a21aaf1370", "payload": { "action": "upiBlockSpam", "bn": [...], "status": "SUCCESS", "gatewayResponseMessage": "", "gatewayResponseCode": "00", "responseMessage": "SUCCESS", "responseCode": "SUCCESS " }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:blockSpamRespH // block:start:blockVpaListReqH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "signaturePayload": "", "signature": "", "merchantKeyId": "1234", "limit": 100, "offset": 0, "action": "upiBlockedVpaList" } } ``` --- ## Complete Code Reference The following code files are referenced in the steps above: ### InappHeadless2.txt ``` // block:start:listTransactionsReqH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "signaturePayload": "", "signature": "GFe…………………..w==", "merchantKeyId": "1234", "limit": "100", "offset": "0", "action": "upiTransactionList", } } "signaturePayload": { "merchant_id": "stock", "timestamp": "1639147293629" "customer_id":"9876543210", } // block:end:listTransactionsReqH // block:start:listTransactionsRespH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "status": "SUCCESS", "merchantChannelId": "STOCKAPP" "merchantCustomerId": "9876543210" "merchantId": "stock" "txnList": [ { }, { } ], "action": "upiTransactionList" }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:listTransactionsRespH // block:start:transactionStatusReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiTxnStatus", "signature": "", "signaturePayload": "", "merchantKeyId":"1234", "upiRequestId": "", "transactionType": "CUSTOMER_DEBITED_VIA_PAY", "transactionTimestamp": "1639147293629", "vpa": "abc@xyz", "checkWithUdir":"true", } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1639147293629", } // block:end:transactionStatusReqH // block:start:transactionStatusRespH { "service": "in.juspay.hyperapi", "requestId": "f3d954b4-e9e2-4703-8758-c8b9a488d677", "payload": { "status": "SUCCESS", "udfParameters":"{}", "type":"CUSTOMER_DEBITED_VIA_PAY", "transactionTimestamp":"2016-11-25T00:00:00+05:30", "responseMessage":"SUCCESS", "responseCode":"SUCCESS", "refUrl":"https://www.abcxyz.com/", "payerVpa":"customer@xyz"", "payerMobileNumber":"919812388554", "payerMerchantCustomerId":"DEMO-CUST-1234", "payeeVpa":"customer1@abc", "payeeName":"abc", "payeeMcc":"7322", "merchantRequestId":"22209140384", "merchantId\":"ONECARD", "merchantCustomerId":"2955809234891040000", "maskedAccountNumber":"652912XXXXXXXX29", "gatewayTransactionId":"YJPfd78b8d61ca8472b99ef.....", "gatewayResponseMessage":"Transaction is approved", "gatewayResponseCode":"00", "gatewayReferenceId":"538593539023", "customResponse":"{}", "bankCode":"123456", "bankAccountUniqueId":"fb96f8b2b1ab0c070d0d894", "amount":"4923.00", "action":"upiTxnStatus" }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:transactionStatusRespH // block:start:raiseComplaintReqH { "service": "in.juspay.hyperapi", "requestId": "095fa47e-b528-457d-8310-faece4c37814", "payload": { "upiRequestId": "AUT699393106f865d1a9467c59725e6891f", "originalUpiRequestId": "AUT75533106f865d1a9wegrhjw9725e6891f" "adjAmount": "0.50", "adjFlag": "PBRB", "adjCode": "U010", "action": "upiComplaintRaise", "type":"COMPLAINT", "purpose": "00", "refUrl": "https://www.abcxyz.com/", "remarks": "Amount not credited", "signature": "", "signaturePayload": "", "merchantKeyId": "1234", } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1641533238616" } // block:end:raiseComplaintReqH // block:start:raiseComplaintRespH { "service": "in.juspay.hyperapi", "requestId": "f3d954b4-e9e2-4703-8758-c8b9a488d677", "payload": { "action": "upiComplaintRaise", "status": "SUCCESS", "responseCode": "SUCCESS", "responseMessage": "SUCCESS", "complaintRaisePayload": { "payerVpa": "123454306@1234", "payeeVpa": "83746598743@2312", "merchantId": "TEST", "merchantChannelId": "TESTAPP", "merchantCustomerId": "test-merchantcustomer-1", "customerMobileNumber": "919988776655", "merchantRequestId": "3764723469", "transactionAmount": "1.00", "reqAdjAmount": "0.50", "reqAdjFlag": "PBRB", "reqAdjCode": "U010", "crn": "941451534851394", "gatewayReferenceId": "123456", "gatewayComplaintId": "AUT699393106f865d1a9467c59725e6891f", "gatewayResponseCode": "00", "gatewayResponseStatus": "SUCCESS", "gatewayResponseMessage": "Your Complaint is Raised" } }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:raiseComplaintRespH // block:start:listPendingComplaintReqH { "service": "in.juspay.hyperapi", "requestId": "095fa47e-b528-457d-8310-faece4c37814", "payload": { "action": "upiListPendingComplaints", "limit": 100, "offset": 0, "signature": "", "signaturePayload": "", "merchantKeyId": "1234" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1641533238616" } // block:end:listPendingComplaintReqH // block:start:listPendingComplaintRespH { "service": "in.juspay.hyperapi", "requestId": "f3d954b4-e9e2-4703-8758-c8b9a488d677", "payload": { "action": "upiListPendingComplaints", "status": "SUCCESS", "responseCode": "SUCCESS", "responseMessage": "SUCCESS", "merchantId": "stock", "merchantChannelId": "stockAPP", "complaintList": [{ "upiRequestId": "72832032893287", "transactionUpiRequestId": "3764723469", "status": "SUCCESS", "reqAdjFlag": "PBRB", "reqAdjAmount": "0.50", "reqAdjCode": "U010", "remarks": "UPI", "payerVpa": "123454306@1234", "payeeVpa": "83746598743@2312", "orgTxnStatus": "SUCCESS", "orgTxnDate": "16683984398", "crn": "941451534851394", "complaintDate": "16683984398", }] }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:listPendingComplaintRespH // block:start:complaintStatusReqH { "service": "in.juspay.hyperapi", "requestId": "095fa47e-b528-457d-8310-faece4c37814", "payload": { "action": "upiComplaintStatus", "originalUpiRequestId": "APL699393106f8sbsbnbnns67c59725e6891f", "originalTransactionUpiRequestId": "APL699393106f865d1a9467c59725e6891f", "signature": "", "signaturePayload": "", "merchantKeyId": "1234" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1641533238616" } // block:end:complaintStatusReqH // block:start:complaintStatusRespH { "service": "in.juspay.hyperapi", "requestId": "f3d954b4-e9e2-4703-8758-c8b9a488d677", "payload": { "action": "upiComplaintStatus" "status": "SUCCESS", "responseMessage": "SUCCESS", "responseCode": "SUCCESS", "complaintStatusPayload": { "merchantChannelId": "stockAPP", "gatewayResponseStatus": "FAILURE", "merchantId": "stock", "gatewayComplaintId": "ICIJP22d737c1b544f7aa55f049ad84497b", "reqAdjAmount": "6600.00", "gatewayResponseMessage": "Transaction failed", "payerVpa": "something@handle", "merchantRequestId": "45f54883f5548ddac7bd4b16bd06e1d", "gatewayResponseCode": "U48", "gatewayReferenceId": "208409676817", "reqAdjCode": "U010", "crn": "UPI22032564889", "customerMobileNumber": "918086332344", "payeeVpa": "something@handle", "reqAdjFlag": "PBRB", "transactionAmount": "1.00", "merchantCustomerId": "090d5030-7d17-11ec-939b-b1ce4bc73875", "adjAmount": "0.50", "adjFlag": "PBRB", "adjCode": "U010", } } "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:complaintStatusRespH // block:start:collectApproveReqH { "service": "in.juspay.hyperapi", "requestId": "96ad03b7-c298-4702-9257-83ce9225485d", "payload": { "upiRequestId": "XXXXXXXXXXXXXXXXXXXXXXXX", "timestamp": "1639168104341.0", "signaturePayload": "", "signature": "GFetNZC/UQ5hJF+MnaZ1dCD25GSeyFmm2cBY+rIkOhZDnR+icvl95g/1Dx4B9p/KE/ILkyBNOGNO\nDUBnxoaFeqhGE1pP3krWHcD2H2dJSTmcv7BvxeJKMdw==\n", "payeeVpa": "XXXXXXXXXXXXXXXX@XXXXXXXX", "merchantKeyId": "1234", "customerVpa": "XXXXXXXXXXXXXXXX@XXXXXXXX", "amount": "1.00", "accountReferenceId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "action": "upiPayCollect", "clAuthMode": “MPIN"/“BIOMETRICS” } } "signaturePayload": { "merchant_id": "XXXXXX", "customer_id": "XXXXXX", "timestamp": "1639167811935", "amount": "5.00", "currency": "INR" } // block:end:collectApproveReqH // block:start:collectApproveRespH { "service": "in.juspay.hyperapi", "requestId": "96ad03b7-c298-4702-9257-83ce9225485d", "payload": { "transactionTimestamp": "2021-12-11T01:54:28+05:30", "status": "SUCCESS", "maskedAccountNumber": "XXXXXXXXXX998898", "gatewayTransactionId": "XXXXXXXXXXXXXXXXXXXXXXXX", "gatewayResponseMessage": "Your transaction is successful", "gatewayResponseCode": "00", "gatewayReferenceId": "XXXXXXXXXXXX", "payeeMcc": "0000", "customerVpa": "XXXXXX@XXXXXX", "customerMobileNumber": "XXXXXXXXXXXX", "bankCode": "500007", "bankAccountUniqueId": "XXXXXXXXXXXXXXXXXXXXXXXXX", "amount": "1.00", "refUrl": "https://www.abcxyz.com/", "action": "upiPayCollect", "clAuthMode": “MPIN"/“BIOMETRICS” }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:collectApproveRespH // block:start:collectDeclineReqH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "upiRequestId": "XXXXXXXXXXXXXXXXXXXXXXXX", "timestamp": "1639168319187.0", "signaturePayload": "", "signature": "GF.........\n", "payeeVpa": "XXXXXXXXXX@XXXXXX", "payeeName": "ABC", "merchantKeyId": "1234", "customerVpa": "XXXXXXXXX@XXXXX", "amount": "5.00", "accountReferenceId": "XXXXXXXXXXXXXXXX", "action": "upiDeclineCollect" } } "signaturePayload": { "merchant_id": "XXXXXX", "customer_id": "XXXXXX", "timestamp": "1639167811935", "amount": "5.00", "currency": "INR", "customerPhone": "9876543210", "customer_email": "abc@gmail.com" } // block:end:collectDeclineReqH // block:start:collectDeclineRespH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "transactionTimestamp": "2021-12-11T02:01:57+05:30", "status": "SUCCESS", "gatewayTransactionId": "XXXXXXXXXXXXXXXX", "gatewayResponseMessage": "Transaction declined", "gatewayResponseCode": "ZA", "gatewayReferenceId": "XXXXXXXX", "customerVpa": "XXXXXXXX@XXXXXXXX", "customerMobileNumber": "XXXXXXXX", "amount": "5.00", "refUrl": "https://www.abcxyz.com/", "action": "upiDeclineCollect" }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false, } // block:end:collectDeclineRespH // block:start:blockSpamReqH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "upiRequestId": "AXB50298319391657664494011", "signaturePayload": "", "signature": "", "shouldSpam": "false", "merchantKeyId" "1234", "shouldBlock": "true", "payeeVpa": "8809800980@stockaxis", "action": "upiBlockSpam" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "XXXXXXXX", "timestamp": "1641533238616" } // block:end:blockSpamReqH // block:start:blockSpamRespH { "service": "in.juspay.hyperapi", "requestId": "93571360-f4bf-406e-9cae-75a21aaf1370", "payload": { "action": "upiBlockSpam", "bn": [...], "status": "SUCCESS", "gatewayResponseMessage": "", "gatewayResponseCode": "00", "responseMessage": "SUCCESS", "responseCode": "SUCCESS " }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:blockSpamRespH // block:start:blockVpaListReqH { "service": "in.juspay.hyperapi", "requestId": "693e4b2c-55af-42c0-85a9-a97972e2906f", "payload": { "signaturePayload": "", "signature": "", "merchantKeyId": "1234", "limit": 100, "offset": 0, "action": "upiBlockedVpaList" } } ``` --- ## See Also - [Raise Complaint](https://juspay.io/in/docs/upi-tpap-sdk/android/headless-process-payloads/raise-complaint) - [Complaint Status](https://juspay.io/in/docs/upi-tpap-sdk/android/headless-process-payloads/complaint-status)