Skip to main content
Most products are fixed — they have a single price. Open-denomination products let you choose any amount within an allowed range (for example, a top-up between £5 and £100).

​
Identifying open products

Each catalog product includes denomination metadata: 
{
  "id": 814,
  "name": "Flexible Top-Up",
  "currencyCode": "GBP",
  "denominationType": "open",
  "denominationMinValue": 500,
  "denominationMaxValue": 10000,
  "denominationStep": 100,
  "denominationDefaultValue": 2500
}
​
denominationType
string
fixed or open.
​
denominationMinValue
number
Minimum amount (minor units) for open products.
​
denominationMaxValue
number
Maximum amount (minor units) for open products.
​
denominationStep
number
Increment the chosen amount must align to.
​
denominationDefaultValue
number
Suggested default amount.

​
Ordering an open product

Send your chosen amount as the line price. It must fall within [min, max] and align to step. 
curl -X POST "https://api.kalixo.io/v2/orders" \
  -H "x-api-key: $KALIXO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalOrderCode": "O-OPEN-1",
    "currency": "GBP",
    "price": 5000,
    "orderProducts": [
      { "productId": 814, "price": 5000, "quantity": 1 }
    ]
  }'
Amounts outside the allowed range are rejected with 400 Bad Request. For fixed products, the line price must exactly match the catalog price.