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

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

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

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

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

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

2. Разделите PDF и ссылку

Из блока с просьбой проведите две стрелки к двум новым блокам:

  • «Проверка PDF» — стрелка с условием attachment_message (тип «Полное совпадение»). По ней бот пойдёт, если покупатель прислал файл. Ссылка на файл окажется в переменной #{attachment_url}.
  • «Проверка ссылки» — стрелка на любое текстовое сообщение. Текст покупателя будет в переменной #{question}.

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

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

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

Поле «JSON параметры» в блоке «Проверка PDF»:

{
  "fileUrl": "#{attachment_url}",
  "userId": "#{platform_id}",
  "purchaseId": "#{platform_id}-kurs",
  "expectedAmount": "24900"
}

В блоке «Проверка ссылки» — то же самое, но вместо fileUrl передайте "receiptUrl": "#{question}".

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

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

Из каждого блока проверки проведите две стрелки:

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

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

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

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

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

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

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