Если вы собираете продажи в n8n, обычно хочется простого сценария: заказ пришел из формы, CRM, Telegram или Google Sheets, клиент получил способ оплаты, после оплаты заказ автоматически стал “оплачен”. Без отдельного бэкенд-проекта и без ручной проверки скриншотов.
xpayment дает для этого платежный API-слой. Вы подключаете отдельного Kaspi Pay кассира, получаете API-ключ устройства xdev_..., а затем n8n создает платежи через обычный узел HTTP Request.
Как это работает
Заказ в n8n -> запрос в xpayment -> платеж в Kaspi Pay -> webhook -> обновление CRM/таблицы/Telegram
Сначала в Kaspi Pay создается отдельный кассир с ограниченными правами. В xpayment он подключается как устройство или виртуальный кассир. После этого xpayment выдает API-ключ, который n8n использует для серверных запросов.
Ключ xdev_... нужно хранить в учетных данных n8n или переменных окружения. Не вставляйте его в публичные шаблоны сценариев, скриншоты или фронтенд.
Два основных сценария
Платежная ссылка для QR или deeplink. n8n получает заказ, отправляет сумму и merchant_order_id в xpayment, получает qr_token и отправляет клиенту ссылку или показывает QR-код.
Платеж по номеру телефона. Если CRM или форма уже знает телефон клиента, n8n отправляет payer_phone, сумму и ID заказа. Клиент получает запрос на оплату в Kaspi.
В обоих случаях заказ нельзя считать оплаченным сразу после создания платежа. Правильная логика такая:
создать заказ -> создать платеж -> сохранить payment_id -> дождаться webhook -> обновить заказ
Минимально стоит обработать три события:
| Событие | Что делать |
|---|---|
payment.completed |
Обновить заказ до статуса “оплачен” |
payment.cancelled |
Отметить платеж как отмененный |
payment.failed |
Попросить клиента попробовать еще раз |
Когда это полезно
-
Google Sheets создает счет;
-
CRM переводит сделку на оплату;
-
Telegram-бот продает цифровой товар;
-
онлайн-школа открывает доступ после оплаты;
-
менеджер подтверждает заказ, а n8n отправляет клиенту способ оплаты.
Такая схема помогает быстро убрать ручные скриншоты, сообщения менеджеру и хаос со статусами заказов.
Проверить продукт можно на сайте xpayment, а технические эндпоинты посмотреть в документации xpayment API.
