# Stripe * [Как подключить](#podklyuchenie) * [Как получить ссылку на оплату](#kak-poluchit-ssylku-na-oplatu) * [Как обработать результат](#kak-obrabotat-rezultat) * [Как настроить рекурентные платежи](#kak-nastroit-rekurentnye-platezhi) * [Как тестировать платежи](#kak-testirovat-platezhi) ## Как подключить Для подключения платежной системы Stripe вам потребуется секретный API-ключ и ключ webhook. Секретный API-ключ можно скопировать перейдя в раздел Developers -> API key и копируем Secret key. Шаг 1. Переходим в раздел Developers -> API key:

Шаг 2. Находим и копируем Secret key:

Дальше нужно установить URL-адрес для колбэков. Это необходимо для того, чтобы бот получал уведомления об оплате. Переходим в раздел Webhooks и добавляем адрес для вебхуков.

Откроется форма:

Шаг 1. Нажимаем на "+add destination". Шаг 2. Выбираем events:

Шаг 3. Выбираем тип "Webhook endpoint":

Шаг 4. Ознакамливаемся с типом запроса и кликаем "Продолжить":

Шаг 5. Прописываем название и указываем URL endpoint:

URL указываем - Шаг 6. Будет создано два эндпоинта, можно посмотреть настройки перед добавлением:

Шаг 7. Далее нажмите кнопку "Add destinations". Тогда вебхуки будут сохранены. Шаг 8. Нажмите кнопку "Done".

Сохраняем и попадаем на страницу с установленным вебхуком:

Шаг 9. Далее нажимаем на вебхук, в котором вы выбрали все ивенты:

Шаг 10. Находим Signig key и сохраняем его себе (в дальнейшем он понадобится для подключения к Salebot):

После получения ключей переходим к подключению в Salebot. В salebot открываем раздел "Эквайринг", выбираем Stripe.

На странице подключения, нужно ввести полученные ключи:

Нажмите "Сохранить настройки". {% hint style="success" %} Готово! На этом подключение платежной системы окончено! {% endhint %} ## Как подключить колбек о статусе транзакции Для получения дополнительного колбека нам потребуется подключить вебхук **дополнительно к имеющемуся.** URL указываем - [https://chatter.salebot.pro/stripe\_callback/\/charge\_status](https://chatter.salebot.pro/stripe_callback//charge_status) и выбираем события: * `charge.failed` * `charge.pending` * `charge.succeeded`

{% hint style="success" %} **Подробнее о каждом из типов вебхука:** 1. **charge.succeeded** - содержит информацию об успешном завершении транзакции (аналогичен колбеку об успешной оплате) 2. **charge.pending** - "транзакция выполняется", на выполнение может уйти до 7 дней. \ Вебхук будет иметь вид {первые 10 символов }*{тип вебхука}* \ Например: *sk\_test\_45LDPJLKT95d\_charge.pending* 3. **charge.failed** *- "транзакция провалилась".* \ *Вебхук будет иметь вид {первые 10 символов }*{тип вебхука} \ Например: *sk\_test\_45LDPJLKT95d\_charge.failed* {% endhint %} Полученный после сохранения вебхук добавляем в Salebot поле - Webhook key2:

**stripe\_invoice\_id** - идентификатор сделки, по которой не пришел колбек об успешной оплате сразу после платежа ## Как подключить налоги Для использования налогов в платежах нужно сперва создать их в личном кабинете Stripe. Для этого введите в поисковой строке tax rates:

И нажмите "+ Add tax rates":

Далее указываем применяемую налоговую ставку:

В открывшемся меню выберите тип налога, регион, для которого он применяется, процентную ставку и признак - будет этот налог включен в сумму платежа Inclusive или будет добавлен сверх суммы - exclusive:

После создания налоговой ставки скопируйте его id в переменную **stripe\_tax\_id** до объявления суммы платежа.

Во избежание ошибок желательно после получения ссылки в переменную stripe\_tax\_id поместить пустую строку (""), так вы сможете применять налог только тогда, когда он нужен Если все сделать правильно, то в случае с налоговой ставкой с параметром exclusive Вы увидите следующее

Пример платежа с налоговой ставкой типа exclusive

## **Как получить ссылку на оплату** Для генерации ссылки на оплату вам необходимо установить значение переменной **payment\_sum** (например 150 или 100.55 (через точку!)), сразу после этого появится переменная stripe\_pay\_url. Эту переменную можно вывести на экран ссылкой или разместить на кнопке с текстом "Оплатить". Ссылка имеет вид: `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	описание заказа
stripe_tax_id	идентификатор налоговой ставки, настроенной в личном кабинете Stripe. Как настроить, рассказали в параграфе "Как подключить налоги"
stripe_invoice_enable	признак необходимости сохранять инвойсы (счет-фактуры, чеки). Укажите любое значение, тогда все необходимое Вы найдете в личном кабинете Stripe
stripe_locale	установить язык страницы оплаты: en, ru, de. Все доступные: https://stripe.com/docs/api/checkout/sessions/create#create_checkout_session-locale Если не передано значение stripe_locale, то будет использован язык браузера клиента.
stripe_payment_method_type	метод оплаты, по умолчанию стоит оплата картой (card). Можно заменить на другие доступные для Stripe методы оплаты. Ниже указаны доступные методы. Например, `stripe_payment_method_type = "customer_balance"`
stripe_additional_payment_method_type	добавить дополнительный метод оплаты. Ниже указаны доступные методыНапример, `stripe_additional_payment_method_type = "sepa_debit"`
coupon_id	идентификатор купона скидки
stripe_expired	время жизни ссылки на оплату. Указывается в секундах. Минимальное время 30 минут, максимальное - 24 часа. По умолчанию 24 часа
stripe_automatic_tax	включение автоматического расчета и сбора налогов при оплате. Для включения передать "1". Подробная информация об этой настройке в документации Stripe

{% hint style="warning" %} Важно! Если используете обе переменные ***stripe\_payment\_method\_type** и **stripe\_additional\_payment\_method\_type, то значения в них ОБЯЗАТЕЛЬНО должны быть РАЗНЫМИ!*** {% endhint %}

Список значений для stripe_payment_method_type и stripe_additional_payment_method_type

card\ acss\_debit\ affirm \ afterpay\_clearpay \ alipay\ au\_becs\_debit \ bacs\_debit \ bancontact \ blik \ boleto \ cashapp \ customer\_balance \ eps \ fpx \ giropay \ grabpay \ ideal \ klarna \ konbini \ link \ oxxo \ p24 \ paynow \ paypal \ pix \ promptpay \ sepa\_debit \ sofort \ us\_bank\_account \ wechat\_pay zip

Подробнее про каждый из методов и для каких стран они доступны можно узнать в документации Stripe: [посмотреть на сайте ](https://stripe.com/docs/api/payment_methods/object#payment_method_object-type) ### **Пример формирования ссылки на оплату** Создадим ссылку на оплату в размере 1000 рублей (по умолчанию доллар)

{% hint style="warning" %} **Обратите внимание:** \ \- Сначала указываете необязательные параметры **first\_name, payment\_description** и т.д.\ \- И последней присваиваем значение переменной **payment\_sum** Переменные можно задать и ранее в цепочке, а не в одном блоке, это пример. {% endhint %} Далее в нужном месте выводим переменную **stripe\_pay\_url**, в которой содержится ссылка в блоке либо в кнопке: Пример 1. Выводим ссылку на оплату прямо в сообщении:

Тестирование в боте:

Пример 2. Добавляем ссылку на оплату в кнопку:

Пример 3. Добавляем ссылку в качестве вложения к сообщению:

Тестирование в боте:

{% hint style="success" %} Допустимы все три варианта для направления ссылки на оплату в боте. {% endhint %} При клике на кнопку или при переходе по ссылке, вашего плательщика переадресует на платежную страницу:

В примере видно, что параметры, которые мы указывали в калькуляторе в настройках блока были применены: описание заказа, валюта и сумма. Если передадите параметр налоговой ставки (**stripe\_tax\_id)** в блоке:

То также будет отображена налоговая ставка в форме оплаты:

Пример кода для копирования

`payment_description = 'Тестовая оплата в Страйп'` \ `currency = 'RUB'` \ `stripe_tax_id = 'скопируйте сюда ваш tax ID'` \ `payment_sum = 1000` Где найти tax ID:

## **Как настроить рекуррентные платежи** Для рекуррентных платежей (подписки) нужно до объявления переменной **payment\_sum** объявить переменную **stripe\_subscription** и присвоить ей название подписки. Также можно добавить следующие переменные: \ **interval** – продолжительность интервала подписки, в эту переменную нужно передать значение **‘day’** - для дней, **‘week’** - недель, **‘month’** - месяцев, **‘year’** - лет. \ Если переменная не объявлена, то ***по умолчанию*** будет передан параметр **‘month’.** {% hint style="warning" %} **Важно!** Продолжительность одного цикла подписки не может быть более 1 года (для параметра ‘year’), более 12 месяцев (для параметра ‘month’), более 52 недель (для параметра ‘week’). {% endhint %}

**interval\_count** – количество указанных интервалов, сколько дней, недель или месяцев будет в подписке за указанную сумму. ***По умолчанию*** будет передан параметр, равный единице (**1**); **stripe\_payment\_method\_type** - метод оплаты, по умолчанию стоит оплата картой (card). Можно заменить на другие доступные для Stripe методы оплаты. Ниже указаны доступные методы. Например, `stripe_payment_method_type = 'customer_balance'` **stripe\_additional\_payment\_method\_type** - добавить дополнительный метод оплаты. Ниже указаны доступные методы Например, `stripe_additional_payment_method_type = 'sepa_debit'` {% hint style="warning" %} Важно! Если используете обе переменные ***stripe\_payment\_method\_type** и **stripe\_additional\_payment\_method\_type, то значения в них ОБЯЗАТЕЛЬНО должны быть РАЗНЫМИ!*** {% endhint %}

Список значений для stripe_payment_method_type и stripe_additional_payment_method_type:

{% hint style="info" %} Подробнее про каждый из методов и для каких стран они доступны можно узнать в документации Stripe: [посмотреть на сайте ](https://stripe.com/docs/api/payment_methods/object#payment_method_object-type) {% endhint %} {% hint style="warning" %} **Важно!** Продолжительность подписки не может быть более 1 года (для параметра ‘year’), более 12 месяцев (для параметра ‘month’), более 52 недель (для параметра ‘week’). {% endhint %} В данном примере подписка с названием 'My\_subscription' будет создана с ценой 90 USD за 1 месяц и повторный платеж будет проведен с той же суммой по истечении 1 месяца:

Пример для копирования: `stripe_subscription = 'My_subscription'` \ `interval = 'month'` \ `payment_sum = 90` Чтобы списывать платеж по подписке один раз в два, три, четыре месяца, передайте параметр interval\_count: `stripe_subscription = 'My_subscription'` `interval = 'month'` **`interval_count = 3`** `payment_sum = 90` Чтобы изменить интервал для оплаты подписки с месяца на неделю, то передайте в параметре interval слово week: `stripe_subscription = 'My_subscription'` **`interval = 'week'`** `interval_count = 3` `payment_sum = 90` После оплаты в переменных сделки у клиента появится переменные stripe\_subscription\_id, которая потребуется для настройки отмены подписки, и stripe\_customer\_id, которую в дальнейшем можно использовать для проверки статуса подписки. {% hint style="warning" %} Уведомление(колбэк) приходит только при первом рекуррентном платеже! На повторные коллбэка НЕ БУДЕТ. Контроль идет [через функцию](#proverka-statusa-podpiski) и stripe\_customer\_id. {% endhint %}

### Настройки для возврата к обычным платежам Для возврата к обычным платежам присвойте переменной subscription пустую строку **stripe\_subscription = ''**. В таком случае переменные interval и interval\_count не повлияют на создание ссылки

### **Настройки для отмены подписки** Для отмены подписки в калькуляторе используйте метод **stripe\_remove\_subscription(stripe\_subscription\_id)**, где **stripe\_subscription\_id** – идентификатор, который был сохранен в переменных о сделке после оплаты. Это позволит оставить оплаченную подписку активной до конца текущего оплаченного срока, но дальнейшие списания не произойдут, и по истечении срока подписка будет отменена:

answer = stripe\_remove\_subscription('#{stripe\_subscription\_id}') stripe\_remove\_subscription - в случае успеха придет ответ с информацией до какого числа будет действовать отмененная подписка В данном примере результат выполнения функции будет помещен в переменную answer и можно будет проверить результат выполнения. ### Проверка статуса подписки **stripe\_check\_subscription(subscription\_id, customer\_id)**, где **stripe\_subscription\_id** - идентификатор подписки \ **stripe\_customer\_id** - идентификатор клиента в Stripe (необязательный параметр)

## Как создать купон и получить ID скидки Для получения идентификатора скидки создайте купон в личном кабинете в разделе ”[coupons](https://dashboard.stripe.com/coupons)”.

При нажатии кнопки “New” откроется страница, где нужно указать: 1. Name — название скидки; 2. ID — идентификатор, генерируется автоматически, 3. Type — вид скидки: в процентах или фиксированная сумма 4. Duration — длительность скидки (разовая или продолжительная, например, для подписок) и другие параметры.

Купон со скидкой появится в каталоге “Product catalogue“ в разделе “Coupons”, а ID скидки вы можете посмотреть, зайдя в меню купона:

Нажмите на купон, чтобы скопировать ID купона:

### Как добавить скидку в заказ 1. При генерации ссылки на оплату (работает как для подписок, так и для разовых платежей). В калькуляторе блока до объявления переменной **payment\_sum** задайте переменную **coupon\_id**, передав в неё идентификатор скидки из личного кабинета stripe.

2. В существующую подписку с помощью функции **stripe\_add\_subscription\_discount.** Задайте условия для срабатывания блока и в калькуляторе вызовите указанную функцию, передав в нее параметры stripe\_subscription\_id (id подписки) и coupon\_id (id купона на скидку). Скидка будет применена для последующих платежей по подписке.

Пример кода для копирования

`stripe_subscription = 'Подписка премиум'` \ `interval = 'month'` \ `payment_description = 'Тестовая оплата в Страйп'` \ `currency = 'USD'` \ `coupon_id = 'ID вашего купона'` \ `stripe_add_subscription_discount(stripe_subscription_id, coupon_id)` \ `stripe_tax_id = 'ID налога'` \ `payment_sum = 90`

При успешном добавлении функция вернёт сообщение с указанием id подписки, вида, суммы или процента скидки, а также срока её действия.

{% hint style="info" %} Подробнее о создании подписки расказали в разделе "[Как настроить рекуррентные платежи](#kak-nastroit-rekurrentnye-platezhi)" {% endhint %} ### Как удалить/изменить скидку для подписки Прикрепленную к подписке скидку можно удалить или заменить другой скидкой. Если вы хотите прекратить действие скидки, задайте условие для срабатывания блока и в калькуляторе вызовите функцию **stripe\_remove\_subscription\_discount**, передав в неё параметр **stripe\_subscrition\_id** (id подписки).

При успешном выполнении операции функция вернёт сообщение, содержащее id подписки и дату отмены скидки. Замена скидки, как и добавление новой, производится с помощью функции **stripe\_add\_subscription\_discount.** Не забудьте передать в нее параметры **stripe\_subscription\_id** и **coupon\_id**.\ Успешный запрос обновит прикрепленный к подписке купон и вернет сообщение с актуальными данными. {% hint style="info" %} Как получить идентификатор скидки, рассказали в разделе "[Как создать купон и получить ID скидки](#kak-sozdat-kupon-i-poluchit-id-skidki)". {% endhint %} ## **Как обработать результат** После успешной оплаты в бот придут колбэки, по которым вы сможете понять, что была успешная оплата. Эти колбеки в системе вы видите как сообщения от пользователя, чтобы их не мог отправить пользователь, они состоят из 20 первых символов секретного ключа и приписки success, например: **sk\_live\_d35gky6d8ers\_success**

Эти колбеки НЕ ВИДИТ пользователь, они отображаются только оператору. Тип сравнения должен быть **"Полное совпадение"** Также после успешной оплаты переменная **stripe\_payment\_completed** устанавливается в **True**. Например, можно сделать обработку успешной оплаты блоком с условием и вывести соответствующее сообщение пользователю:

После завершения оплаты клиенту добавится переменная **stripe\_callback\_data**, содержащая данные ответа платежной системы по совершенной операции. Из полученного словаря можно извлечь необходимые данные при помощи метода **get**. {% hint style="warning" %} Для совершения повторного платежа обязательно необходимо обнулить payment\_sum, ранее сформированную ссылку и уже после переназначить переменную payment\_sum для получения свежей ссылки. Можно указать предыдущее значение. {% endhint %} ## К**ак тестировать платежи** Для тестирования интеграции можете использовать секретный ключ из тестовой среды. Для этого в личном кабинете stripe меню справа, нужно переключиться в тестовую среду. ![](https://lh5.googleusercontent.com/r-tuJboMES8alkTUpKwA4HKrmL_epNtSXdENrv12EyR9dGCtvRLBK6qw4UGcr59GA3unxc1cV1otCu80nqHEw9VhbEK05ovPQ1Ad8chBv50LAWPO16nEPC2hFhCAsCe3khtBJrob=s0) Далее провести настройку описанную в начале этой инструкции. Ввести тестовый секретный ключ и добавить адрес для вебхуков в тестовую среду. Тестовый номер карты 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.salebot.pro/integration/payments/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.