Skip to main content
Phone Pe Business Logo

Order Status with Settlement for Split

The Order Status API with Settlement for Split provides the payment status of an order along with detailed settlement information. When settlementDetails=true is passed, the response includes both primary and split account-level settlement data such as UTRs, settlement IDs, fee breakdowns, and timestamps. This helps track the complete flow of funds and associated charges across all participating accounts.

EnvironmentHttp MethodAPI
SandboxGEThttps://api-preprod.phonepe.com/apis/pg-sandbox/payments/v2/order/{merchantOrderId}/status
ProductionGEThttps://api.phonepe.com/apis/pg/payments/v2/order/{merchantOrderId}/status
Request Headers
Header NameHeader Value
Content-Typeapplication/json
AuthorizationO-Bearer <partner-auth-token>
X-MERCHANT-IDMID
Path Parameters
Header NameDescription
merchantOrderIdThe merchant generated Order Id
Query Parameters
Header NameDescription
settlementDetailstrue → return the details under settlementDetails
Response Headers
Header NameHeader Value
Content-Typeapplication/json
Sample Response
{
    "orderId": "OMO2506191600147346181268",
    "state": "COMPLETED",
    "amount": 47900,
    "payableAmount": 47900,
    "feeAmount": 0,
    "expireAt": 1750329614682,
    "metaInfo":
    {
        "udf1": "<additional-information-1>",
        "udf2": "<additional-information-2>",
        "udf3": "<additional-information-3>",
        "udf4": "<additional-information-4>"
    },
    "paymentDetails":
    [
        {
            "transactionId": "OM2506191600148276181057",
            "paymentMode": "UPI_INTENT",
            "timestamp": 1750329014929,
            "amount": 47900,
            "payableAmount": 47900,
            "feeAmount": 0,
            "state": "COMPLETED",
            "instrument":
            {
                "type": "ACCOUNT",
                "maskedAccountNumber": "XXXXXXX20000",
                "ifsc": "AABC0876543",
                "accountHolderName": "Venkat",
                "accountType": "SAVINGS"
            },
            "rail":
            {
                "type": "UPI",
                "utr": "517045000220",
                "upiTransactionId": "YBL5d23003235214cfa9550c8ecbd7aecdb"
            },
            "splitInstruments":
            [
                {
                    "instrument":
                    {
                        "type": "ACCOUNT",
                        "maskedAccountNumber": "XXXXXXX20000",
                        "ifsc": "AABC0876543",
                        "accountHolderName": "Venkat",
                        "accountType": "SAVINGS"
                    },
                    "rail":
                    {
                        "type": "UPI",
                        "utr": "517045000220",
                        "upiTransactionId": "YBL5d23003235214cfa9550c8ecbd7aecdb"
                    },
                    "amount": 47900
                }
            ]
        }
    ],
    "splitSettlementInfo":
    {
        "type": "ABSOLUTE",
        "accountsSplit":
        [
            {
                "accountId": "A2506101204484257980786",
                "value": 19160.00
            },
            {
                "accountId": "A2506101203231037980769",
                "value": 19160.00
            }
        ],
        "state": "ACCEPTED"
    },
    "settlementDetails":
    {
        "state": "PROCESSED",
        "splitSettlementDetails":
        [
            {
                "type": "UPI",
                "settlementId": "3630e239-1f1b-4bed-bf02-e1015868c092",
                "utr": "string",
                "timestamp": 1750354845203,
                "amountBreakup":
                {
                    "transactionAmount": 47900,
                    "settlementAmount": 47150,
                    "settlementDeduction":
                    {
                        "sgst": -57,
                        "cgst": -57,
                        "igst": 0,
                        "fee": -635,
                        "commission": 0
                    }
                }
            }
        ],
        "accountsSettlementDetails":
        [
            {
                "accountType": "PRIMARY",
                "settlementId": "3630e239-1f1b-4bed-bf02-e1015868c092",
                "utr": "string",
                "timestamp": 1750354845203,
                "amountBreakup":
                {
                    "totalAmount": 9580,
                    "settlementAmount": 8830,
                    "transactionFee":
                    {
                        "sgst": -57,
                        "cgst": -57,
                        "igst": 0,
                        "fee": -635,
                        "commission": 0
                    },
                    "splitSettlementFee":
                    {
                        "sgst": 0,
                        "cgst": 0,
                        "igst": 0,
                        "fee": 0,
                        "commission": 0
                    },
                    "totalFee":
                    {
                        "sgst": -57,
                        "cgst": -57,
                        "igst": 0,
                        "fee": -635,
                        "commission": 0
                    }
                }
            },
            {
                "accountType": "SELF",
                "accountId": "A2506101204484257980786",
                "settlementId": "7ca097b1-0443-4fa7-bbae-edd2ff313d10",
                "utr": "string",
                "timestamp": 1750356504764,
                "amountBreakup":
                {
                    "totalAmount": 19160,
                    "settlementAmount": 19160,
                    "transactionFee":
                    {
                        "sgst": 0,
                        "cgst": 0,
                        "igst": 0,
                        "fee": 0,
                        "commission": 0
                    },
                    "splitSettlementFee":
                    {
                        "sgst": 0,
                        "cgst": 0,
                        "igst": 0,
                        "fee": 0,
                        "commission": 0
                    },
                    "totalFee":
                    {
                        "sgst": 0,
                        "cgst": 0,
                        "igst": 0,
                        "fee": 0,
                        "commission": 0
                    }
                }
            },
            {
                "accountType": "SELF",
                "accountId": "A2506101203231037980769",
                "settlementId": "6b329fbf-7f37-4510-9f1b-76532745fd00",
                "utr": "string",
                "timestamp": 1750356422911,
                "amountBreakup":
                {
                    "totalAmount": 19160,
                    "settlementAmount": 19160,
                    "transactionFee":
                    {
                        "sgst": 0,
                        "cgst": 0,
                        "igst": 0,
                        "fee": 0,
                        "commission": 0
                    },
                    "splitSettlementFee":
                    {
                        "sgst": 0,
                        "cgst": 0,
                        "igst": 0,
                        "fee": 0,
                        "commission": 0
                    },
                    "totalFee":
                    {
                        "sgst": 0,
                        "cgst": 0,
                        "igst": 0,
                        "fee": 0,
                        "commission": 0
                    }
                }
            }
        ]
    }
}
Response Parameters
Header Name
Data Type
Description
orderId
String
PG generated internal order id
state
String
State of order, Expected Values = [PENDING, FAILED, COMPLETED]
Note: Merchants should rely only on this "
state" parameter for the Payment status confirmation.
amount
String
Order amount in paisa
expireAt
Long
order expiry time in epoch 
(in milliseconds)
metaInfo
Object
Merchant defined meta info passed at the time of order creation
paymentDetails
List
Contain list of details of each payment attempt made corresponding to this order.
paymentDetails.paymentMode
String
Mode of payment. Expected Values = [UPI_INTENT, UPI_COLLECT, UPI_QR, CARD, TOKEN, NET_BANKING]
paymentDetails.timestamp
Long
Transaction attempt timestamp in epoch
paymentDetails.amount
Long
Amount in paisa, corresponding to payment attempt
paymentDetails.transactionId
String
internal transaction id for given payment attempt
paymentDetails.state
String
Transaction attempt state. Expected Values = [PENDING, COMPLETED, FAILED]
paymentDetails.errorCode
String
Error code (Only present when transaction state is failed)
paymentDetails.detailedErrorCode
String
Detailed Error Code (Only present when transaction state is failed)
paymentDetails.rail
String
Contains processing rail details under which payment attempt is made.
paymentDetails.rail.type
String
Type of rail. Expected values = [UPI, PG]
paymentDetails.instrument
String
Contains instrument details
paymentDetails.instrument.type
String
Type of payment instrument. Expected values = [ACCOUNT, CREDIT_CARD, DEBIT_CARD, NET_BANKING]
settlementDetails
Object
The settlement details of the order
settlementDetails.state
String
Settlement State. Expected Values =1. NOT_INITIATED2. INITIATED3. PROCESSED4. ATTEMPT_FAILED
settlementDetails.accountsSettlementDetails
Object
The settlement details of each account
Is this article helpful?