Kaspi Shop (seller API)

• Status: Preview
• Shelf: Commerce and payments
• How you connect: API key
• Regions: global and Kazakhstan
• The service’s own API reference: https://kaspi.kz/merchantcabinet/support/display/Support/API

Apps read Kaspi.kz shop orders with your seller API token. Kaspi is reached through the HTTP API connector with a preset: the gate calls only kaspi.kz/shop/api/v2 and only with GET. The token is sealed to the gate and apps never see it.

Connect it#

1. In the Kaspi Seller Cabinet open Settings and generate an API token (kaspi.kz/merchantcabinet).
2. Qaldy → Connectors → Kaspi → Connect Kaspi → paste the token → Seal and connect.

Test connection only checks that the sealed token opens. Kaspi's order list needs a date range and a state, which a fixed test call can't carry, so the gate sends nothing.

What the gate allows#

Use it from an app#

{ "id": "http", "actions": ["request"], "scope": "conn_k3v9…" }

const api = ctx.connectors.http('conn_k3v9…')
const since = Date.now() - 24 * 60 * 60 * 1000
const orders = await api.get('/orders', {
  query: {
    'page[number]': 0,
    'page[size]': 20,
    'filter[orders][state]': 'NEW',
    'filter[orders][creationDate][$ge]': since,
    'filter[orders][creationDate][$le]': Date.now(),
  },
})

Kaspi expects millisecond timestamps and a creation-date window of at most 14 days.

When it breaks#

Native Kaspi actions (ctx.connectors.kaspi.listOrders) are not served by the gate.