Redeem Order Status

Environment

Environment	HTTP Method	API
Sandbox	`GET`	https://api-preprod.phonepe.com/apis/pg-sandbox/subscriptions/v2/order/{{merchantOrderId}}/status
Production	`GET`	https://api.phonepe.com/apis/pg/subscriptions/v2/order/{{merchantOrderId}}/status

Request

Header Name	Header Value	Description
Content-Type	application/json
Authorization	O-Bearer <access_token>	Pass access_token received in Authorization call

Response

Sample Response

{
    "merchantId": "TXMT8788",
    "merchantOrderId": "MO1722319560997",
    "orderId": "OMO2601282154473535900531",
    "state": "COMPLETED",
    "currency": "INR",
    "amount": 200,
    "expireAt": 1769618686824,
    "paymentFlow": {
        "type": "SUBSCRIPTION_REDEMPTION",
        "merchantSubscriptionId": "MS1769569283073",
        "redemptionRetryStrategy": null,
        "autoDebit": false,
        "validAfter": null,
        "validUpto": null,
        "notifiedAt": null
    },
    "paymentDetails": [
        {
            "transactionId": "OM2601282154486455900694",
            "paymentMode": "ENACH_ACCOUNT",
            "timestamp": 1769617488702,
            "currency": "INR",
            "amount": 200,
            "payableCurrency": "INR",
            "payableAmount": 200,
            "feeCurrency": "INR",
            "feeAmount": 0,
            "state": "COMPLETED",
            "instrument": {
                "type": "ACCOUNT",
                "accountType": "SAVINGS",
                "bankId": "HDFC"
            },
            "rail": {
                "type": "NACH",
                "utr": "ddf5d315-93cd-4019-9137-7bb2ad2ec702"
            },
            "splitInstruments": [
                {
                    "instrument": {
                        "type": "ACCOUNT",
                        "accountType": "SAVINGS",
                        "bankId": "HDFC"
                    },
                    "rail": {
                        "type": "NACH",
                        "utr": "ddf5d315-93cd-4019-9137-7bb2ad2ec702"
                    },
                    "currency": "INR",
                    "amount": 200
                }
            ]
        }
    ]
}

Response Parameters

Parameter Name	Data Type	Mandatory	Description
merchantId	String	Yes	Merchant identifier
merchantOrderId	String	Yes	Merchant’s unique reference for the debit attempt
orderId	String	Yes	PG internal order ID for the redemption
state	String	Yes	Final status of debit (e.g., COMPLETED, FAILED)
currency	String	Yes	Currency code (e.g., INR)
amount	Long	Yes	Amount in paisa
expireAt	Long	Yes	Order expiry timestamp in epoch
paymentFlow.type	String	Yes	Flow type (e.g., SUBSCRIPTION_REDEMPTION)
paymentFlow.merchantSubscriptionId	String	Yes	The ID of the mandate
paymentFlow.redemptionRetryStrategy	String/Null	Yes	Strategy for retrying failed debits
paymentFlow.autoDebit	Boolean	Yes	Indicates if the debit was system-triggered
paymentFlow.validAfter	Long/Null	Yes	Validity start timestamp
paymentFlow.validUpto	Long/Null	Yes	Validity end timestamp
paymentFlow.notifiedAt	Long/Null	Yes	Timestamp when user was notified of debit
paymentDetails[].transactionId	String	Yes	Internal transaction ID
paymentDetails[].paymentMode	String	Yes	Mode used (e.g., ENACH_ACCOUNT)
paymentDetails[].timestamp	Long	Yes	Transaction attempt timestamp
paymentDetails[].currency	String	Yes	Transaction currency
paymentDetails[].amount	Long	Yes	Transaction amount
paymentDetails[].payableCurrency	String	Yes	Currency payable to merchant
paymentDetails[].payableAmount	Long	Yes	Amount payable to merchant
paymentDetails[].feeCurrency	String	Yes	Fee currency
paymentDetails[].feeAmount	Long	Yes	Fee amount charged
paymentDetails[].state	String	Yes	Transaction state (e.g., COMPLETED)
paymentDetails[].instrument.type	String	Yes	Instrument type (e.g., ACCOUNT)
paymentDetails[].instrument.accountType	String	Yes	Account type (e.g., SAVINGS)
paymentDetails[].instrument.bankId	String	Yes	Bank identifier (e.g., HDFC)
paymentDetails[].rail.type	String	Yes	Rail type (e.g., NACH)
paymentDetails[].rail.utr	String	Yes	Bank Reference Number (UTR) for the transaction
paymentDetails[].splitInstruments[].instrument.type	String	Yes	Split instrument type
paymentDetails[].splitInstruments[].instrument.accountType	String	Yes	Split account type
paymentDetails[].splitInstruments[].instrument.bankId	String	Yes	Split bank identifier
paymentDetails[].splitInstruments[].rail.type	String	Yes	Split rail type
paymentDetails[].splitInstruments[].rail.utr	String	Yes	Split UTR
paymentDetails[].splitInstruments[].currency	String	Yes	Split currency
paymentDetails[].splitInstruments[].amount	Long	Yes	Split amount