Қандай нұсқалар бар
| Нұсқа | Бұл не | Кімге қолайлы |
|---|---|---|
| «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 анықтамалығында, markdown нұсқасы — docs/index.md.
Өзіңіз жазған интеграцияда әдетте не бұзылады — және ол қалай шешілген
- Сұраныс қайталанғанда екі шот.
Idempotency-Keyтақырыбы: сол кілтпен қайталау сол шотты қайтарады. - Kaspi-дің бас тартуы. HTTP 200 және
status: "failed"пен түсінікті себеппен келеді — кодтар бойынша болжаудың қажеті жоқ. - Kaspi сессиясы өлді. Kaspi бір нөмірге бір сессия ұстайды; кассир сол нөмірмен қосымшаға кірсе, қабылдау тоқтайды. Aitole оқиға мен Telegram-ға хабарлама жібереді.
- Бірнеше касса. Жоба төлемдері көрші кассаға кетпеуі үшін кілтті нақты кассаға байлауға болады.
Сынақ ортасы
sk_test_… сынақ кілті тіркелу кезінде беріледі. Сынақ ортасындағы шоттар Kaspi-ге кетпейді, ал «төленді» мәртебесі батырмамен немесе сұраныспен қойылады — кодыңыздың бүкіл жолы, вебхуктерді қоса, тексеріледі.
Интеграцияны ЖИ жазса
Көмекшіге ЖИ-ге арналған нұсқаулық сілтемесін немесе llms-full.txt толық мәтінін беріңіз — онда анықтамалық, ережелер және дайын промпт бар. ChatGPT, Claude немесе Cursor солар бойынша эндпоинттерді болжамай-ақ интеграция жасайды.