🚨 Announcement

A new version of the API is available. Please review the changelog for details.

Skip to content

Welcome

This page orients you to the Kaspi Delivery docs and how to get hands-on quickly.

What you will find

  • Getting started for a fast first delivery in the sandbox.
  • Authentication to handle API keys and idempotency safely.
  • Create a delivery for end-to-end payloads.
  • Webhooks to wire status updates with signature verification.
  • API reference powered by our OpenAPI spec and playground.

Base URLs

  • Sandbox: https://sandbox.kaspi.kz/delivery
  • Production: https://api.kaspi.kz/delivery

Keep keys separate and rotate them regularly.

Delivery statuses

created → accepted → in_transit → out_for_delivery → delivered

cancelled is returned if the delivery was voided before pickup.

Webhooks you will receive

  • delivery.created
  • delivery.accepted
  • delivery.in_transit
  • delivery.out_for_delivery
  • delivery.delivered
  • delivery.cancelled

Respond with a 2xx within 5 seconds to stop retries. Signature headers are documented in Webhooks & callbacks.