# Stripe * [Як підключити ](#how-to-connect) * [Як отримати посилання на оплату ](#how-to-get-a-link-to-payment) * [Як обробити результат ](#how-to-process-the-result) * [Як тестувати платежі](#how-to-test-payments) ## Як підключити Щоб підключити платіжну систему Stripe, вам потрібні секретний API та ключ webhook. Ви можете скопіювати секретний API-ключ у розділі Developers -> API key та скопіювати Secret key. ![](/files/535cc6a4b8102c316d152f0c9533e76821ecdbe2) Далі потрібно вказати URL для Callbacks. Це необхідно, щоб бот отримував сповіщення про платежі. Перейдіть у розділ Webhooks і додайте адресу для webhooks. ![](/files/4b97366422c07514e138f964b16b690171bc86dc) вкажіть URL: та виберіть подію: `checkout.session.completed` ![](/files/60aa9b4415860c9cb07151de931ca9438fbdedc7) Збережіть і перейдіть на сторінку з установленим webhook, скопіюйте ключ webhook (Signing secret) (у полі salebot — Webhook key): \ після натискання Reveal key відкриється Webhook, який починатиметься з whsec\_... ![](/files/f24f1f4766c400fa41a673b0c400eb1a933e460f) Після отримання ключів перейдемо до налаштувань у Salebot. У salebot відкрийте розділ платіжних систем, виберіть Stripe. На сторінці підключення потрібно ввести отримані дані. ![](/files/4a063c236ef007206dbd22f39e1e99925d9e3d57) ![](/files/dc87961be1c589df277e0df0b075fc35b30bae0d) ## Як отримати посилання на оплату Щоб згенерувати посилання на оплату, потрібно задати значення змінної payment\_sum (наприклад, 150 або 100.55 (через крапку!)), після чого з’являється змінна stripe\_pay\_url. Цю змінну можна вивести у вигляді посилання або розмістити на кнопці з текстом "Pay". Посилання має такий вигляд: `https://checkout.stripe.com/pay/cs_test_a17mskKFFRwEuo3WgBSAUjfk7xaZZIrct9B3Ds2AdODVq1I8aRiqYEBdrU#fidkdWxOYHwnPyd1blpxYHZxWjA0TGFsVzFPVmpmMzJAbVYzUkp1Y0lLYDVgfzR2Q0NxcWZBNUNnTnRSVVRJSGFobEB1UExSczRMMTc8PWRLMGBddl8xalxyPDRoUGhnZm9xXXZANDZyaF0wNTVBVExsPHZyfycpJ2N3amhWYHdzYHcnP3F3cGApJ2lkfGpwcVF8dWAnPyd2bGtiaWBabHFgaCcpJ2BrZGdpYFVpZGZgbWppYWB3dic%2FcXdwYHgl` {% hint style="warning" %} За замовчуванням встановлено USD (долар), якщо вам потрібна інша валюта, потрібно вказати значення змінної currency {% endhint %} Також перед встановленням значення payment\_sum ви можете вказати такі необов’язкові змінні для налаштування платежу. currency - валюта замовлення. Допустимі значення - [https://stripe.com/docs/currencies ]() payment\_description - опис замовлення ### Приклад посилання на оплату Створити посилання на оплату EUR 2 (долар за замовчуванням) ![](/files/454b80383d46c54ccc5a9d1ba9401f9969eca556) {% hint style="info" %} Зверніть увагу: * Спочатку вкажіть необов’язкові параметри first\_name, payment\_description тощо. * А в кінці присвойте значення змінної payment\_sum {% endhint %} Зверніть увагу: спочатку ми задаємо додаткові змінні для налаштувань, потім payment\_sum. Ви можете визначати змінні раніше в ланцюжку, не в одному блоці, це приклад. Далі у потрібному місці ми виведемо змінну stripe\_pay\_url, яка містить посилання, у блоці або на кнопці ![](/files/101296733e34d01bd58f4bf4a85c0015e8a36762) Сторінка прикладу оплати ![](/files/7de8e5170f6284e89c3e275cc27eaff4cfb22ae8) ## Як обробити результат Після успішної оплати в бот прийдуть callbacks, за якими можна зрозуміти, що платіж успішно відбувся. Ці callbacks у системі ви бачите як повідомлення від користувача, тому вони не можуть бути надіслані користувачем; вони складаються з перших 20 символів секретного ключа та success, наприклад: sk\_live\_d35gky6d8ers\_success Користувач ЦИХ callbacks НЕ БАЧИТЬ, вони відображаються лише оператору. Тип порівняння має бути "Full match" Також після успішної оплати змінна stripe\_payment\_completed встановлюється в True. Наприклад, ви можете зробити блок успішної обробки платежу з умовою та вивести відповідне повідомлення користувачу: ![](/files/159d83034e74cd42e814ec0cd02d73e412a84fee) Після завершення платежу до клієнта буде додано змінну stripe\_callback\_data, яка містить дані відповіді платіжної системи щодо завершеної транзакції. Ви можете витягнути потрібні дані зі словника за допомогою методу get. {% hint style="warning" %} Щоб здійснити повторну оплату, потрібно скинути payment\_sum, раніше згенероване посилання, а після скидання змінної payment\_sum отримати нове посилання. Ви можете вказати попереднє значення. {% endhint %} ## Як тестувати платежі Для тестування інтеграції можна використовувати секретний ключ із тестового середовища. Для цього в особистому кабінеті в меню stripe праворуч потрібно переключитися на тестове середовище. ![](/files/656fbc7af3c16952bbe770216a41a79b0b597e1a) Далі налаштуйте конфігурацію, описану на початку цієї інструкції. Введіть тестовий секретний ключ і додайте адресу для webhooks до тестового середовища. Номер тестової картки 4242 4242 4242 4242 будь-яка майбутня дата CVC - будь-які три цифри Якщо щось не працює, порівняйте дані з даними на офіційному сайті: https\:/stripe.com/docs/testing#regulatory-cards --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/uk/integrations/payment/stripe.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.