Skip to main content
GET
/
api
/
commerce
/
merchant
/
orders
/
{orderId}
Get merchant order details (scoped)
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
    }
  }
}

Authorizations

Authorization
string
header
required

JWT token for wallet authentication

Path Parameters

orderId
string<uuid>
required

Response

Order snapshot

success
boolean
Example:

true

data
object

Merchant-facing commerce order snapshot (scoped by merchant + environment).