Query Order

Query Single Order

GET /api/v1/pay/order/{id}

GET /api/v1/pay/order/550e8400-e29b-41d4-a716-446655440000

Response

{
  "order_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "settled",
  "method": "Direct",
  "pay_tx": "0xabc123...",
  "settle_tx": "0xdef456...",
  "settled_amount": "10000000",
  "created_at": "2026-03-23T12:00:00Z",
  "updated_at": "2026-03-23T12:00:30Z"
}

Order Status Flow

waiting_payment → settling → settled
                          → failed
                → expired

Status	Description
`waiting_payment`	Waiting for user payment
`settling`	TX reported, waiting for on-chain confirmation
`settled`	Settlement complete
`failed`	Payment failed
`expired`	Timed out without payment (30 minutes)

Query Order List

GET /api/v1/pay/orders?payer={address}&limit={n}

Query user order history by wallet address.

GET /api/v1/pay/orders?payer=0xAbc123...&limit=20

Response

{
  "orders": [
    {
      "order_id": "550e8400-...",
      "status": "settled",
      "method": "Direct",
      "pay_blockchain": "base",
      "pay_token": "USDC",
      "settle_chain": "eip155:8453",
      "settle_token": "USDC",
      "merchant_amount": "9500000",
      "fee_amount": "500000",
      "merchant_id": "shop-001",
      "pay_tx": "0xabc...",
      "settle_tx": "0xdef...",
      "settled_amount": "10000000",
      "created_at": "2026-03-23T12:00:00Z",
      "updated_at": "2026-03-23T12:00:30Z"
    }
  ],
  "count": 1
}

Parameter	Type	Description
`payer`	`string`	Wallet address (required)
`limit`	`u32`	Number of results to return, default 20, max 100