Orders

Run in Postman

Manage your orders: create, retrieve, update, and list orders.

Base URL: https://staging-api.xepeng.com/openapi/orders

staging

POST

Create Order

Create a new order with amount, currency, customer information, and metadata.

Parameters

Reference	Type	Description
amount	number	The amount to be paid (required).
currency	string	Currency code, e.g. "IDR" (required).
customer	object	Customer details: name, email, phone.
metadata	object	Custom key-value pairs for your reference.

Example Request

curl --request POST "https://staging-api.xepeng.com/openapi/orders" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer {{api_key}}" \
  --data-raw '{
    "amount": 100000,
    "currency": "IDR",
    "description": "Order for product X",
    "customer": {
      "name": "John Doe",
      "email": "john.doe@example.com",
      "phone": "+6281234567890"
    },
    "metadata": {
      "order_ref": "ORDER-12345"
    }
  }'

PUT

Update Order

Update an existing order by its UID. You can update amount, description, or metadata.
Endpoint: /openapi/orders/:order_uid

Example Request

curl --request PUT "https://staging-api.xepeng.com/openapi/orders/ord_12345" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer {{api_key}}" \
  --data-raw '{
    "amount": 150000,
    "description": "Updated description"
  }'

GET

Get Order

Retrieve a single order's details by its UID.
Endpoint: /openapi/orders/:order_uid

Example Request

curl --request GET "https://staging-api.xepeng.com/openapi/orders/ord_12345" \
  --header "Authorization: Bearer {{api_key}}"

GET

List Orders

List orders with pagination support.
Endpoint: /openapi/orders

Query Parameters

Parameters	Type	Description
page	integer	Page number (default: 1).
limit	integer	Items per page (default: 10).

Example Request

curl --request GET "https://staging-api.xepeng.com/openapi/orders?page=1&limit=10" \
  --header "Authorization: Bearer {{api_key}}"