Create new order | AlphaX

curl -X POST https://public-api.alphax.com/orders \
     -H "X-API-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "reference": "ORDER-123123",
  "currency": "USD",
  "description": "Payment for Order #123123",
  "paidNotificationUrl": "https://your-backend-app.com/payment-notification/ORDER-123123",
  "dueNotificationUrl": "https://your-backend-app.com/due-notification/ORDER-123123",
  "dueAt": "2026-05-05 22:00:00",
  "lineItems": [
    {
      "name": "T-Shirt",
      "quantity": 2,
      "unitPrice": 10.99
    }
  ]
}'

{
  "order": {
    "id": "01jc0tpy0zjb0pvfh2jcej8yd6",
    "reference": "ORDER-12345",
    "description": "Payment for Order #12345",
    "currency": "USD",
    "paidNotificationUrl": "https://your-backend-app.com/payment-notification/ORDER-12345",
    "dueNotificationUrl": "string",
    "paymentLink": "https://pay.demo.alphax.asia/01k5dcgey2my8jptnmfpdft0xx",
    "dueAt": "2026-05-05T22:00:00.00Z",
    "paidAt": "2026-05-05T22:00:00.00Z",
    "createdAt": "2026-05-05T22:00:00.00Z",
    "updatedAt": "2026-05-05T22:00:00.00Z",
    "lineItems": [
      {
        "id": "01k5dcgey2my8jptnmfpdft023",
        "name": "T-Shirt",
        "quantity": 2,
        "unitPrice": 10.99
      }
    ]
  }
}

Authentication

X-API-Keystring

API Key authentication via header

Request

Your order details

referencestringOptional

Your unique order reference

currencystringOptional

Currency in ISO 4217 format (e.g. USD, SGD)

descriptionstringOptional

Description of the order (e.g. Payment for Order #12345)

paidNotificationUrlstring or nullOptional

Your backend URL to receive payment notification (e.g. https://your-backend-app.com/payment-notification/ORDER-12345)

dueNotificationUrlstring or nullOptional

Your backend URL to receive due notification (e.g. https://your-backend-app.com/due-notification/ORDER-12345)

dueAtstring or nullOptional

Due date and time for the order, format: YYYY-MM-DD HH:mm:SS (e.g. 2026-05-05 22:00:00)

lineItemslist of objectsOptional

Response

Details of the requested order

orderobject

Errors

422

Unprocessable Entity Error