# Сайт пен CRM үшін Kaspi Pay API бар ма

> Kaspi Pay-де төлем қабылдауға арналған ашық жария API жоқ: «Kaspi.kz-тегі төлемдер» Kaspi Гид арқылы өтінім бойынша қосылады, ал Kaspi.kz Дүкенінің API-і төлеммен емес, маркетплейстің тауарлары мен тапсырыстарымен жұмыс істейді. Kaspi Pay үстіндегі сервистер кәдімгі REST API береді. Aitole-де бір сұраныс QR немесе нөмірге шот жасайды, төлем HMAC-SHA256 қолтаңбасы бар вебхукпен келеді, ал бүкіл жолды нағыз ақшасыз сынақ ортасында тексеруге болады.

Источник: https://aitole.kz/kk/kaspi-api/ · Aitole — https://aitole.kz

## Қандай нұсқалар бар

| Нұсқа | Бұл не | Кімге қолайлы |
|---|---|---|
| «Kaspi.kz-тегі төлемдер» | Kaspi-мен серіктестік: қызметтеріңіз Kaspi.kz қосымшасында, өтінім бойынша қосылу, жауап — бірнеше күн ішінде | Ірі қызмет жеткізушілерге |
| Kaspi.kz Дүкенінің API-і | Kaspi маркетплейсінің тауарлары, қалдықтары және тапсырыстары | Маркетплейстегі сатушыларға |
| Kaspi Pay үстіндегі сервис (Aitole) | Kaspi Pay кассаңызға REST API: QR, шоттар, сілтемелер, қайтарулар, вебхуктер | Сайттарға, CRM, боттарға, SaaS |

## Aitole API қалай жасалған

```
POST https://api.aitole.kz/v2/invoices
X-API-Key: sk_live_…
Idempotency-Key: order-42
{"amount": 4990, "phone": "+77011234567", "comment": "Тапсырыс №42"}
```

- `POST /v2/qr` — бір сатып алуға арналған QR және төлем сілтемесі.
- `POST /v2/invoices` — клиент нөміріне шот, ол оның Kaspi қосымшасына келеді.
- `POST /v2/refunds` — толық немесе ішінара қайтару.
- Тұрақты төлем сілтемелері мен тұрақты шоттар — бұлар да API арқылы.
- `GET /v2/events` — оқиғалар журналы: вебхук жетпесе, ештеңе жоғалмайды.
- HMAC-SHA256 қолтаңбасы бар `payment.paid`, `payment.expired`, `payment.refunded` вебхуктері.

Толық сипаттама — [API анықтамалығында](/kk/docs/), markdown нұсқасы — [docs/index.md](/docs/index.md).

## Өзіңіз жазған интеграцияда әдетте не бұзылады — және ол қалай шешілген

- **Сұраныс қайталанғанда екі шот.** `Idempotency-Key` тақырыбы: сол кілтпен қайталау сол шотты қайтарады.
- **Kaspi-дің бас тартуы.** HTTP 200 және `status: "failed"` пен түсінікті себеппен келеді — кодтар бойынша болжаудың қажеті жоқ.
- **Kaspi сессиясы өлді.** Kaspi бір нөмірге бір сессия ұстайды; кассир сол нөмірмен қосымшаға кірсе, қабылдау тоқтайды. Aitole оқиға мен Telegram-ға хабарлама жібереді.
- **Бірнеше касса.** Жоба төлемдері көрші кассаға кетпеуі үшін кілтті нақты кассаға байлауға болады.

## Сынақ ортасы

`sk_test_…` сынақ кілті тіркелу кезінде беріледі. Сынақ ортасындағы шоттар Kaspi-ге кетпейді, ал «төленді» мәртебесі батырмамен немесе сұраныспен қойылады — кодыңыздың бүкіл жолы, вебхуктерді қоса, тексеріледі.

## Интеграцияны ЖИ жазса

Көмекшіге [ЖИ-ге арналған нұсқаулық](/kk/for-ai/) сілтемесін немесе [llms-full.txt](/llms-full.txt) толық мәтінін беріңіз — онда анықтамалық, ережелер және дайын промпт бар. ChatGPT, Claude немесе Cursor солар бойынша эндпоинттерді болжамай-ақ интеграция жасайды.

## Сұрақтар

### Kaspi Pay-де төлем қабылдауға арналған ресми ашық API бар ма?

Өз бетіңізше тіркелетін жария API жоқ. «Kaspi.kz-тегі төлемдер» серіктестігі Kaspi Гид арқылы өтінім бойынша қосылады. Сайттар мен CRM үшін Kaspi Pay үстіндегі сервистер қолданылады.

### Ақша Aitole арқылы өте ме?

Жоқ. Шот сіздің кассаңыздың атынан жіберіледі, клиент Kaspi-де төлейді, ақша сіздің Kaspi Pay-іңізге түседі. Aitole тек төлем мәртебесін көреді.

### Kaspi кассамды API-ге қалай қосамын?

Кабинетте: Kaspi Pay-ге «Кассир» рөлі бар қызметкерді қосып, SMS-тегі кодты енгізіңіз. Kaspi құпиясөзі керек емес, «Кассир» рөлі ақша шығара алмайды.

### API қанша тұрады?

API барлық тарифке, соның ішінде тегін тарифке кіреді: айына 20 төленген төлем. Start — 500 төлем үшін 7 000 ₸, Pro — шектеусіз 30 000 ₸. Сұраныстар мен төленбеген шоттар тарифтелмейді.

### Интеграцияны нағыз ақшасыз тексеруге бола ма?

Иә, сынақ кілтімен сынақ ортасында: шоттар Kaspi-ге кетпейді, ал төлемді өзіңіз белгілейсіз.