← Все статьи
CRMинтеграцияAPI

Kaspi Pay + CRM: интеграция через AiPay API

Как подключить Kaspi Pay к Битрикс24, AmoCRM или своей ERP через AiPay API — без ручных проверок, со сценариями и кодом.

Kaspi Pay и CRM: автоматизация оплат через AiPay API

Менеджер по продажам открывает Kaspi-приложение, смотрит на сумму, переключается в Битрикс24, вводит сумму вручную, ставит статус «оплачено», открывает WhatsApp, пишет клиенту «спасибо». Это — сороковой раз за сегодня.

При 30 сделках в день такой цикл отнимает 90–120 минут чистого времени — ежедневно, у каждого менеджера. Это 45 часов в месяц на копипаст, который давно должен делать скрипт.

Проблема не в лени. Проблема в том, что у Kaspi Pay нет нативных webhook-уведомлений для CRM. Нет официального коннектора для Битрикс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 — платёжный middleware между вашей CRM и инфраструктурой Kaspi Pay. Он берёт на себя всё, что 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 — HTTP POST на ваш endpoint при изменении статуса (paid, expired, error)
  • HMAC-подпись — каждый webhook подписан секретным ключом, верифицируется на вашей стороне
  • Idempotency key — защищает от дублирования при повторных запросах
  • Фискальный чек — выдаётся автоматически при статусе paid
  • Sandbox — тестовая среда без реальных денег

Подробная документация — в разделе для разработчиков.

Три сценария интеграции

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

Битрикс24 поддерживает входящие webhook-запросы через REST API и Custom Activities. Это означает: AiPay может напрямую обновлять статус сделки, не требуя промежуточного сервера.

Поток:

  1. Менеджер создаёт сделку в Битрикс24 со статусом «Ожидание оплаты»
  2. Bitrix24 Automation или обработчик стадии вызывает AiPay: POST /invoices с номером телефона клиента и суммой сделки
  3. AiPay отправляет клиенту ссылку на оплату в Kaspi Pay
  4. Клиент платит
  5. AiPay посылает webhook на ваш endpoint: { "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. Автоматизация делает HTTP-запрос к AiPay: POST /invoices
  3. Клиент получает ссылку на оплату
  4. AiPay webhook сигнализирует: status: paid
  5. Ваш обработчик вызывает AmoCRM API: переводит сделку в стадию «Оплачено», добавляет тег, создаёт задачу менеджеру

Важный нюанс для AmoCRM: платформа позволяет вызывать внешние HTTP-запросы только из pipeline-триггеров. Убедитесь, что у вашего аккаунта активирован план с поддержкой Webhooks (от Professional и выше).

Дополнительно: при получении webhook от AiPay можно автоматически добавить в карточку клиента AmoCRM примечание с суммой, датой и invoice_id — для аудита.

Сценарий 3: Кастомная ERP или собственная система

Если у вас кастомная система учёта, интернет-магазин или платформа — интеграция через AiPay API даёт полный контроль.

Минимальный набор:

  1. Авторизация: Bearer-токен в заголовке каждого запроса
  2. Создание счёта: POST /invoices — возвращает invoice_id и ссылку на оплату
  3. Получение webhook: ваш endpoint обрабатывает POST-запрос, верифицирует HMAC, обновляет статус в БД
  4. Фискальный чек: генерируется автоматически, доступен через API

Idempotency: при повторной отправке одного и того же idempotency_key AiPay вернёт уже существующий счёт — без дублирования. Критично для retry-логики.

Пример кода: webhook-обработчик на Python Flask

Это — минимальный обработчик. Принимает POST от AiPay, верифицирует 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, которые подключаются к Битрикс24 через стандартный REST API CRM за несколько часов.

Что происходит, если клиент не оплатил?

AiPay присваивает счёту статус expired после истечения времени (настраивается). Webhook с этим статусом приходит на ваш endpoint — и вы можете автоматически перевести сделку в CRM в статус «Счёт просрочен» или запустить повторный сценарий (например, отправить новый счёт или уведомление менеджеру).

Сколько стоит?

₸25 000 в месяц за терминал. Первые 7 дней — бесплатно, без карты. Для большинства бизнесов с 20+ сделками в день AiPay окупается за 2–3 рабочих дня за счёт сэкономленного времени менеджеров.

Если ваш бизнес принимает оплаты через Kaspi Pay и менеджеры до сих пор сверяют скриншоты вручную — это можно исправить сегодня.

Подключение занимает около 1 часа. Первые 7 дней — бесплатно. Интеграция с Битрикс24, AmoCRM или вашей системой — через единый API.

Попробовать AiPay бесплатно →

Готовы автоматизировать Kaspi Pay?

Подключитесь за 1 час. 7 дней бесплатно.

Попробовать AiPay бесплатно