Skip to main content
POST
/
orders
Create Order
curl --request POST \
  --url https://quickei.io/pay/sandbox/api/v1/orders \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 123,
  "currency": "<string>",
  "payment_method": "<string>",
  "reference": "<string>",
  "description": "<string>",
  "terminal_id": "<string>",
  "callback_url": "<string>",
  "expires_in": 123,
  "idempotency_key": "<string>"
}
'
Creates a new POS payment order with a dynamic QR code and/or payment page.

​
Endpoint

POST https://quickei.io/pay/sandbox/api/v1/orders

​
Parameters

​
amount
decimal
required
Amount to charge. Must be greater than 0.
​
currency
string
required
ISO 4217 currency code (e.g. EUR, USD). Must match an active wallet.
​
payment_method
string
qr_only, payment_page, or both (default: both)
​
reference
string
Your internal order/invoice reference (max 255 chars)
​
description
string
Order description shown on the payment page (max 500 chars)
​
terminal_id
string
POS terminal identifier (max 64 chars)
​
callback_url
string
Webhook URL for order status updates
​
expires_in
integer
Expiration in seconds (60–3600, default: 300)
​
idempotency_key
string
Unique key to prevent duplicate orders (max 64 chars)

​
Example Request

POST /merchant-api/pos/v1/orders
Authorization: Basic {base64_credentials}
Content-Type: application/json

{
  "amount": 25.00,
  "currency": "EUR",
  "payment_method": "both",
  "reference": "INV-2024-001",
  "description": "Table 5 - Lunch",
  "terminal_id": "terminal-01",
  "callback_url": "https://yoursite.com/webhook",
  "expires_in": 300,
  "idempotency_key": "idem_abc123"
}

​
Success Response 200

{
  "message": {
    "success": ["POS order created successfully"]
  },
  "data": {
    "order_id": "POS-20240115-A1B2C3",
    "amount": "25.00 EUR",
    "raw_amount": 25.00,
    "currency": "EUR",
    "payment_method": "both",
    "reference": "INV-2024-001",
    "description": "Table 5 - Lunch",
    "terminal_id": "terminal-01",
    "status": "PENDING",
    "qr_data": "quickei://pay?order=POS-20240115-A1B2C3&a=25.00&c=EUR",
    "payment_url": "https://quickei.io/pay/pos/POS-20240115-A1B2C3",
    "trx_id": null,
    "paid_at": null,
    "expires_at": "2024-01-15T14:05:00+00:00",
    "created_at": "2024-01-15T14:00:00+00:00"
  }
}