Doc – Sample Order Payloads

API Development And
Integration Guid

Sample Order Payloads

Demonstrative JSON templates for your order-related API calls—perfect for Postman, cURL, or SDK implementations.

A. Place Order — pull-codes

Endpoint: POST {baseUrl}/api/order/pull-codes 
Use this payload when ordering one or multiple digital gift cards.

json

      [
  {
    "merchant": "YourMerchantCode",
    "sku": "GOOGLE-USA-10USD",
    "quantity": 2
  },
  {
    "merchant": "YourMerchantCode",
    "sku": "APPLE-USA-25USD",
    "quantity": 1
  }
]

Explanation:

B. View Order History — order-list

Endpoint: POST {baseUrl}/api/order/list
Fetch and filter historical orders including pagination & sorting.

json

{
  "page": 1,
  "pageSize": 20,
  "orderColumn": "orderDate",
  "order": "DESC",
  "search": [
    {
      "column": "ReferenceId",
      "operator": "Equals",
      "value": "PROMO2025X"
    },
    {
      "column": "orderAmount",
      "operator": "GreaterThan",
      "value": "50"
    }
  ]
}

Explanation:

B. View Order History — order-list

Goal: Place an order and then fetch its details and status.

1. Place the order:

json

[
  {
    "merchant": "YourMerchantCode",
    "sku": "STEAM-USA-50USD",
    "quantity": 3
  }
]

2. Store orderName: e.g., A00000000000145

3. Fetch history with search filter:

json

{
  "page": 1,
  "pageSize": 10,
  "search": [
    {
      "column": "orderName",
      "operator": "Equals",
      "value": "A00000000000145"
    }
  ]
}