Check UPI Transaction Status

1602 views Last Updated On: 15 Apr 2025

This API is used for verifying the current status or outcome of a Unified Payments Interface (UPI) transaction.

We have two endpoints available for checking transaction status :

– Served from the "Main Server" : "getAllTransactionStatus".

– Served from the "Read-Only Server" : "getAllTransactionStatusv2".

If you are calling the check status immediately after receiving a callback, please use the "getAllTransactionStatus" endpoint.

For all other use cases, kindly use the "getAllTransactionStatusv2" endpoint.

Get:

https://{{staging/production}}/upi/{Endpoint}?refId=2024220214044504WZHWM

Response Parameters:

PARAMETERDATA TYPEDESCRIPTION
resultStatusStringSuccess
Failure
resultCodeNumber000 for Success
400 for Failure
resultMsgStringA brief textual description explaining the validation result.
   dataString

PARAMETERDATA TYPEDESCRIPTION
   TransactionIdStringID assigned to an individual transaction.
   MessageIdStringUnique identifier assigned to a message
   ReferenceIdStringUnique identifier or reference code assigned to a particular entity
   CustomerRefNoStringReference code assigned to a specific transaction
   TransactionDateStringDate and Time when a specific transaction occurs
   TxnTypeNameStringDescription of the type of transaction being performed
   TxnStatusNumber1 & 2 for Pending
3 for Success
4 for Failure
5 for Expired
   PayerAddressStringThe address associated with the payer in a transaction
   PayerNameStringName of the individual or entity who is initiating or making a payment
   PayeeAddressStringThe address associated with the payee
   PayeeNameStringName of the individual, business, or entity that is receiving payment
   AmountNumberNumerical value
   TxnRemarksStringRefers to remarks or comments associated with a transaction.
   ResponseMessageStringThe text-based response generated by a system
   CollectTxnStatusNumberRefers to the status of a collect transaction in a payment system.
   ApproveOrDeclineNumberEither approving or declining a request or transaction
   PayerAccountNumberStringRefers to the account number associated with the payer.
   PayeeAccountNumberStringRefers to the account number associated with the payee.



Response for "getAllTransactionStatus" Endpoint

{
    "resultCode": "000",
    "resultStatus": "success",
    "resultMessage": "",
    "data": {
        "TransactionId": "PPN80b9ebfa251549202402221405169825",
        "MessageId": "2BeVimbD3V",
        "ReferenceId": "2024220214044504WZHW",
        "CustomerRefNo": "405314465022",
        "TransactionDate": "2/22/2024 2:05:00 PM",
        "TxnTypeName": "Collect_Sent",
        "TxnStatus": 3,
        "PayerAddress": "90xxxxxx48@paytm",
        "PayerName": "Manishkumar Patel",
        "PayeeAddress": "merchant.xxxxxx@digikhata",
        "PayeeName": "Pay Point India Network Pvt. Ltd.",
        "Amount": 3,
        "TxnRemarks": "For retailer portal limit",
        "ResponseMessage": "",
        "CollectTxnStatus": 3,
        "ApproveOrDecline": 2,
        "PayerAccountNumber": "12470100017586",
        "PayeeAccountNumber": "918452008800"
    }
}


Response for "getAllTransactionStatusv2" Endpoint

{
    "resultCode": "000",
    "resultStatus": "success",
    "resultMessage": "",
    "data": [
    {
        "TransactionId": "PPN80b9ebfa251549202402221405169825",
        "MessageId": "2BeVimbD3V",
        "ReferenceId": "2024220214044504WZHW",
        "CustomerRefNo": "405314465022",
        "TransactionDate": "2/22/2024 2:05:00 PM",
        "TxnTypeName": "Collect_Sent",
        "TxnStatus": 3,
        "PayerAddress": "90xxxxxx48@paytm",
        "PayerName": "Manishkumar Patel",
        "PayeeAddress": "merchant.xxxxxx@digikhata",
        "PayeeName": "Pay Point India Network Pvt. Ltd.",
        "Amount": 3,
        "TxnRemarks": "For retailer portal limit",
        "ResponseMessage": "",
        "CollectTxnStatus": 3,
        "ApproveOrDecline": 2,
        "PayerAccountNumber": "12470100017586",
        "PayeeAccountNumber": "918452008800"
    }
   ]
} 


Result Code

RESULT CODERESULT STATUSRESULT MESSAGE
401Fail Access Denied
000Success"",data = new {TransactionId = "",MessageId = "",ReferenceId = "",CustomerRefNo = "",TransactionDate = "",TxnTypeName = "",TxnStatus = "",PayerAddress = "",PayerName = "",PayeeAddress = "",PayeeName = "",Amount = "",TxnRemarks = "",ResponseMessage = "",CollectTxnStatus = "",ApproveOrDecline = "",PayerAccountNumber = "",PayeeAccountNumber = ""}
400FailNo record found.
500FailSorry, your request is not processed please try after some time.

Txn Status Result Code

RESULT CODE
RESULT STATUS
1Pending
2Pending
3Success
4Failed
5Expired


Powered by Froala Editor