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.
Environment
| Environment | Http Method | API |
|---|---|---|
| GET | https://api-preprod.phonepe.com/apis/pg-sandbox/payments/v2/order/{merchantOrderId}/status |
Production | GET | https://api.phonepe.com/apis/pg/payments/v2/order/{merchantOrderId}/status |
Request
Request Headers
| Header Name | Header Value |
| Content-Type | application/json |
| Authorization | O-Bearer <partner-auth-token> |
| X-MERCHANT-ID | MID |
Path Parameters
| Header Name | Description |
|---|---|
merchantOrderId | The merchant generated Order Id |
Query Parameters
| Header Name | Description |
|---|---|
settlementDetails | true → return the details under settlementDetails |
Response
Response Headers
| Header Name | Header Value |
|---|---|
Content-Type | application/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