Интеграции · BotHelp

Проверка оплаты Kaspi в BotHelp

Покупатель присылает ссылку на чек из приложения Kaspi, BotHelp отправляет её в Tolemflow и по ответу выдаёт товар или объясняет, что не так. Без кода.

Что понадобится. API-ключ Tolemflow — он появится сразу после регистрации (50 проверок в месяц бесплатно). В BotHelp «Внешний запрос» доступен на всех тарифах.

1. Попросите ссылку на чек

Добавьте шаг «Сообщение» с блоком «Вопрос»: «Оплатите через Kaspi и пришлите сюда ссылку на чек из приложения Kaspi». Ответ сохраните в новое текстовое поле receipt_url.

2. Настройте внешний запрос

Добавьте шаг «Действие» → «Внешний запрос» и заполните:

ПолеЗначение
Тип запросаPOST
URL-адресhttps://tolemflow.kz/api/receipts/validate-url?always200=1
ЗаголовкиContent-Type: application/json
X-API-Key: ваш ключ Tolemflow

Тело:

{
  "receiptUrl": "{%receipt_url%}",
  "userId": "{%bh_user_id%}",
  "purchaseId": "{%bh_user_id%}-kurs",
  "expectedAmount": "24900"
}

На вкладке «Сопоставление ответов» добавьте два сопоставления:

  • $.success → текстовое поле tf_success;
  • $.message → текстовое поле tf_message.
  • expectedAmount — цена товара в тенге: чек на другую сумму не пройдёт.
  • ?always200=1 в адресе нужен, чтобы BotHelp получил ответ и при отказе: причина придёт в message.

3. Выдайте товар или объясните отказ

Добавьте шаг «Условие» по текстовому полю tf_success:

  • «Соответствует» true — к шагу, который выдаёт товар;
  • иначе — к сообщению с текстом {%tf_message%} и просьбой прислать другой чек.

4. Проверьте на себе

На вкладке «Ответ» внешнего запроса можно отправить тестовый запрос — ответ Tolemflow появится там же. Затем оплатите товар самому себе на небольшую сумму и пришлите ссылку на чек боту: проверка появится в кабинете Tolemflow в разделе «Чеки».

А если покупатель присылает PDF?

В BotHelp нет документированного способа передать присланный файл во внешний запрос, поэтому для ботов на BotHelp просите у покупателя ссылку на чек. Tolemflow проверяет её так же надёжно, как PDF.

Инструкция составлена по документации BotHelp. Если в вашем интерфейсе что-то называется иначе — напишите нам, поможем подключить.

Получите ключ и подключите BotHelp сегодня

50 проверок в месяц бесплатно, без карты.