Stripe
Як підключити
Щоб підключити платіжну систему Stripe, вам потрібні секретний API та ключ webhook.
Ви можете скопіювати секретний API-ключ у розділі Developers -> API key та скопіювати Secret key.
Далі потрібно вказати URL для Callbacks. Це необхідно, щоб бот отримував сповіщення про платежі.
Перейдіть у розділ Webhooks і додайте адресу для webhooks.
вкажіть URL: https://chatter.salebot.pro/stripe_callback/result
та виберіть подію:
checkout.session.completed
Збережіть і перейдіть на сторінку з установленим webhook, скопіюйте ключ webhook (Signing secret) (у полі salebot — Webhook key):
після натискання Reveal key відкриється Webhook, який починатиметься з whsec_...
Після отримання ключів перейдемо до налаштувань у Salebot.
У salebot відкрийте розділ платіжних систем, виберіть Stripe. На сторінці підключення потрібно ввести отримані дані.
Як отримати посилання на оплату
Щоб згенерувати посилання на оплату, потрібно задати значення змінної payment_sum (наприклад, 150 або 100.55 (через крапку!)), після чого з’являється змінна stripe_pay_url. Цю змінну можна вивести у вигляді посилання або розмістити на кнопці з текстом "Pay".
Посилання має такий вигляд:
https://checkout.stripe.com/pay/cs_test_a17mskKFFRwEuo3WgBSAUjfk7xaZZIrct9B3Ds2AdODVq1I8aRiqYEBdrU#fidkdWxOYHwnPyd1blpxYHZxWjA0TGFsVzFPVmpmMzJAbVYzUkp1Y0lLYDVgfzR2Q0NxcWZBNUNnTnRSVVRJSGFobEB1UExSczRMMTc8PWRLMGBddl8xalxyPDRoUGhnZm9xXXZANDZyaF0wNTVBVExsPHZyfycpJ2N3amhWYHdzYHcnP3F3cGApJ2lkfGpwcVF8dWAnPyd2bGtiaWBabHFgaCcpJ2BrZGdpYFVpZGZgbWppYWB3dic%2FcXdwYHgl
За замовчуванням встановлено USD (долар), якщо вам потрібна інша валюта, потрібно вказати значення змінної currency
Також перед встановленням значення payment_sum ви можете вказати такі необов’язкові змінні для налаштування платежу.
currency - валюта замовлення. Допустимі значення - https://stripe.com/docs/currencies
payment_description - опис замовлення
Приклад посилання на оплату
Створити посилання на оплату EUR 2 (долар за замовчуванням)
Зверніть увагу:
Спочатку вкажіть необов’язкові параметри first_name, payment_description тощо.
А в кінці присвойте значення змінної payment_sum
Зверніть увагу: спочатку ми задаємо додаткові змінні для налаштувань, потім payment_sum. Ви можете визначати змінні раніше в ланцюжку, не в одному блоці, це приклад.
Далі у потрібному місці ми виведемо змінну stripe_pay_url, яка містить посилання, у блоці або на кнопці
Сторінка прикладу оплати
Як обробити результат
Після успішної оплати в бот прийдуть callbacks, за якими можна зрозуміти, що платіж успішно відбувся. Ці callbacks у системі ви бачите як повідомлення від користувача, тому вони не можуть бути надіслані користувачем; вони складаються з перших 20 символів секретного ключа та success, наприклад: sk_live_d35gky6d8ers_success
Користувач ЦИХ callbacks НЕ БАЧИТЬ, вони відображаються лише оператору.
Тип порівняння має бути "Full match"
Також після успішної оплати змінна stripe_payment_completed встановлюється в True.
Наприклад, ви можете зробити блок успішної обробки платежу з умовою та вивести відповідне повідомлення користувачу:
Після завершення платежу до клієнта буде додано змінну stripe_callback_data, яка містить дані відповіді платіжної системи щодо завершеної транзакції. Ви можете витягнути потрібні дані зі словника за допомогою методу get.
Щоб здійснити повторну оплату, потрібно скинути payment_sum, раніше згенероване посилання, а після скидання змінної payment_sum отримати нове посилання. Ви можете вказати попереднє значення.
Як тестувати платежі
Для тестування інтеграції можна використовувати секретний ключ із тестового середовища. Для цього в особистому кабінеті в меню stripe праворуч потрібно переключитися на тестове середовище.
Далі налаштуйте конфігурацію, описану на початку цієї інструкції. Введіть тестовий секретний ключ і додайте адресу для webhooks до тестового середовища.
Номер тестової картки
4242 4242 4242 4242
будь-яка майбутня дата
CVC - будь-які три цифри
Якщо щось не працює, порівняйте дані з даними на офіційному сайті: https:/stripe.com/docs/testing#regulatory-cards
Last updated