Интеграции · Salebot
Проверка оплаты Kaspi в Salebot
Покупатель присылает боту PDF-чек или ссылку на чек из приложения Kaspi — Salebot отправляет его в Tolemflow и по ответу выдаёт товар или объясняет, что не так. Без кода, за 15 минут.
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.
4. Выдайте товар или объясните отказ
Из каждого блока проверки проведите две стрелки:
- с условием
"#{success}" == "True"— к блоку, который выдаёт товар: ссылку на курс, ключ, приглашение в канал; - без условия (или с обратным) — к блоку с текстом
#{message}и просьбой прислать другой чек.
В message Tolemflow пишет понятную покупателю причину: «Этот чек уже был использован ранее», «Неверная сумма платежа», «Принимаем только PDF-чек из приложения Kaspi».
5. Проверьте на себе
Оплатите товар самому себе на небольшую сумму и пришлите чек боту. Результат появится в кабинете Tolemflow в разделе «Чеки» — там видно каждую проверку и причину отказа. Пришлите тот же чек второй раз: бот должен ответить, что чек уже использован.
success не срабатывает — напишите нам, поможем подключить.