The Check Transfer Status API will return the status of the transfers initiated by the merchant.
HTTP Method: POST
Environment
Test Environment | https://uatoneapi.payu.in/payout/payment/listTransactions |
Production Environment | https://payout.payumoney.com/payout/payment/listTransactions |
Sample request
curl -X POST \
https://test.payumoney.com/payout/payment/listTransactions \
-H 'authorization: Bearer 2678f236346281e6029e3430da1a721af29bb3546d6acbc27e6aadd7fca72605' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-H 'payoutmerchantid: 1111122' \
-d 'transferStatus=QUEUED&from=01%2F01%2F2019&to=01%2F01%2F2019&page=1&pageSize=100&merchantRefId=&batchId=1'
Sample response
{
"status": 0,
"msg": null,
"code": null,
"data": {
"payoutMerchantId": null,
"noOfPages": 1,
"totalElements": 1,
"currentPage": 0,
"totalAmount": 0.0,
"succesTxn": 0,
"pendingTxn": 0,
"transactionDetails": [
{
"txnId": 71870,
"batchId": "smartSendBatch",
"merchantRefId": "0101010031",
"purpose": "Payout",
"amount": 1.0,
"txnStatus": "FAILED",
"txnSubStatus": null,
"txnSource": "SMART_SEND",
"txnDate": "2022-08-22T05:56:13.000+0000",
"scheduledTxnDate": "2022-08-22T05:56:13.000+0000",
"payuTransactionRefNo": "PAYOUT1661147773462lrSLcvHSc1K",
"beneficiaryName": "Customer",
"beneficiaryCardNo": null,
"msg": "Internal Error while validating vpa account",
"responseCode": null,
"transferType": "UPI",
"bankTransactionRefNo": null,
"nameWithBank": null,
"lastStatusUpdateDate": "2022-08-22T05:56:15.000+0000",
"succeedOn": null,
"fee": null,
"tax": null,
"txnStatusDescription": "Internal Error while validating vpa account",
"custom1": null,
"custom2": null,
"custom3": null,
"nameMatch": null
}
]
}
}
The status of a particular transaction has to be determined only from the field txnStatus in thetransactionDetails JSON against the merchantRefId.
On receiving the following JSON Response in the Check Transfer Status API, the transaction status is not determined and has to considered as unidentified or Pending by merchant.
{
"status": 0,
"msg": null,
"code": null,
"data": {
"payoutMerchantId": null,
"noOfPages": 0,
"totalElements": 0,
"currentPage": 0,
"totalAmount": 0.0,
"succesTxn": 0,
"pendingTxn": 0,
"transactionDetails": []
}
}
Response parameters description
Parameter | Description |
---|---|
status |
This parameter returns the status of web service call. The status can be any of the following:
|
msg |
This parameter returns the message to convey success or failure. |
code |
This parameter returns the code. |
data |
This parameter returns the transfer status in a JSON format. Refer the Description of data Parameter Fields |
Description of data parameter fields
Field | Description |
---|---|
noOfPages |
The field contains the number of pages with the transfer status details. |
totalElements |
The field contains the number of elements with the transfer status details. |
currentPage |
The field contains the current page that is returned. |
totalAmount |
The field contains the total amount of the transaction. |
succesTxn |
The field contains the code whether transaction is successful. |
pendingTxn |
This field contains the code whether transaction is pending. |
transactionDetails |
This field contains the following transaction details in an JSON format and each object contains the following details:
|
This field contains the following transaction details in an JSON format and each object contains the following details:
e for penny drop with name match transaction|
Transaction status Description
Status | Description |
---|---|
QUEUED | It will be first state once we get transaction request from merchant. If merchant is not having enough balance in his account txn will be in queued state only till he/she do deposit in virtual account. Check disable queued payout |
IN_PROGRESS | Transaction picked for processing with bank |
PENDING | PayU has received pending status from bank. Final status will be updated once PayU get success or failure from bank. Reconciliation for these type of transaction happen after every 5 min. |
FAILED | Transaction got failed at bank end. Check error message and fix if anything wrong in request or else retry. |
SUCCESS | Transaction got success. Amount is transferred to customer account |
WAITING_FOR_RETRY | Transaction is waiting to be picked again. You will get this status only in case bank / beneficiary bank server is down and you have passed retry as true or empty while calling transfer API. |
Headers and request parameters
Note:
The payoutMerchantId is different from PayU Merchant Id. Check the Payouts Dashboard or call the PayU Customer Support if you don’t know your payoutMerchantId.
Reference:
For sample request and response, refer to Sample Request and Response for Initiation & Tracking APIs.
Additional Info for request parameters
Parameters | Description | Example |
---|---|---|
transferStatus |
|
success |
filterBySucceedOn] |
|
|