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

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

Покупатель присылает боту PDF-чек из приложения Kaspi — Salebot отправляет его в Tolemflow и по ответу выдаёт товар или объясняет, что не так. Без кода, за 15 минут.

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

1. Попросите чек

В блоке, где бот называет цену, добавьте просьбу: «Оплатите через Kaspi и пришлите сюда PDF-чек из приложения Kaspi». Скриншоты Tolemflow не принимает — их слишком легко подделать, поэтому лучше сразу сказать об этом покупателю.

2. Добавьте блок проверки

Из блока с просьбой проведите стрелку к новому блоку «Проверка чека» с условием attachment_message (тип «Полное совпадение»). По ней бот пойдёт, когда покупатель пришлёт файл, а ссылка на файл окажется в переменной #{attachment_url}.

Если покупатель вместо файла напишет текст, пусть вторая стрелка без условия ведёт к сообщению «Пришлите, пожалуйста, PDF-чек файлом из приложения Kaspi».

3. Настройте API-запрос

В блоке «Проверка чека» откройте вкладку «API-запрос» и заполните поля:

ПолеЗначение
Тип запросаPOST-json
URL запросаhttps://tolemflow.kz/api/receipts/validate?always200=1
Заголовок запроса{"X-API-Key": "ваш_ключ_Tolemflow"}
Разбор ответа (в старом интерфейсе — «Сохраняемые значения»)success = custom_answer['success']
message = custom_answer['message']

Поле «JSON параметры»:

{
  "fileUrl": "#{attachment_url}",
  "userId": "#{platform_id}",
  "purchaseId": "#{platform_id}-kurs",
  "expectedAmount": "24900"
}
  • expectedAmount — цена товара в тенге. Чек на другую сумму не пройдёт. Можно передать строкой, как в примере.
  • userId и purchaseId — кто и что купил: так проще разбирать спорные случаи в кабинете Tolemflow.
  • Параметр ?always200=1 в адресе нужен, чтобы Salebot получил ответ и при отказе: причина отказа придёт в message.
Ключ Tolemflow храните только в настройках блока. Не отправляйте его в сообщениях бота и не публикуйте скриншоты с ним.

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

Из блока «Проверка чека» проведите две стрелки:

  • с условием "#{success}" == "True" — к блоку, который выдаёт товар: ссылку на курс, ключ, приглашение в канал;
  • без условия (или с обратным) — к блоку с текстом #{message} и просьбой прислать другой чек.

В message Tolemflow пишет понятную покупателю причину: «Этот чек уже был использован ранее», «Неверная сумма платежа», «Принимаем только PDF-чек из приложения Kaspi».

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

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

Если тот же покупатель пришлёт тот же чек по тому же заказу ещё раз в течение 15 минут, бот получит отказ «Этот чек уже засчитан по этому заказу» — товар второй раз не выдаётся, а проверка не списывается.

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

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

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