Changelog

​

2.1.3 - 2026-06-06

​

Ping

• Added GET /ping — returns { status, timestamp } to verify API connectivity. Requires x-api-key and a whitelisted IP address.

​

2.1.2 - 2026-06-06

​

Catalog

• Replaced ambiguous discount on catalog products with explicit discountAmount (minor units) and discountPercentage (commission rate).

​

Breaking API changes

​

2.1.1 - 2026-06-06

​

API reference

• Retrieve order → partially_completed response example now explicitly includes products[].codes for all delivered units (not only delivered / total).

​

2.1.0 - 2026-06-06

​

Order behaviour

• partially_completed responses include products[].codes for every delivered unit, alongside delivered and total.

​

Catalog

• redeemable is derived from countryCode (e.g. GB → United Kingdom), not the internal region field.
• Documented optional promotion* fields on catalog products (see Promotions).
• Documented optional serviceFee* fields on catalog products (see Service fee).

​

Breaking API changes

These apply to all v2 catalog and order responses:

​

New validation

• If you send a top-level price on POST /orders, it must equal the sum of (line price × quantity) or the request returns 400 with Order price mismatch: expected total {n}.

​

New response headers

All v2 responses now include:

• X-RateLimit-Limit
• X-RateLimit-Remaining
• X-RateLimit-Reset

429 responses still include Retry-After. See Rate limits.

​

Documentation

• Fixed polling example to respect estimatedReadyAt.
• Added guidance for partially_completed, sandbox, webhooks (coming soon), and cancellation.
• Multi-line order pricing example.
• Reference Node client in examples/kalixo-node.

​

2.0.0 - initial release

• Async ordering with POST /orders + poll GET /orders/{reference}.
• Catalog filtering and pagination.
• Wallet endpoint and embedded wallet snapshots on orders.
• API-key authentication (x-api-key).