curl --request GET \
--url https://api-beta.pepay.io/api/commerce/merchant/orders/{orderId} \
--header 'Authorization: Bearer <token>'{
"success": true,
"data": {
"orderId": "550e8400-e29b-41d4-a716-446655440000",
"invoiceId": "550e8400-e29b-41d4-a716-446655440111",
"merchantId": 123,
"networkEnvironment": "devnet",
"retailer": "amazon",
"createdAt": "2025-12-16T00:00:00.000Z",
"updatedAt": "2025-12-16T00:10:00.000Z",
"customerId": "cust_123456",
"walletAddress": "0x0000000000000000000000000000000000000001",
"walletNetwork": "bsc",
"status": "placed",
"substatus": "AWAITING_TRACKING",
"actions": {
"canCancel": false
},
"timeline": [
{
"status": "processing",
"timestamp": "2025-12-16T00:01:00.000Z",
"message": "Payment received, processing order"
},
{
"status": "placed",
"timestamp": "2025-12-16T00:02:00.000Z",
"message": "Order placed with retailer"
}
],
"payment": {
"status": "paid",
"txHash": "0xpay",
"settlement": {
"status": "settled",
"txHash": "0xsettle",
"network": "bsc"
}
},
"fulfillment": {
"shipments": [
{
"shipmentId": "ship_123",
"carrier": "UPS",
"trackingNumber": "1Z999AA10123456784",
"carrierTrackingUrl": "https://t.17track.net/en#nums=1Z999AA10123456784",
"deliveryStatus": "In Transit",
"retailerTrackingNumber": "TBA111189418000",
"retailerTrackingUrl": "https://www.amazon.com/progress-tracker/...",
"obtainedAt": "2025-12-16T00:05:00.000Z"
}
]
},
"lineItems": [
{
"productId": "B08N5WRWNW",
"title": "Item",
"imageUrl": "https://example.com/product.jpg",
"quantity": 1,
"price": "9.00",
"status": "processing"
}
],
"shippingAddress": null,
"cancellationStatus": "none",
"refundStatus": "NONE",
"totalAmountUsd": "10.00",
"commerceFeeUsd": "1.00",
"refund": {
"status": "NONE",
"amountUsd": null,
"feeUsd": null,
"destinationWalletAddressBsc": "0x0000000000000000000000000000000000000001",
"txHash": null
}
}
}Returns the canonical merchant-facing snapshot for a single commerce order.
This is the same shape delivered in commerce.order.* webhook events and is safe to build merchant UI against.
Auth:
X-Commerce-Api-KeyAuthorization: Bearer <JWT>curl --request GET \
--url https://api-beta.pepay.io/api/commerce/merchant/orders/{orderId} \
--header 'Authorization: Bearer <token>'{
"success": true,
"data": {
"orderId": "550e8400-e29b-41d4-a716-446655440000",
"invoiceId": "550e8400-e29b-41d4-a716-446655440111",
"merchantId": 123,
"networkEnvironment": "devnet",
"retailer": "amazon",
"createdAt": "2025-12-16T00:00:00.000Z",
"updatedAt": "2025-12-16T00:10:00.000Z",
"customerId": "cust_123456",
"walletAddress": "0x0000000000000000000000000000000000000001",
"walletNetwork": "bsc",
"status": "placed",
"substatus": "AWAITING_TRACKING",
"actions": {
"canCancel": false
},
"timeline": [
{
"status": "processing",
"timestamp": "2025-12-16T00:01:00.000Z",
"message": "Payment received, processing order"
},
{
"status": "placed",
"timestamp": "2025-12-16T00:02:00.000Z",
"message": "Order placed with retailer"
}
],
"payment": {
"status": "paid",
"txHash": "0xpay",
"settlement": {
"status": "settled",
"txHash": "0xsettle",
"network": "bsc"
}
},
"fulfillment": {
"shipments": [
{
"shipmentId": "ship_123",
"carrier": "UPS",
"trackingNumber": "1Z999AA10123456784",
"carrierTrackingUrl": "https://t.17track.net/en#nums=1Z999AA10123456784",
"deliveryStatus": "In Transit",
"retailerTrackingNumber": "TBA111189418000",
"retailerTrackingUrl": "https://www.amazon.com/progress-tracker/...",
"obtainedAt": "2025-12-16T00:05:00.000Z"
}
]
},
"lineItems": [
{
"productId": "B08N5WRWNW",
"title": "Item",
"imageUrl": "https://example.com/product.jpg",
"quantity": 1,
"price": "9.00",
"status": "processing"
}
],
"shippingAddress": null,
"cancellationStatus": "none",
"refundStatus": "NONE",
"totalAmountUsd": "10.00",
"commerceFeeUsd": "1.00",
"refund": {
"status": "NONE",
"amountUsd": null,
"feeUsd": null,
"destinationWalletAddressBsc": "0x0000000000000000000000000000000000000001",
"txHash": null
}
}
}Was this page helpful?