Create new order

POST

/orders

POST

/orders

1 curl -X POST https://public-api.alphax.com/orders \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "reference": "ORDER-123123",
6   "currency": "USD"
7 }'

1 {
2   "order": {
3     "id": "01jc0tpy0zjb0pvfh2jcej8yd6",
4     "reference": "ORDER-12345",
5     "description": "Payment for Order #12345",
6     "currency": "USD",
7     "paidNotificationUrl": "https://your-backend-app.com/payment-notification/ORDER-12345",
8     "dueNotificationUrl": "string",
9     "paymentLink": "https://pay.demo.alphax.asia/01k5dcgey2my8jptnmfpdft0xx",
10     "dueAt": "2026-05-05T22:00:00.00Z",
11     "paidAt": "2026-05-05T22:00:00.00Z",
12     "createdAt": "2026-05-05T22:00:00.00Z",
13     "updatedAt": "2026-05-05T22:00:00.00Z",
14     "lineItems": [
15       {
16         "id": "01k5dcgey2my8jptnmfpdft023",
17         "name": "T-Shirt",
18         "quantity": 2,
19         "unitPrice": 10.99
20       }
21     ]
22   }
23 }

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

Your order details

referencestringOptional

Your unique order reference

currencystringOptional

Your unique order reference

Response

Details of the requested order

orderobject

Errors

422

Unprocessable Entity Error