# TipTop pay

## Как настроить Cloudpayments

Для подключения CloudPayments Вам понадобятся **Public ID** и **Пароль** для API.

Эти данные можно получить в личном кабинете в разделе "Сайты"

<figure><img src="/files/xd73kiUM8j5ZhZfG6gbm" alt=""><figcaption><p>Раздел "Сайты" CloudPayments</p></figcaption></figure>

Для того чтобы бот получал уведомления об оплате, также необходимо установить **callback\_url**. Для этого в разделе "Сайты" CloudPayments открываем вкладку уведомления:

<figure><img src="/files/ZFxtaNl2L5tifgdo2Vvx" alt=""><figcaption><p>Вкладка "Уведомления" в разделе "Сайты" CloudPayments</p></figcaption></figure>

Немного ниже в строке Pay и Recurrent (**ВАЖНО именно Pay и Recurrent** ) необходимо включить переключатель и установить:\
**Адрес:** <https://chatter.salebot.pro/cloudpayments\\_callback/result\\>
**Кодировка:** UTF-8\
**HTTP метод:** POST\
**Форма запроса:** CloudPayments

<figure><img src="/files/AitjXbRO4WyzyqdRUyUT" alt=""><figcaption><p>Настройка уведомлений</p></figcaption></figure>

## Как настроить Salebot.pro

Теперь переходим в конструктор. Два значения, о которых мы говорили выше (Public ID и Пароль для API), необходимо указать в форме ниже. Форма находится в разделе "Эквайринг"

<figure><img src="/files/dd4Rmx78QE12bn5rgnOV" alt=""><figcaption><p>Раздел "Эквайринг"</p></figcaption></figure>

<figure><img src="/files/YfBTCv1H30oDiE18ZTUb" alt="" width="563"><figcaption><p>Настройка CloudPayments </p></figcaption></figure>

На этом подключение закончено. Теперь давайте разберемся, как использовать данный функционал.

**поле Ставка НДС (обязательный).** **Не нужно передавать, если товар не облагается НДС**!\
Если же облагается, тогда передаем следующие значения:

<table><thead><tr><th width="268">Передаваемое значение</th><th>Что подразумевает значение</th></tr></thead><tbody><tr><td>0 </td><td>НДС 0%</td></tr><tr><td>10</td><td>НДС 10%</td></tr><tr><td>20</td><td>НДС 20%</td></tr><tr><td>110 </td><td>Расчетный НДС 10/110</td></tr><tr><td>120 </td><td>Расчетный НДС 20/120</td></tr><tr><td>12 </td><td>НДС 12% (только для онлайн-касс в Казахстане)</td></tr></tbody></table>

**поле Система налогообложения (необязательный, если у вас одна система налогообложения )**

<figure><img src="/files/qjjp8ClfEe745Mt8CF4y" alt=""><figcaption></figcaption></figure>

## Как сформировать ссылку на оплату

{% hint style="success" %}
Сформировать ссылку на оплату в блоке можно **ОДНИМ ИЗ** из доступных способов:

* [Кнопка с функцией Оплата](#knopka-s-funkciei-oplata)&#x20;
* [Функция `get_cloudpayments_payment_url` в Калькуляторе](#funkciya-get_cloudpayments_payment_url-v-kalkulyatore)
* [Создание ссылки с помощью переменной payment\_sum  и дополнительных параметров](#sozdanie-ssylki-s-pomoshyu-peremennoi-payment_sum-i-dopolnitelnykh-parametrov) (устаревшая работающая версия)
  {% endhint %}

## Кнопка с функцией Оплата

Ссылку на оплату можно создавать в кнопке с функцией "Оплата". О том как создавать такую кнопку  рассказано в этой статье:&#x20;

{% embed url="<https://docs.salebot.pro/osnovnye-ponyatiya.-kak-sozdavat-botov-na-salebot.pro/knopki#kak-sdelat-knopku-oplata>" %}
Статья про кнопку с функцией Оплата
{% endembed %}

Рассмотрим все возможные параметры данной кнопки.&#x20;

### **Обязательные параметры кнопки Оплата для** Cloudpayments&#x20;

Для формирования ссылки на оплату в настройках кнопки  необходимо указать  <mark style="color:green;">**обязательные параметры: Сумма  и Наименование товара.**</mark>

<figure><img src="/files/tVDHYleEfdXkuuzyBkFD" alt="" width="551"><figcaption></figcaption></figure>

**поле Сумма.**  В этом поле указываем стоимость товара в рублях

**поле Назначение платежа.** В этом поле указывается назначение платежа в свободной форме.

{% hint style="danger" %}
**НЕЛЬЗЯ** использовать **двойные кавычки** в Назначении платежа: удалите или замените на одинарные кавычки.&#x20;
{% endhint %}

**чекбокс Автоплатеж.** Для подключения автоплатежа нужно перейти в раздел "Эквайринг" → открыть настройки "CloudPayments"  и включить автоплатежи

<figure><img src="/files/CYzCgBQIEWobjVPYha2l" alt="" width="563"><figcaption></figcaption></figure>

**меню Данные для формирования чека.** При клике откроется выпадающее меню с параметрами для формирования чека:&#x20;

{% hint style="info" %}
Многие платежные системы поддерживают облачные онлайн-кассы, они необходимы по 54-ФЗ.\
Прочитайте особенности оформления чеков на сайте выбранной платежной системы, чтобы не попасть в неловкую ситуацию с налоговой инспекцией.
{% endhint %}

* Наименование товара или услуги
* Цена руб.
* Количество
* Итоговая цена
* Способ расчёта

**меню Дополнительная информация.** При клике откроется выпадающее меню для формирования ссылки:

* ФИО покупателя
* Переменная с email покупателя
* Переменная с номером телефона покупателя

**чекбокс С уведомление о клике.** Для отслеживания перехода по ссылке для оплаты можно поставить галочку. В таком случае, при клике по кнопке в диалог с клиентом в Сейлбот придет уведомление о том, что был совершен переход по ссылке

На данное уведомление можно настраивать дальнейшую логику работы бота.

### Дополнительные параметры для формирования чека и ссылки на оплату

#### меню "Данные для формирования чека" .&#x20;

При клике откроется выпадающее меню с параметрами для формирования чека:&#x20;

<figure><img src="/files/O3pgCCngP1yTnUs6XaF6" alt="" width="563"><figcaption></figcaption></figure>

**поле Наименование товара или услуги (обязательный).**  В данном поле нужно указать название товара (не более 128 символов). Чем точнее указано название товара, тем лучше.&#x20;

Например: не Телефон, а Смартфон Xiaomi модель ххх

{% hint style="danger" %}
**НЕЛЬЗЯ** использовать **двойные кавычки** в Наименовании товара: удалите или замените на одинарные кавычки.&#x20;
{% endhint %}

**поле Цена руб. (обязательный) .** В данном поле указывается цена в руб за единицу товара.&#x20;

**поле Количество (обязательный).** Количество или вес товара. Передать можно целое или дробное число через точку. Пример, 5 или 10.3

**поле Итоговая цена (обязательный).** В данном поле необходимо указать сумму к оплате с учетом  количества товаров.&#x20;

**поле Способ расчёта.** В этом поле передаем признак способа расчета(например, предоплата). \
Число от 0 до &#x37;**.** Список значений [можно посмотреть тут](https://developers.cloudkassir.ru/#method)

**поле Предмет расчёта.** В этом поле передаем признак предмета расчета(например, товар/услуга).\
Число от 0 до 34. Список значений [можно посмотреть тут](https://developers.cloudkassir.ru/#object)

**выпадающее меню "Дополнительная информация"**

При клике откроется выпадающее меню с дополнительными параметрами для формирования ссылки:&#x20;

<figure><img src="/files/xeGTNRbHGYTrPKMfWjIn" alt="" width="563"><figcaption></figcaption></figure>

**поле ФИО покупателя.** В этом поле указываем для юрлиц — название организации; для ИП и физического лица — ФИО.

{% hint style="info" %}
Если в названии юрлица есть кавычки их можно пропустить.&#x20;
{% endhint %}

**Поле Переменная с email покупателя** (необязательный, если передан Номер телефона) В данном поле указывается Email пользователя  (клиента). Можно указывать переменную, в которой хранится  email пользователя.&#x20;

Например, #{email}

**Поле Переменная с номером телефона покупателя** (необязательный, если передан Email). В данном поле можно указать переменную, в которой записан  номер телефона покупателя в формате 79000000000\
Например, #{phone}

### Переменные клиента, которые будут созданы автоматически при использовании кнопки с функцией Оплата

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

Служебная переменная клиента **`__payments`** , которая хранит сумму, идентификатор созданной ссылки, нужна для идентификации хука от платежной системы.

{% hint style="danger" %}
Служебную переменную клиента \_\_payments НЕЛЬЗЯ удалять или изменять!
{% endhint %}

Переменная клиента **`error_payment_button`** создается, если при формировании кнопки возникла ошибка.

В значение переменной error\_payment\_button запишется либо текст ошибки, либо ответ платежной системы с ошибкой.

{% hint style="warning" %}
Значение переменных становятся актуальными при переходе в следующий блок&#x20;
{% endhint %}

### Как обработать результат

**Успешный платеж.**

После успешной оплаты в бота <mark style="color:orange;">**АВТОМАТИЧЕСКИ**</mark> придет КОЛЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова \_success и через пробел сумма платежа. \
\&#xNAN;*Для использования в настройках схемы достаточно его скопировать.*&#x20;

Например: `ovg58keefc_success 44`, где:&#x20;

ovg58keefc : первые 10 символов секретного ключа платежной системы

\_success : результат обработки запроса (успешный платеж)

44 : сумма платежа

{% hint style="info" %}
Коллбэки (уведомления) от платежной системы пользователь НЕ ВИДИТ. Они отображаются только во вкладке Клиенты и видны оператору.
{% endhint %}

Пример использования:\
Шаг 1. В блоке "с кнопкой Оплата" добавляем кнопки с функцией Оплата.&#x20;

Шаг 2. В поле Условие соединения от этого блока к блоку "Успешная оплата" указываем коллбэк. Аналогично работает, если указать колбэк об успешной оплате в поле Условие блока "Стартовое условие".

{% hint style="warning" %}
Важно: выбор соответствия **Полное совпадение**  или **По наличию ключевых слов**: если используете **По наличию ключевых слов** в поле **Условие,** указывайте часть колбэка без суммы платежа:  10 символов секретного ключа\_\_success
{% endhint %}

<figure><img src="/files/IfXixfZ91nQrQdO9QGZL" alt=""><figcaption></figcaption></figure>

**Платеж с ошибкой**

<mark style="color:blue;">**При ошибке проведения оплаты**</mark> в бота <mark style="color:orange;">**АВТОМАТИЧЕСКИ**</mark> придет КОЛЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова \_fail и через пробел сумма платежа

Например, `ovg58keefc_fail 44` , где

`ovg58keefc` : 10 символов секретного ключа платежной системы

`_fail` : результат обработки запроса -  платеж не выполнен или с ошибкой.&#x20;

`44` : сумма платежа

{% hint style="warning" %}
Колбэк зависит от платежной системы: не все платежные системы присылают коллбэк об ошибке платежа.
{% endhint %}

Если сумма, указанная в настройках кнопки, <mark style="color:blue;">**отличается от суммы, которую клиент оплатил**</mark>, то <mark style="color:orange;">**АВТОМАТИЧЕСКИ**</mark> придет КОЛЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова \_different\_amounts и через пробел уникальный ID платежа

Например: `ovg58keefc_different_amounts 123456` , где:&#x20;

`ovg58keefc` : 10 символов секретного ключа платежной системы

`_different_amounts` : результат обработки запроса (сумма оплаты отличается от суммы в ссылке)

`123456` : уникальный ID платежа

## Функция get\_cloudpayments\_payment\_url в Калькуляторе

Для формирования ссылки на оплату можно воспользоваться функцией `get_cloudpayments_payment_url` в Калькуляторе блоке.

В поле Калькулятор  переменной присвойте значение функции `get_cloudpayments_payment_url`&#x20;

{% hint style="info" %}
Название переменной задаете самостоятельно.  На скринах примеры названия переменных.&#x20;
{% endhint %}

В эту переменную запишется ссылка на оплату. Переменную можно вывести на экран ссылкой в сообщении или разместить в кнопке с текстом "Оплатить". Ссылка имеет вид:&#x20;

**ПРИМЕР ссылки на оплату:**

&#x20;<https://orders.cloudpayments.ru/d/PsdA6GaZmxSXB8xi>

{% hint style="info" %}
Многие платежные системы поддерживают облачные онлайн-кассы, они необходимы по 54-ФЗ.\
Прочитайте особенности оформления чеков на сайте выбранной платежной системы, чтобы не попасть в неловкую ситуацию с налоговой инспекцией.
{% endhint %}

{% tabs %}
{% tab title="Калькулятор" %}
Пример 1: ссылка на оплату без чека

<figure><img src="/files/be3uRKI5FKXvDf4qnOhU" alt=""><figcaption><p>Пример формирования ссылки: переданы только обязательные параметры</p></figcaption></figure>

Пример 2: ссылка на оплату с чеком

<figure><img src="/files/JbTAO9oUVoF8Ys4OG7B5" alt=""><figcaption><p>Пример формирования ссылки: переданы все параметры</p></figcaption></figure>
{% endtab %}

{% tab title="Описание параметров" %}
`link = get_cloudpayments_payment_url(amount, description, products_for_receipt, customer_phone, customer_email, full_name, taxation, recurrent, subscription_period, currency, extra_params)`

#### Параметры функции:

<table><thead><tr><th width="203">Параметр</th><th>Описание параметра</th></tr></thead><tbody><tr><td><strong><code>amount</code></strong></td><td><mark style="background-color:blue;">Сумма к оплате.</mark>  В этом поле указываем стоимость товара в рублях <strong><code>(обязательный параметр)</code></strong> </td></tr><tr><td><strong><code>description</code></strong></td><td><p><mark style="background-color:blue;">Описание заказа.</mark>  В этом поле можно использовать только символы английского или русского алфавита, цифры и знаки препинания. </p><p></p><p><em>Чтобы пропустить данный параметр передайте вместо него пару одинарных или двойных кавычек или значение</em> <em><code>None</code></em> </p></td></tr><tr><td><p><strong><code>products_for_</code></strong></p><p><strong><code>receipt</code></strong></p></td><td><p><mark style="background-color:blue;">Параметры для формирования чеков.</mark>  <em>Чтобы пропустить данный параметр передайте вместо него пару одинарных / пару двойных кавычек или значение</em> <em><code>None</code></em></p><p><br>Имеет следующий вид: </p><p><em>[{"name":"ТОВАР1","amount":"1200","vat_code":"5","method":"</em>FullPay<em>","object":"Commodity"}]</em></p><p></p><p><strong>Важно! Используйте двойные кавычки для формирования словаря {"ключ": "значение"}</strong></p><p></p><p><strong>name</strong> - Наименование товара</p><p></p><p><strong>amount -</strong> Полная сумма в рублях за все количество данного товара с утом всех возможных скидок, бонусов и специальных цен.</p><p></p><p><strong>vat_code</strong> - cтавка НДС. Этот параметр устанавливает налоговую ставку в ККТ. Возможные значения данного параметра: </p><p>'1' - Без НДС </p><p>'2' - НДС по ставке 0% </p><p>'3' - НДС по ставке 10% </p><p>'4' - НДС чека по ставке 20% </p><p>'5' - НДС чека по расчетной ставке 10/110 </p><p>'6' - НДС чека по расчетной ставке 20/120</p><p>'7' - НДС 12% (только для онлайн-касс в Казахстане)</p><p>'8'  - НДС по ставке 5%</p><p>'9'  - НДС по ставке 7%</p><p>'10' - НДС чека по расчетной ставке 5/105</p><p>'11'  - НДС чека по расчетной ставке 7/107</p><p></p><p><strong>method</strong> - дополнительный параметр для формирования чека. Признак способа расчёта. </p><p>Пример значения параметра: FullPay — полный расчет<br></p><p>Остальные доступные варианты можно найти в документации Cloudpayments : <a href="https://developers.cloudkassir.ru/#method">https://developers.cloudkassir.ru/#method</a><br></p><p><strong>object</strong> - дополнительный параметр для формирования чека.  Предмет расчета может принимать разные значения. </p><p>Например, commodity — товар</p><p></p><p>Остальные доступные варианты можно найти в документации  Cloudpayments : <a href="https://developers.cloudkassir.ru/#object">https://developers.cloudkassir.ru/#object</a></p><p></p></td></tr><tr><td><strong><code>customer_phone</code></strong></td><td><p><mark style="background-color:blue;">номер телефона покупателя</mark>, не обязательно, если передан параметр <code>customer_email</code> </p><p></p><p>Чтобы пропустить данный параметр,  передайте вместо него одинарные или двойные кавычки</p></td></tr><tr><td><strong><code>customer_email</code></strong></td><td><p><mark style="background-color:blue;">емейл покупателя</mark>, не обязательно, если передан параметр <code>customer_phone</code></p><p></p><p>Чтобы пропустить данный параметр,  передайте вместо него одинарные или двойные кавычки.</p></td></tr><tr><td><strong><code>full_name</code></strong></td><td><p><mark style="background-color:blue;">название/ФИО</mark><br>В данном параметре передаем для юрлица — название организации, для ИП и физического лица — ФИО</p><p></p><p><em>Чтобы пропустить данный параметр,  передайте вместо него пару одинарных/ пару двойных кавычек или значение None.</em></p></td></tr><tr><td><mark style="background-color:blue;"><strong><code>taxation</code></strong></mark></td><td><p><mark style="background-color:blue;">Система налогообложения.</mark>  <br><br>Возможные значения данного параметра:<br></p><p>'1' - Общая система налогообложения </p><p>'2' - Упрощенная (УСН, доходы) </p><p>'3' - Упрощенная (УСН, доходы минус расходы) </p><p>'4' - Единый налог на вмененный доход (ЕНВД) </p><p>'5' - Единый сельскохозяйственный налог (ЕСН) </p><p>'6' - Патентная система налогообложения<br><br><em>Чтобы пропустить данный параметр передайте вместо него пару одинарных или двойных кавычек или значение</em> <em><code>None</code></em></p></td></tr><tr><td><strong><code>recurrent</code></strong></td><td><mark style="background-color:blue;">Подключение автоплатежа.</mark> Если автоплатеж включен, то передать значение 1, если отключен передайте значение None. </td></tr><tr><td><p><code>subscription_</code></p><p><code>period</code></p></td><td><p><mark style="background-color:blue;">Период автоплатежа.</mark> По умолчанию, период автоплатежа - месяц. <br><br>Доступно всего 2 вариант: месяц и неделя. </p><p>Если передать 'week' - период повторного списания будет неделя.<br><br>Чтобы установить период платежа месяц нужно пропустить параметр, то есть либо передать значение None, либо "" (двойные кавычки)</p></td></tr><tr><td><strong><code>currency</code></strong></td><td><p><mark style="background-color:blue;">Валюта платежа.</mark> По умолчанию платеж создается в рублях. Для указания другой валюты  необходимо передать значение. Например, '<em><strong>EUR'</strong></em><br></p><p><em>Российский рубль <strong>RUB</strong></em><br><em>Евро <strong>EUR</strong></em><br><em>Доллар США <strong>USD</strong></em><br><em>Фунт стерлингов <strong>GBP</strong></em><br><em>Украинская гривна <strong>UAH</strong></em><br><em>Белорусский рубль <strong>BYN</strong></em><br><em>Казахский тенге <strong>KZT</strong></em><br><em>Азербайджанский манат <strong>AZN</strong></em><br><em>Швейцарский франк <strong>CHF</strong></em><br><em>Чешская крона <strong>CZK</strong></em><br><em>Канадский доллар <strong>CAD</strong></em><br><em>Польский злотый <strong>PLN</strong></em><br><em>Шведская крона <strong>SEK</strong></em><br><em>Турецкая лира <strong>TRY</strong></em><br><em>Китайский юань <strong>CNY</strong></em><br><em>Индийская рупия <strong>INR</strong></em><br><em>Бразильский реал <strong>BRL</strong></em><br><em>Южноафриканский рэнд <strong>ZAR</strong></em></p><p></p><p><em>Чтобы пропустить данный параметр,  передайте вместо него пару одинарных/ пару двойных кавычек или значение None.</em></p></td></tr><tr><td><strong><code>extra_params</code></strong></td><td>дополнительные параметры, которых нет в данной функции.<br>Возможные дополнительные параметры можно посмотреть по ссылке в документации работы с API  платежной системы <a href="https://developers.cloudpayments.ru/#sozdanie-scheta-dlya-otpravki-po-pochte">https://developers.cloudpayments.ru/#sozdanie-scheta-dlya-otpravki-po-pochte</a><br>Пример: <code>extra_params =</code> {"OfferUri": "https://cloudpayments.ru/online-education"}<br><br><br><em>Чтобы пропустить данный параметр,  передайте вместо него пару одинарных или пару двойных кавычек или значение None.</em></td></tr></tbody></table>
{% endtab %}

{% tab title="Пример кода для копирования" %} <mark style="color:green;">Пример 1: ссылка на оплату без чека</mark>\
\
`link_cloudpayments = get_cloudpayments_payment_url(1200, 'Купи меня')`\
\
\ <mark style="color:green;">Пример 2: ссылка для формирования автоплатежа с чеком, интервал списания -неделя</mark>\
\
`extra_params = {"OfferUri": "https://cloudpayments.ru/online-education"}`

&#x20;`receipt = [{"name":"ТОВАР1","price":"1200","quantity":"1","amount":"1200","vat_code":"5","method":"FullPrepayment","object":"Commodity"}]`

`link_cloudpayments = get_cloudpayments_payment_url(1200, 'Купи меня', receipt, '77777777777', 'exam@mail.com', 'Vasya Pupkin', '0', '1', 'week', 'RUB', extra_params)`

{% hint style="info" %}
Если вам не нужны все параметры функции, то можно не передавать последние пропущенные значения.
{% endhint %}

<mark style="color:green;">Пример 3: ссылка на оплату без автоплатежей, пропущены последние 4 параметра функции</mark>&#x20;

`link_cloudpayments = get_cloudpayments_payment_url(1200, 'Купи меня', receipt, '77777777777', 'exam@mail.com', 'Vasya Pupkin', '0')`
{% endtab %}
{% endtabs %}

{% hint style="info" %}
Переменную можно вывести на экран ссылкой в сообщении или разместить в кнопке с текстом, например, "Купить".&#x20;
{% endhint %}

{% hint style="warning" %}
Если в блоке несколько функций для получения ссылки и допущена ошибка, то значение ошибки будет записано в переменной  **`error_payment_func`**

\
Ошибка запишется по последней функции в Калькуляторе
{% endhint %}

## Создание ссылки с помощью переменной payment\_sum  и дополнительных параметров

### **Как указать сумму**

Для генерации ссылки на оплату вам необходимо установить значение переменной **payment\_sum**, сразу после этого появится переменная **cloudpayments\_pay\_url.** Эту переменную можно вывести на экран ссылкой или разместить на кнопке с текстом "Оплатить".&#x20;

**ПРИМЕР ссылки на оплату:**\
<https://orders.cloudpayments.ru/d/PsdA6GaZmxSXB8xi>

### **Как указать валюту**

Cloudpayments принимает платежи в нескольких валютах, по умолчанию платеж создается в рублях. Для указания другой валюты вам необходимо присвоить значение переменной **currency.** Переменная принимает значения:

<table><thead><tr><th width="347">Значения, принимаемые переменной:</th><th>Что подразумевает</th></tr></thead><tbody><tr><td> <em><strong>RUB</strong></em></td><td><em>Российский рубль</em></td></tr><tr><td> <em><strong>EUR</strong></em></td><td><em>Евро</em></td></tr><tr><td><em><strong>USD</strong></em></td><td><em>Доллар США</em> </td></tr><tr><td><em><strong>GBP</strong></em></td><td><em>Фунт стерлингов</em> </td></tr><tr><td><em><strong>UAH</strong></em></td><td><em>Украинская гривна</em> </td></tr><tr><td><em><strong>BYN</strong></em></td><td><em>Белорусский рубль</em> </td></tr><tr><td><em><strong>KZT</strong></em></td><td><em>Казахстанский тенге</em> </td></tr><tr><td><em><strong>AZN</strong></em></td><td><em>Азербайджанский манат</em> </td></tr><tr><td> <em><strong>CHF</strong></em></td><td><em>Швейцарский франк</em></td></tr><tr><td><em><strong>CZK</strong></em></td><td><em>Чешская крона</em> </td></tr><tr><td><em><strong>CAD</strong></em></td><td><em>Канадский доллар</em> </td></tr><tr><td><em><strong>PLN</strong></em></td><td><em>Польский злотый</em> </td></tr><tr><td><em><strong>SEK</strong></em></td><td><em>Шведская крона</em></td></tr><tr><td><em><strong>TRY</strong></em></td><td><em>Турецкая лира</em> </td></tr><tr><td><em><strong>CNY</strong></em></td><td><em>Китайский юань</em> </td></tr><tr><td><em><strong>INR</strong></em></td><td><em>Индийская рупия</em> </td></tr><tr><td><em><strong>BRL</strong></em></td><td><em>Бразильский реал</em> </td></tr><tr><td><em><strong>ZAR</strong></em></td><td><em>Южноафриканский рэнд</em> </td></tr></tbody></table>

Например, как на скрине ниже, чтобы указать валюту белорусского рубля, можно установить эту переменную в настройках проекта.

<figure><img src="/files/vnzJmAq7TUHT3FcZ2qAp" alt=""><figcaption><p>Настройки проекта → Переменные → Редактирование общих переменных</p></figcaption></figure>

### **Как добавить описание платежа**

Вы можете добавить описание платежа, оно будет отображаться в заголовке формы оплаты.

<figure><img src="/files/3PLf0WGqfrdJsAXPddK9" alt=""><figcaption></figcaption></figure>

Описание берется из переменной **payment\_description**

Также есть возможность указать необязательное поле - Идентификатор пользователя в вашей системе. Для этого нужно до объявления переменной payment\_sum объявить переменную **account\_id** с нужным вам значением

{% hint style="warning" %}
При включении автоплатежей поле "Идентификатор пользователя" заполняется автоматически
{% endhint %}

Другими словами, даже если ранее вы вручную задавали значение переменной account\_id, при включении автоплатежей она перезапишется и будет принимать значение идентификатора пользователя в Salebot. Такое изменение переменной требуется для корректного распознавания коллбэком в автоплатежах.

### **Как обработать результат**

{% hint style="warning" %}
**Важно**! после успешной оплаты в бот придет коллбэк, по которому вы сможете понять, что была успешная оплата.&#x20;

Этот коллбэк в системе вы видите, как сообщение от пользователя, чтобы его не мог отправить пользователь, он состоит из ключа cloudpayments и приписки со статусом, например: **1c00db20d8fc223bce1f407dc1925542db114a76ab62e5afa3714e8fff0cdc78\_success.**&#x20;
{% endhint %}

При успешной оплате по ссылке созданной с помощью кнопки с функцией ОПЛАТА или с помощью функции в калькуляторе, в бота <mark style="color:orange;">**АВТОМАТИЧЕСКИ**</mark> придет КОЛЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова \_success и через пробел сумма платежа. \
\
\&#xNAN;*Для использования в настройках схемы достаточно его скопировать.*&#x20;

Например: `ovg58keefc_success 44`, где:&#x20;

ovg58keefc : первые первые 10 символов секретного ключа платежной системы

\_success : результат обработки запроса (успешный платеж)

44 : сумма платежа

{% hint style="success" %}
Эти коллбэки НЕ ВИДИТ пользователь, они отображаются только оператору.
{% endhint %}

<figure><img src="/files/5BpMd6nUYFyU9hkj27TJ" alt="" width="546"><figcaption></figcaption></figure>

Также после успешной оплаты переменная **cloudpayments\_payment\_completed** устанавливается в **True.**

Если же оплата была неуспешной, Вам придет коллбэк вида 1c00db20d8fc223bce1f407dc1925542db114a76ab62e5afa3714e8fff0cdc78\_fail.&#x20;

<figure><img src="/files/OiwNSkvuoUAx5Egi1ckW" alt="" width="558"><figcaption></figcaption></figure>

Для того чтобы узнать причину, обратите внимание на переменную **cloudpayments\_payment\_status**.&#x20;

Она может принимать следующие значения:&#x20;

<table><thead><tr><th width="153"></th><th width="175"></th><th></th></tr></thead><tbody><tr><td>Completed</td><td>Завершена</td><td>После подтверждения операции</td></tr><tr><td>Cancelled</td><td>Отменена</td><td>В случае отмены операции</td></tr><tr><td>Declined</td><td>Отклонена</td><td>В случае невозможности провести операцию (нет денег на счете карты и др.)</td></tr></tbody></table>

{% hint style="danger" %}
Тип сравнения должен быть "**Полное совпадение**"
{% endhint %}

{% hint style="warning" %}
Для совершения повторного платежа обязательно необходимо обнулить **payment\_sum**, ранее сформированную ссылку и уже после переназначить переменную **payment\_sum** для получения свежей ссылки
{% endhint %}

### **Пример**

{% hint style="info" %}
Для тестирования необходимо использовать карту  с номером: 4111111111111111. Остальные данные не имеют значения.
{% endhint %}

Пример схемы, которая позволит протестировать и быстро начать работу с Cloudpayments.

<figure><img src="/files/LDnveudq5EpzfIk09zJf" alt="" width="218"><figcaption></figcaption></figure>

На рисунке показан пример первого блока, в котором пользователя спрашивают сколько он хочет оплатить.

Ниже настройки стрелки, в ней должен быть включен переключатель "Пользователь вводит данные" и в поле вписана переменная **payment\_sum.**

<figure><img src="/files/B3v44IO1qwMyL2uIlcKu" alt=""><figcaption></figcaption></figure>

Ссылка на оплату содержится в переменной **#{cloudpayments\_pay\_url}**

После завершения оплаты клиенту добавится переменная **cloudpayment\_callback\_data**, содержащая данные ответа платежной системы по совершенной операции. Из полученного словаря можно извлечь необходимые данные при помощи метода **get**.

## Как сформировать чек

Для формирования чека онлайн-кассы необходимо при формировании ссылки на оплату передать дополнительные параметры.

{% hint style="info" %}
**Обратите внимание:** переменной **payment\_sum** присваивается значение после других параметров.
{% endhint %}

Обязательные параметры:

<mark style="color:red;">**!**</mark>**&#x20;products\_for\_receipt** - это массив с перечисленными товарами чека, следующего вида:

\[{"**description**": "Название товара", "**quantity**": "Количество товара", "**price**": "Цена за единицу товара", "**amount**": "стоимость товара, произведение quantity и price", "**vat\_code**": "ставка НДС"},&#x20;

{"**description**": "Название товара 2", "**quantity**": "Количество товара 2", "**price**": "Цена за единицу товара 2", "**amount**": "стоимость товара, произведение quantity и price"}]

Каждый товар разделен запятой и имеет вид: \
{"**description**": "Название товара", "**quantity**": "Количество товара", "**amount**": "Цена за единицу товара", "**vat\_code**": "ставка НДС"}

где:&#x20;

<table><thead><tr><th width="187">Значение </th><th width="198">Описание</th><th>Примечание</th></tr></thead><tbody><tr><td><strong>description</strong> </td><td>название товара (не более 128 символов)</td><td></td></tr><tr><td><strong>quantity</strong> </td><td>количество товара, может быть целое число, либо дробное через точку (например: 1 или 5 или 2.0 или 3.5)</td><td></td></tr><tr><td><strong>price</strong> </td><td>цена за единицу товара</td><td></td></tr><tr><td><strong>amount</strong> </td><td>стоимость товара, произведение quantity и price</td><td></td></tr><tr><td><strong>vat_code</strong></td><td>ставка НДС (не указываем, если товар без НДС)</td><td><p><strong>vat_code</strong> не нужно передавать, если товар не облагается НДС (в примере выше первый товар с 0% НДС, второй без НДС), если же облагается, тогда передаем следующие значения: <br>'1' - Без НДС </p><p>'2' - НДС по ставке 0% </p><p>'3' - НДС по ставке 10% </p><p>'4' - НДС чека по ставке 20% </p><p>'5' - НДС чека по расчетной ставке 10/110 </p><p>'6' - НДС чека по расчетной ставке 20/120</p><p>'7' - НДС 12% (только для онлайн-касс в Казахстане)</p><p>'8'  - НДС по ставке 5%</p><p>'9'  - НДС по ставке 7%</p><p>'10' - НДС чека по расчетной ставке 5/105</p><p>'11'  - НДС чека по расчетной ставке 7/107</p></td></tr></tbody></table>

Также необходимо указать, контактные данные клиента, как минимум: электронную почту или номер телефона:

**email** - E-mail покупателя для отправки чека\
**phone** - телефон покупателя в формате без скобок и дефисов для отправки ссылки на чек

Необязательные параметры:\
**full\_name** - для юрлица — название организации, для ИП и физического лица — ФИО\
**cloudpayments\_method** - признак способа расчета(например, предоплата). \
Число от 0 до &#x37;**.**&#x421;писок значений можно посмотреть [тут](https://developers.cloudkassir.ru/#method)\
**cloudpayments\_object** - признак предмета расчета(например, товар/услуга).\
Число от 0 до 34. Список значений можно посмотреть [тут](https://developers.cloudkassir.ru/#object)\
**cloudpayments\_inn** - ИНН организации, необходим для корректного формирования чека **cloudpayments\_taxation\_system** - система налогообложения, число от 0 до 5, где \
0-Общая система налогообложения \
1-Упрощенная система налогообложения (Доход) \
2-Упрощенная система налогообложения (Доход минус Расход) \
3-Единый налог на вмененный доход \
4-Единый сельскохозяйственный налог \
5-Патентная система налогообложения \
Если не указать, поставит первую систему, указанную при фискализации. **cloudpayments\_calculation\_place** - Место осуществления расчёта, например, адрес сайта<br>

<figure><img src="/files/jAigziJP70bL3MuICPna" alt=""><figcaption></figcaption></figure>

Пример данных для чека:

`products_for_receipt = [{"description": "Название товара", "quantity": "2", "price": "25", "amount": "50", "vat_code": "0"}, {"description": "Название товара 2", "quantity": "3", "price": "50", "amount": "150"}]`\
`phone = 79000000000`\
`email = example@gmail.com`\
`full_name = Иванов Иван Иванович`

**После определения переменных платежа, определяем переменную payment\_sum**, после которой сразу появится ссылка на оплату в переменной cloudpayments\_pay\_url.

<figure><img src="/files/dqGmHaZGscBl7n0m31Pv" alt="" width="533"><figcaption></figcaption></figure>

{% hint style="danger" %}
Внимание! Общая стоимость всех товаров должна быть равной переменной payment\_sum.
{% endhint %}

После оплаты на указанную почту клиенту придет квитанция об оплате, если был передан номер телефона, то на него придет сообщение со ссылкой на квитанцию.

<figure><img src="/files/BtCocGwf8rgbGgKIhb00" alt=""><figcaption><p>Тестовая квитанция об оплате</p></figcaption></figure>

## Как создать автоплатежи

Для создания платежа с подпиской, достаточно перейти в раздел "Эквайринг" в Salebot и в настройках платежной системы включить эту возможность:

<figure><img src="/files/Lp5PFzbtQV476vblSgXF" alt="" width="563"><figcaption></figcaption></figure>

Теперь при переходе по ссылке на оплату покупателю выводится информация, что после проведение платежа создастся подписка.

**Обратите внимание:** Автоплатеж автоматически создается с периодом списания равным **один месяц.**&#x20;

Вы можете задать период списания равный **одной неделе**, для этого перед первым (установочным) платежом дополнительно нужно задать переменную **cloudpayments\_subscription\_period** - со значением **week**<br>

<figure><img src="/files/W3w1jp9uieVYYpc13w1g" alt=""><figcaption></figcaption></figure>

## Как создать автоплатежи

### Как обработать результат платежей по подписки

Результат и статус платежа по подписке можно отследить по переменным сделки:

<table><thead><tr><th width="341"></th><th></th></tr></thead><tbody><tr><td>cloudpayments_payment_completed</td><td>общий индикатор успешного/неуспешного платежа, принимает значения True/False;</td></tr><tr><td>cloudpayments_subscription_payment</td><td>индикатор успешного/неуспешного платежа по подписке, принимает значения True/False;</td></tr><tr><td>cloudpayments_payment_status</td><td>статус платежа в системе Cloudpayments, принимает значения из таблицы ниже:</td></tr></tbody></table>

<figure><img src="https://lh7-us.googleusercontent.com/WbfwrW_lW_JRu0xq1JW9fxkAVRGcVpmKbJuoiRCtzzSrDYh9TKQrngOa1r3iNTfYfjNHlS21I21AQGx1iScSuDloKaOFyGR3fP-wyUJ7zxbmYWfYSfF_finlrkaQqGiWt4ItH-FwKaprWIxKC6Tr0cg" alt=""><figcaption></figcaption></figure>

В случае успешного платежа в переменную subscription\_payment\_sum записывается его сумма, например 200.0

<figure><img src="https://lh7-us.googleusercontent.com/OYek-JspCK6W1QUXYhddJbxCmCtv3_3aZM0y56gbN4S1toL3bZupG093-6oEciX3Si1hZmwgpBlsVqM62CJy2WTdHqBkv7gR5lPbNNknLhheL70rCP6QSL-tkPnAft-CSturT-yt-2uTb4sU887bcAw" alt=""><figcaption></figcaption></figure>

По каждому запросу на списание в бота придет коллбэк. Он выглядит так же, как при обычном платеже. Его описание есть выше в главе "[Обработка результата](https://docs.salebot.pro/integracii/platezhnye-sistemy/cloudpayments#kak-obrabotat-rezultat)".

### Как получить id подписки

При попытке совершить установочной платеж Salebot получит коллбэк, содержащий id подписки и запишет этот id в переменную клиента cloudpayments\_subscription\_id.

Данная переменная используется в запросах функциях изменения и отмены подписки.

<figure><img src="https://lh7-us.googleusercontent.com/v_-IL-sL9YzIoGeziuPE3SDZouU1VnoIboyaz9lvIZVHjfqn4sizGV-q-tdcl7OSJm8huEdEoZ7q_7Pwd0nzL0BF1DMcLF_XzNgQ1MMWR5WGn2781wHGqjzYeTiMr0MpDSlZ62QR_6zgUvK1mW-gfuI" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
&#x20;При создании и попытке оплаты новой подписки переменная перезапишется.
{% endhint %}

### Как отслеживать статус подписки

Статус подписки клиента записывается в переменную сделки cloudpayments\_subscription\_status. Она принимает значения “Active” или “Inactive”.

Выбор значения зависит от двух факторов:

* статуса последнего совершенного платежа по подписке, то есть если платеж был успешным (“Completed”), переменная примет значение “Active”, а в противном случае - “Inactive”;
* информации, которая приходит в ответ на запросы изменения или отмены подписки. Например, если вы отменили подписку, в Salebot придёт колбек c обновленными данными подписки и статусом “Cancelled”. Salebot распознает изменение статуса и перезапишет переменную.

{% hint style="warning" %}
Обратите внимание, что любой запрос на изменение подписки, которая была ранее отменена в системе Cloudpayments, вновь активирует подписку, а платежи по данной подписке будут взиматься в установленном при создании порядке. Чтобы избежать нежелательных платежей по подписке, при отмене, не связанной с результатом рекуррентного списания, рекомендуется обнулить переменную cloudpayments\_subscription\_id.
{% endhint %}

### **Как изменить существующую подписку**

Если после создания вам нужно изменить подписки, используйте функцию cloudpayments\_update\_subscription(amount, description, subscription\_interval, subscription\_period, products\_for\_receipt, start\_date)

Функция принимает набор параметров, однако ни один из них не является обязательным, поэтому, если вы хотите сохранить прежнюю информацию относительно одного из параметров, то просто передайте в него пустую строку - ‘’.

Параметры:

<table><thead><tr><th width="273"></th><th></th></tr></thead><tbody><tr><td>amount</td><td>значение суммы платежа по подписке, ожидаемый формат - целое или число с двумя знаками после точки;</td></tr><tr><td>description</td><td>описание назначения платежа по подписке, ожидаемый формат - строка;</td></tr><tr><td>subscription_interval</td><td>интервал списания оплаты, возможные значения: Day, Week, Month</td></tr><tr><td>subscription_period</td><td>частота списания оплаты по заданному интервалу. Например, если указать, subscription_interval = ‘Month’ и subscription_period = 3, списания будут производиться раз в 3 месяца.</td></tr><tr><td>products_for_receipt </td><td>параметры для формирования чека. Формат ожидаемого значения подробно описан  в разделе “<a href="https://docs.salebot.pro/integracii/platezhnye-sistemy/cloudpayments#kak-sformirovat-chek">Как сформировать чек</a>” </td></tr><tr><td>start_date </td><td><p>дата и время первого или следующего платежа во временной зоне UTC.</p><p>Пример ожидаемого формата '2024-02-25T06:00:00'</p></td></tr></tbody></table>

<mark style="color:orange;">**Для блоков, созданных ранее 16.01.2024:**</mark>

Параметры для изменения интервала, частоты списания и содержимого чеков, также можно задать в блоке с помощью переменных перед вызовом функции.

{% hint style="warning" %}
Обратите внимание, что названия параметров отличаются от тех, которые передаются напрямую в функцию!
{% endhint %}

{% hint style="warning" %}
Если вы ранее задавали нижеуказанные переменные и вызываете функцию с пустыми значениями в параметрах subscription\_interval, subscription\_period и products\_for\_receipt, функция будет брать значения переменных и учитывать их при формировании запроса. Чтобы избежать нежелательных изменений в подписке, обнулите переменные, присвоив им пустую строку - ''.
{% endhint %}

<table><thead><tr><th width="281"></th><th></th></tr></thead><tbody><tr><td>products_for_subscription_receipt</td><td><p>параметры для формирования чека. Формат ожидаемого значения подробно описан  в разделе “<a href="https://docs.salebot.pro/integracii/platezhnye-sistemy/cloudpayments#kak-sformirovat-chek">Как сформировать чек</a>” </p><p>Если вам не нужно менять содержимое чека, пропустите этот параметр или передайте в него пустую строку ‘’.</p></td></tr><tr><td>cloudpayments_subscription_interval</td><td>интервал списания оплаты, возможные значения: Day, Week, Month;</td></tr><tr><td>cloudpayments_subscription_period</td><td>частота списания оплаты по заданному интервалу. Например, если указать, subscription_interval = ‘Month’ и subscription_period = 3, списания будут производиться раз в 3 месяца.;</td></tr></tbody></table>

{% hint style="warning" %}
Обратите внимание, что изменение интервала и периода подписки не будет работать, если Вы ранее не создавали  платеж по подписке, т.к. функция обновляет уже существующую подписку, а не создает новую.
{% endhint %}

{% hint style="warning" %}
Также стоит обратить внимание, что первый платеж по подписке Cloudpayments всегда создается на интервал раз в месяц или раз в неделю, поэтому первичное уведомление о платеже будет содержать вот такую приписку в платежной форме:
{% endhint %}

<figure><img src="/files/hvfu4Y1kuJ7SNCX92Vbs" alt=""><figcaption></figcaption></figure>

Для того, чтобы узнать, прошло ли изменение параметров подписки, следует найти описание переменной с функцией cloudpayments\_update\_subscription в переменных клиента. В приведенном примере в переменной response записан ответ функции, среди параметров ответа можно увидеть новые период и интервал подписки.

<figure><img src="/files/uTxbXCJmQdHz6pe5QRoA" alt="" width="417"><figcaption></figcaption></figure>

Пример ниже показывает использование нового описания подписки.&#x20;

Например, изменим данные подписки на следующие: \
products\_for\_subscription\_receipt = \[{"description": "Название товара", "quantity": "1", "price": "10", "amount": "10", "vat\_code": "0"}, {"description": "Название товара 2", "quantity": "3", "price": "30", "amount": "90"}] \
response = cloudpayments\_update\_subscription(100, "Новая подписка") products\_for\_subscription\_receipt - необязательная переменная, данные для чека (описание ниже)

<figure><img src="/files/kJUbS4pGKCOQb98ytCcr" alt="" width="528"><figcaption></figcaption></figure>

### **Совершение обычного платежа при включенных подписках**

Если Вам нужно, при включенных автоплатежах провести оплату без подписки, то до указания переменной payment\_sum, нужно добавить переменную **cloudpayments\_manual\_recurrent\_disable** и присвоить ей значение 1.&#x20;

Таким образом, ссылка на оплату сформируется без подписки.

{% hint style="warning" %}
Важно! Не забывайте каждый раз обнулять переменную, после получения ссылки
{% endhint %}

<figure><img src="/files/rKutfSazql3CNhryooBn" alt="" width="528"><figcaption></figcaption></figure>

### **Как получить чеки для платежей по подписке**

Если при первом платеже с включенными автоплатежами были переданы данные для чека, то создастся подписка уже с данными для чека. На каждый автоплатеж будет приходить чек на указанный email или номер телефона.

Если вы решили изменить сумму платежа по подписке, у вас подключена онлайн касса и после списания нужно отправлять чек, тогда до вызова функции **cloudpayments\_update\_subscription()** нужно создать переменную **products\_for\_subscription\_receipt**, которая будет содержать новые данные для чека. Если их не передать, списания будут происходить без чека.

**products\_for\_subscription\_receipt** заполняется таким же образом, как и переменная **products\_for\_receipt** описанная выше в главе "[Формирование чеков](#kak-sformirovat-chek)"

### Как получить информацию о подписке

Информацию о подписке клиента можно получить с помощью функции **cloudpayments\_subscription\_info()**.&#x20;

Функция не принимает параметров и вернёт данные подписки с id из переменной клиента cloudpayments\_subscription\_id.

Пример возвращаемых данных:

<figure><img src="/files/gvZuPJaZUVTDj7vXOOYh" alt=""><figcaption></figcaption></figure>

### Как отменить подписку

Чтобы отменить подписку, достаточно вызвать функцию **cloudpayments\_remove\_subscription()**

<figure><img src="/files/sH6EZFa3Y5uNW0GBeV7a" alt="" width="529"><figcaption></figcaption></figure>

#### Как понять, что подписка отменена?&#x20;

Вам приходят уведомления по платежам по подписке, которые содержат текущий статус подписки.

Если подписка активна, то в диалоге будет коллбэк "частьключа\_\_success" и в переменную cloudpayments\_subscription\_status запишется значение "<mark style="color:green;">**Active**</mark>"

Если подписка отменена или не оплачена, в диалоге будет коллбэк "частьключа\_fail",  а в переменную cloudpayments\_subscription\_status запишется "<mark style="color:red;">**Inactive**</mark>"

## Как вывести данные о сделке

В cloudpayments доступна функция вывода полных данных о сделке. Для этого в окне подключения платежки необходимо включить “сохранять данные коллбэка". После этого, при совершении платежей пользователями, в информацию о сделке в переменную **cloudpayment\_callback\_data** будет приходить список, включающий в себя данные о совершенном действии. Из этого списка можно извлечь нужную вам информацию, такую как статус сделки, сумма, валюта, имя, почта и другое. Для этого воспользуйтесь встроенной функцией get()

{% hint style="info" %}
На заметку! Статус платежа также записывается в переменную **cloudpayments\_payment\_status.**
{% endhint %}

<figure><img src="/files/4N6CaCxZOnqw4heHRXpX" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/PmpY99f9fDVXmTNDHV6h" alt="" width="235"><figcaption></figcaption></figure>

## Оплата по токену (рекарринг)

**Рекарринг** — это услуга, которая позволяет клиентам проводить повторную оплату банковскими картами на сайте в один клик, не тратя время на ввод данных.

Этот вид платежа инициирует покупатель, когда оформляет онлайн-покупку впервые.

Если вы хотите подключить данный сервис, вам необходимо связаться с персональным менеджером Cloudpayments.

После подключения сервиса и оплаты по ссылке в ваших переменных появится платежный токен cloudpayments\_payment\_token, с помощью которого вы можете совершить рекарринговый платеж без ввода данных карты.

Чтобы произвести безакцептное списание, задайте переменную token\_payment\_sum (сумма платежа по токену) и воспользуйтесь функцией калькулятора cloudpayments\_payment\_token, передав в неё необходимые параметры в заданном порядке:

token -> initiator -> scheduled -> customer\_phone

#### Описание параметров:

<table><thead><tr><th width="200"></th><th width="221"></th><th></th></tr></thead><tbody><tr><td>token (обязательный)</td><td> токен первого платежа, ожидаемый формат - строка</td><td>например “tk_279a375c41672bd74fdafe625d56y”</td></tr><tr><td>initiator (необязательный) </td><td>признак инициатора списания денежных средств.</td><td><p>Возможные значение:</p><p>0 (ноль, по умолчанию) - транзакция инициирована ТСП на основе ранее сохраненных учетных данных;</p><p>1 (единица) - транзакция инициирована держателем карты (клиентом) на основе ранее сохраненных учетных данных.</p></td></tr><tr><td>scheduled (необязательный) </td><td>признак оплаты по расписанию на основе ранее сохраненных учетных данных.</td><td><p>Возможные значение:</p><p>0 (ноль, по умолчанию) - без расписания;</p><p>1 (единица) - по расписанию.</p></td></tr><tr><td>customer_phone (условно обязательный)</td><td>номер телефона плательщика в формате “89991234567” или “+79991234567”</td><td><p>Не заполняйте данный параметр, если совершаете платеж с использованием узбекистанского провайдера.  </p><p></p><p>В запросах к российскому провайдеру Cloudpayments обязательна передача номера телефона плательщика, если вы являетесь ТСП, предоставляющей телекоммуникационные услуги (MCC 4814 Telecommunication Services). </p><p>В случае отсутствия номера телефона в запросе, банки-эквайеры будут отклонять проводимые операции.</p></td></tr></tbody></table>

В случае успешного платежа, вы получите привычный коллбэк об оплате.


---

# 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/integracii/platezhnye-sistemy/cloudpayments.md?ask=<question>
```

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.