Kaspi Pay және CRM: AiPay API арқылы төлемдерді автоматтандыру

Сату менеджері Kaspi қосымшасын ашады, соманы көреді, Битрикс24-ке ауысады, соманы қолмен енгізеді, «төленді» мәртебесін қояды, WhatsApp-ты ашады, клиентке «рахмет» деп жазады. Бұл — бүгін қырқыншы рет.

Күніне 30 мәміле болса, мұндай цикл тәулігіне 90–120 минут таза уақытты алады — әр менеджерден, күн сайын. Бұл айына 45 сағат — автоматтандыруға бір кеш жетерлік процеске арналған.

Мәселе жалқаулықта емес. Мәселе — Kaspi Pay-дің CRM үшін нативті webhook-хабарландырулары жоқтығында. Битрикс24 үшін ресми коннектор жоқ. AmoCRM-мен дайын интеграция жоқ. «Клиент төледі» мен «CRM білді» арасындағы алшақтық — толығымен қолмен толтырылады.

Бұл нұсқаулықта — AiPay API арқылы осы алшақтықты қалай жабу керектігі және үш нақты сценарий: Битрикс24, AmoCRM, кастомды ERP.

Неліктен CRM + Kaspi Pay — күрделі мәселе

Kaspi Pay — Қазақстандағы үстем төлем құралы. 12 миллионнан астам белсенді пайдаланушы, телефон нөмірі арқылы лездік аударымдар. Бизнес үшін бұл клиент тарапынан мінсіз UX.

Әзірлеуші тарапынан — басқа оқиға.

Kaspi ұсынбайтындар:

• Төлем мәртебесі өзгергенде webhook
• Телефон нөмірі бойынша шот-фактура жасауға API
• Қауіпсіз қайталанатын сұраулар үшін идемпотенттілік механизмі
• Танымал CRM-дермен дайын интеграциялар

Демек, бизнес екі жүйенің арасында қалады: CRM мәмілелерді басқара алады, Kaspi ақша қабылдай алады — бірақ олар бір-бірімен сөйлеспейді.

Стандартты айналым жол — скриншоттар. Клиент төлейді, скриншот жасайды, WhatsApp-қа жібереді. Менеджер скриншотты қарайды, соманы қолмен тексереді, CRM-ді жаңартады. Бұл процесс емес — антипаттерн.

Шығындарыңызды қазір есептегіңіз келе ме? Күндегі мәміле санын 3 минутқа көбейтіңіз. Бұл — интеграция болмауының күнделікті «салығы». AiPay-ді 7 күн тегін сынап көріңіз.

Архитектура: AiPay байланыстырушы буын ретінде

AiPay — CRM жүйеңіз бен Kaspi Pay инфрақұрылымы арасындағы төлем middleware. Kaspi тікелей ұсынбайтын барлығын өз мойнына алады: шот-фактуралар жасауға API, мәртебені верификациялау, жүйеңізге webhook-хабарландырулар.

Деректер ағымының схемасы:

Сіздің CRM / ERP
      │
      │  POST /invoices
      │  { phone, amount, idempotency_key }
      ▼
  AiPay API  ◄──── HMAC-қолтаңба
      │
      │  Kaspi Pay-де шот-фактура жасайды
      │  Мәртебені бақылайды
      ▼
  Kaspi Pay
      │
      │  Клиент төлейді
      ▼
  AiPay API
      │
      │  HTTP POST → сіздің webhook endpoint-іңізге
      │  { status: "paid", invoice_id, amount }
      ▼
Сіздің CRM / ERP
  — мәміле мәртебесін жаңартады
  — фискалдық чек жасайды
  — менеджерге хабарлайды

Негізгі элементтер:

• POST /invoices — телефон нөмірі мен сомасы бойынша шот-фактура жасайды, invoice_id қайтарады
• Webhook — мәртебе өзгергенде endpoint-іңізге HTTP POST жібереді (paid, expired, error)
• HMAC-қолтаңба — әр webhook құпия кілтпен қол қойылады, сіздің тарапта верификацияланады
• Idempotency key — қайталанатын сұрауларда дублирование-ден қорғайды
• Фискалдық чек — paid мәртебесінде автоматты түрде беріледі
• Sandbox — нақты ақшасыз тестілеу ортасы

Толық құжаттама — әзірлеушілер бөлімінде.

Үш интеграция сценарийі

1-сценарий: Битрикс24

Битрикс24 REST API және Custom Activities арқылы кіріс webhook-сұрауларды қолдайды. Бұл дегеніміз: AiPay аралық сервер қажет етпей-ақ мәміле мәртебесін тікелей жаңарта алады.

Ағым:

1. Менеджер Битрикс24-те «Төлем күтілуде» мәртебесімен мәміле жасайды
2. Bitrix24 Automation немесе кезең өңдеушісі AiPay-ді шақырады: клиенттің телефоны мен мәміле сомасымен POST /invoices
3. AiPay клиентке Kaspi Pay төлем сілтемесін жібереді
4. Клиент төлейді
5. AiPay endpoint-іңізге webhook жібереді: { "status": "paid", "invoice_id": "...", "deal_id": "..." }
6. Өңдеушіңіз Bitrix24 REST API шақырады: crm.deal.update — мәмілені «Төленді» кезеңіне ауыстырады
7. Менеджер Telegram немесе Битрикс24-те хабарландыру алады

Техникалық мәліметтер:

• Webhook endpoint-ті бөлек микросервисте немесе Битрикс24 серверінде орналастыруға болады (self-hosted болса)
• Bitrix24 Cloud үшін — Автоматтандыру бөліміндегі Webhook Handler пайдаланыңыз
• deal_id-ді шот-фактура жасағанда external_id ретінде жіберіңіз — AiPay оны webhook-payload-та қайтарады

Нәтиже: менеджер мәміле жасағаннан кейін ешнәрсені қолмен жасамайды. Мәртебе автоматты түрде жаңарады.

---

2-сценарий: AmoCRM

AmoCRM бірдей логика бойынша жұмыс істейді, бірақ өзінің webhook механизмі мен pipeline кезеңдері бар.

Ағым:

1. Мәміле «Шот-фактура берілді» кезеңіне өтеді — AmoCRM Automation-дағы триггер
2. Автоматтандыру AiPay-ге HTTP сұрауын жібереді: POST /invoices
3. Клиент төлем сілтемесін алады
4. AiPay webhook хабарлайды: status: paid
5. Өңдеушіңіз AmoCRM API шақырады: мәмілені «Төленді» кезеңіне ауыстырады, тег қосады, менеджерге тапсырма жасайды

AmoCRM үшін маңызды ескерту: платформа pipeline-триггерлерден ғана сыртқы HTTP сұрауларын шақыруға мүмкіндік береді. Аккаунтыңызда Webhooks қолдауы бар жоспар белсендірілгеніне көз жеткізіңіз (Professional және жоғары).

Қосымша: AiPay-ден webhook алғанда AmoCRM клиент картасына сома, күн және invoice_id бар жазба автоматты түрде қосылуы мүмкін — аудит үшін.

---

3-сценарий: Кастомды ERP немесе өз жүйеңіз

Егер сізде кастомды есеп жүйесі, интернет-дүкен немесе платформа болса — AiPay API арқылы интеграция толық бақылауды береді.

Минималды жинақ:

1. Авторизация: әр сұраудың тақырыбында Bearer-токен
2. Шот-фактура жасау: POST /invoices — invoice_id және төлем сілтемесін қайтарады
3. Webhook қабылдау: endpoint-іңіз POST сұрауын өңдейді, HMAC верификациялайды, DB-дегі мәртебені жаңартады
4. Фискалдық чек: автоматты түрде жасалады, API арқылы қол жетімді

Идемпотенттілік: бірдей idempotency_key-ді қайта жібергенде AiPay бұрыннан бар шот-фактураны қайтарады — дублированиесіз. Retry-логика үшін маңызды.

Код мысалы: Python Flask-тегі webhook өңдеушісі

Бұл — минималды өңдеуші. AiPay-ден POST қабылдайды, HMAC-қолтаңбаны верификациялайды, жүйеңіздегі мәртебені жаңартады.

import hmac
import hashlib
from flask import Flask, request, jsonify

app = Flask(__name__)
AIPAY_SECRET = "сіздің_webhook_secret"

@app.route("/aipay/webhook", methods=["POST"])
def handle_webhook():
    payload = request.get_data()
    sig = request.headers.get("X-AiPay-Signature", "")
    expected = hmac.new(AIPAY_SECRET.encode(), payload, hashlib.sha256).hexdigest()

    if not hmac.compare_digest(sig, expected):
        return jsonify({"error": "invalid signature"}), 403

    data = request.get_json()
    if data.get("status") == "paid":
        update_crm_deal(data["external_id"], "paid", data["amount"])

    return jsonify({"ok": True}), 200

Мұнда не болып жатыр:

• X-AiPay-Signature — сұрау денесінің HMAC-SHA256 қолтаңбасы, құпия кілтпен қол қойылған
• hmac.compare_digest — қолтаңбаларды салыстырудағы timing-шабуылдардан қорғаныс
• external_id — шот-фактура жасағанда берілген deal_id немесе кез келген идентификаторыңыз
• update_crm_deal — CRM жаңарту функцияңыз (Bitrix24 REST API, AmoCRM API, деректер қорыңыз)

Node.js Express-тегі ұқсас логика 12–15 жолды алады.

---

Мұны 1 сағатта қосыңыз

AiPay бүкіл циклді алады: шот-фактура → төлем → растау → сіздің CRM. 7 күн тегін, картасыз.

Бастау →

---

Дейін және кейін: менеджер жұмысы қалай өзгереді

AiPay-сіз — қолмен процесс

| Қадам | Кім жасайды | Уақыт | |---|---|---| | CRM-де мәміле жасау | Менеджер | 1 мин | | Клиентке қоңырау, төлеуін сұрау | Менеджер | 2–3 мин | | WhatsApp-тан скриншот күту | Менеджер | 5–30 мин | | Скриншотты қолмен тексеру | Менеджер | 1–2 мин | | CRM-дегі мәртебені жаңарту | Менеджер | 1 мин | | Фискалдық чек беру | Менеджер / бухгалтер | 2–5 мин | | Бір мәміледегі жиын | | 12–42 мин |

Күніне 30 мәміле болғанда: тәулігіне 90–120 минут күнделікті рутинаға.

AiPay-мен — автоматты процесс

| Қадам | Кім жасайды | Уақыт | |---|---|---| | CRM-де мәміле жасау | Менеджер | 1 мин | | AiPay шот-фактура жасайды, клиент сілтеме алады | Автоматты | 0 сек | | Клиент төлейді | Клиент | — | | AiPay webhook CRM-ді жаңартады, чек береді | Автоматты | 0 сек | | Менеджер хабарландыру алады | Автоматты | — | | Бір мәміледегі жиын | | 1 мин |

Күніне 30 мәміле болғанда: тәулігіне 90–120 минут үнемделеді = айына 45+ сағат.

Тағы нелер өзгереді:

• Жалған скриншоттар тәуекелі жоқ — мәртебе API арқылы тікелей расталады, суреттен емес
• Фискалдық чектер автоматты түрде беріледі — аудит ізі таза
• Менеджер сатумен айналысады, копипастпен емес
• Түнгі және демалыс күндеріндегі төлемдер команда қатысынсыз өңделеді

Қалай бастау керек: техникалық деталдарсыз 4 қадам

1-қадам — Тіркеліп, API-кілт алыңыз. aipay.kz-де аккаунт жасаңыз. API-кілт және webhook secret тіркелгеннен кейін Dashboard-та бірден қол жетімді. Алғашқы 7 күн — тегін.

2-қадам — Sandbox-та тестілеңіз. AiPay нақты транзакцияларсыз тестілеу ортасын ұсынады. Бірнеше тест шот-фактурасын жіберіңіз, webhook-тің endpoint-іңізге жететінін тексеріңіз. Нұсқаулық — әзірлеушілер құжаттамасында.

3-қадам — CRM-мен интеграцияны баптаңыз. Битрикс24 және AmoCRM үшін — CRM интерфейсінде автоматтандыруды баптау + webhook өңдеушіні орналастыру. Кастомды жүйелер үшін — REST API арқылы тікелей интеграция. Баптаудың кәдімгі уақыты: 1–4 сағат.

4-қадам — Продакшнға өтіңіз. Sandbox-кілттерді жауынгерлікке ауыстырыңыз, бірнеше нақты тест транзакциясын жүргізіңіз, фискалдық чектердің дұрыс берілетінін тексеріңіз.

Көмек қажет болса — WhatsApp немесе Telegram-ға жазыңыз.

Жиі қойылатын сұрақтар

Қосу үшін бағдарламашы керек пе?

Кастомды интеграция үшін — иә, 4–8 сағат жұмысқа әзірлеуші керек. Битрикс24 және AmoCRM үшін негізгі баптауды код жазбай-ақ автоматтандыру интерфейсі арқылы жасауға болады, егер CRM әкімшілігіне қол жетімділігіңіз болса. Біз кілт тапсыру интеграцияларын да жасаймыз — бізге жазыңыз.

AiPay Kaspi Pay-мен қалай байланысады?

AiPay — Kaspi Pay-дің ресми серіктесі және интеграторы. Яғни POST /invoices шақырғанда AiPay Kaspi инфрақұрылымында нақты шот-фактура жасайды, клиент оны Kaspi қосымшасында көреді және бір рет басып төлей алады. Сіз Kaspi-мен тікелей жұмыс жасамайсыз — AiPay барлық авторизациялауды, мәртебелерді бақылауды және хабарландыруларды өз мойнына алады.

Битрикс24-те Kaspi Pay-мен дайын интеграция бар ма?

Нативті интеграция жоқ — Битрикс24-те де, оның қосымшалар маркетплейсінде де. Үшінші тарап шешімдері бар (мысалы, AngryCode), бірақ олар не маңызды кастомизацияны қажет етеді, не нақты уақытта webhook-хабарландырулар қолдамайды. AiPay дайын API + webhook ұсынады, олар бірнеше сағатта CRM стандартты REST API арқылы Битрикс24-ке қосылады.

Клиент төлемесе не болады?

AiPay шот-фактурасына уақыт өткеннен кейін expired мәртебесін береді (баптауға болады). Осы мәртебемен webhook endpoint-іңізге келеді — сіз CRM-дегі мәмілені автоматты түрде «Шот-фактура мерзімі өтті» мәртебесіне ауыстыра аласыз немесе қайталанатын сценарий іске қосуға болады (мысалы, жаңа шот-фактура жіберу немесе менеджерге хабарландыру).

Бағасы қанша?

Бір терминал үшін айына ₸25 000. Алғашқы 7 күн — тегін, картасыз. Күніне 20+ мәмілесі бар бизнестің көпшілігі үшін AiPay менеджерлер уақытының үнемделуі есебінен 2–3 жұмыс күнінде өзін-өзі ақтайды.

---

Егер бизнесіңіз Kaspi Pay арқылы төлем қабылдаса және менеджерлер скриншоттарды қолмен тексеріп жатса — мұны бүгін өзгертуге болады.

Қосу шамамен 1 сағатты алады. Алғашқы 7 күн — тегін. Битрикс24, AmoCRM немесе өз жүйеңізбен интеграция — бірыңғай API арқылы.

AiPay-ді тегін сынап көру →