Ссылка на оплату имеет ограничение по времени. Если клиент не подтвердит оплату до окончания этого срока, то ЮКаssa отменит платеж.

Ссылка может быть неактивной в случае если был повторный переход тем же или другим пользователем с другого устройства или браузера.

В любом случае предусмотрите возможность генерации новой ссылки.

Подробнее в таблице "срок оплаты"

Как интегрировать ЮKassa в Salebot.pro

Для подключения ЮKassa Вам потребуются ShopID и секретный ключ.

ShopID можно увидеть в настройках магазина на ЮKassa

Либо в левом меню ЮKassa:

Секретный ключ находится в разделе Интеграция → Ключи API:

Для того, чтобы бот получал уведомления об оплате, также необходимо установить на ЮKassa callback_url https://chatter.salebot.pro/yandex_kassa_callback/result

Для этого нужно перейти в раздел "Интеграция" → "HTTP-уведомления"

Не забудьте нажать на кнопку "Сохранить"

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

Далее выберите Ставку НДС и систему налогообложения.

Поле Ставка НДС. Указываем ставку НДС. Возможные значения — числа от 1 до 6:
1 - Без НДС
2 - НДС по ставке 0%
3 - НДС по ставке 5%
3 - НДС по ставке 10%
4 - НДС чека по ставке 20%
5 - НДС чека по расчетной ставке 10/110
6 - НДС чека по расчетной ставке 20/120

Система налогообложения. Система налогообложения магазина (тег в 54 ФЗ — 1055). Обязательный параметр, если вы используете онлайн-кассу Атол Онлайн, обновленную до ФФД 1.2, или у вас несколько систем налогообложения, в остальных случаях не передается.
https://yookassa.ru/developers/api#create_payment

енвд отменен 01.01.2021

Для чеков самозанятых данное поле передавать не передается

На этом настройка подключения платежной системы закончена.

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

Сформировать ссылку на оплату в блоке можно ОДНИМ ИЗ из доступных способов:

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

Ссылку на оплату можно создавать в кнопке с функцией "Оплата".

О том как создавать такую кнопку рассказано в этой статье

Рассмотрим все возможные параметры данной кнопки. О том как создавать кнопку с функцией Оплата рассказано в этой статье:

Обязательные параметры кнопки Оплата для ЮKassa

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

поле Текст. Данный текст будет указан на кнопке с ссылкой на оплату в сообщении

поле Функция. Для создания кнопки для выдачи ссылки на оплату выбираем функцию Оплата

поле Платежная система. В списке отображаются подключенные к проекту платежные системы. Выбираем ЮKassa

Если к проекту не подключены платежные системы данный тип кнопок будет не доступен

поле Наименование товара (обязательное). В данном поле нужно указать название товара. Максимально количество символов для данного поля: 250
Чем точнее указано описание товара, тем лучше. Например: не Телефон, а Смартфон Xiaomi модель ххх

НЕЛЬЗЯ использовать двойные кавычки в Описании товара: удалите или замените на одинарные кавычки.

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

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

чекбокс Двухстадийная оплата. Данная функция нужная для того чтобы деньги не сразу отправлялись на счёт продавца, а сначала замораживались (холдировались). Такой платёж можно подтвердить или отменить. Подробнее как настроить двухстадийную оплату читайте здесь: Двухстадийная оплата (холдирование)

меню Данные для формирования чека. При клике по данной кнопке откроются дополнительные обязательные и необязательные поля для формирования чека

Многие платежные системы поддерживают облачные онлайн-кассы, они необходимы по 54-ФЗ.
Прочитайте особенности оформления чеков на сайте выбранной платежной системы, чтобы не попасть в неловкую ситуацию с налоговой инспекцией.

  • Количество
  • Название товара
  • Итоговая цена
  • ФИО покупателя
  • Переменная с email покупателя
  • Переменная с номером телефона покупателя

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

  • Валюта

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

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

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

выпадающее меню "Данные для формирования чека"

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

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

поле Название товара (обязательный параметр). Название товара (не более 128 символов), которое вы увидите в личном кабинете ЮKassa, а пользователь — при оплате. Если не передать будет иметь вид: 'Оплата счета 35342815-29200591'

НЕЛЬЗЯ использовать двойные кавычки в Названии товара: удалите или замените на одинарные кавычки.

поле Итоговая цена (обязательный параметр). В данном поле необходимо указать сумму к оплате с учетом количества товаров. Если количество равно 1, то Итоговая цена равна значению в обязательном поле "Сумма" в настройках данной кнопки

Для чеков самозанятых передаем значение 1 (Без НДС)

Способ расчета (тег в 54 ФЗ — 1214) — отражает тип оплаты и факт передачи товара. Пример: покупатель полностью оплачивает товар и сразу получает его. В этом случае нужно передать значение full_payment (полный расчет). Весь список значений поля можно посмотреть тут.

Предмет расчета (тег в 54 ФЗ — 1212) — это то, за что принимается оплата, например товар, услуга. Весь список значений поля можно посмотреть тут.

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

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

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

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

Обязательно должен присутствовать email и/или телефон

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

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

поле Валюта(обязательный параметр). В данном поле можно выбрать одну из доступных вариантов валюты платежа. По умолчанию: RUB

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

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

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

Служебную переменную клиента __payments НЕЛЬЗЯ удалять или изменять!

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

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

Значение переменных становятся актуальными при переходе в следующий блок

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

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

В бота АВТОМАТИЧЕСКИ придет КОЛЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова _success и через пробел сумма платежа.
&#xNAN;Для использования в настройках схемы достаточно его скопировать.

Например: ovg58keefc_success 44, где:

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

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

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

Коллбэки (уведомления) от платежной системы пользователь НЕ ВИДИТ. Они отображаются только во вкладке Клиенты и видны оператору.

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

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

Важно: выбор соответствия Полное совпадение или По наличию ключевых слов Если используете По наличию ключевых слов в поле Условие указывайте часть коллбэка без суммы платежа: 10СимволовСекретногоКлюча__success

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

При ошибке проведения оплаты в бота АВТОМАТИЧЕСКИ придет КОЛЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова _fail и через пробел сумма платежа

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

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

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

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

Зависит от платежной системы. Не все платежные системы присылают коллбэк об ошибке платежа.

Если сумма указанная в настройках кнопки отличается от суммы, которую клиент оплатил, то АВТОМАТИЧЕСКИ придет КОЛЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова _different_amounts и через пробел уникальный ID платежа

Например: ovg58keefc_different_amounts 123456 , где:

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

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

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

Функция get_yookassa_payment_url в Калькуляторе

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

В поле Калькулятор переменной присвоим значение функции get_yookassa_payment_url

Название переменной задаете самостоятельно. На скринах примеры названия переменных.

В эту переменную запишется ссылка на оплату. Переменную можно вывести на экран ссылкой в сообщении или разместить в кнопке с текстом, например, "Оплатить".

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

Многие платежные системы поддерживают облачные онлайн-кассы, они необходимы по 54-ФЗ.
Прочитайте особенности оформления чеков на сайте выбранной платежной системы, чтобы не попасть в неловкую ситуацию с налоговой инспекцией.

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

link_yookassa = get_yookassa_payment_url(amount, description, recurrent, products_for_receipt, customer_phone, customer_email, full_name, taxation, currency, extra_params, twostage_payment)

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

Калькулятор

Пример 1: платеж с основными параметрами

Пример 2: платеж с формированием чека

Пример 3: Первый платёж для подключения автоплатежа

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

Пример 1: Ссылка на оплату без чека

link_yokassa = get_yookassa_payment_url(1200, 'Купи меня')

Пример 2: Ссылка на оплату с чеком без автоплатежа

extra_params = {"client_ip": "66.249.72.248"}

receipt= [{"name":"ТОВАР1","amount":"1200","vat_code":"5","method":"full_payment","object":"commodity", "quantity":1}]

link_yokassa = get_yookassa_payment_url(1200, 'Купи меня', '', receipt, '77777777777', 'exam@mail.com', 'Vasya Pupkin', '4', 'RUB', extra_params)

Пример 3: Ссылка на оплату с чеком и автоплатежом (первый платеж, при котором сохраняются переменные для автоплатежа)

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

link_yokassa = get_yookassa_payment_url(1200, 'Купи меня', '1', receipt, '77777777777', 'exam@mail.com', 'Vasya Pupkin', '4')

Переменную можно вывести на экран ссылкой в сообщении или разместить в кнопке с текстом, например, "Купить".

Если в блоке несколько функций для получения ссылки и допущена ошибка, то значение ошибки будет записано в переменной error_payment_func


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

Двухстадийная оплата (холдирование)

Чтобы использовать двухстадийную оплату (холдирование), в параметры функции get_yookassa_payment_url нужно передать соответствующий параметр twostage_payment:

Если это кнопка для оплаты, то нужно поставить галочку "Двухстадийная оплата".

Важно!

Также на стороне платежной системы нужно включить уведомления о событиях waiting_for_capture.

Теперь после успешной оплаты сначала придет коллбэк вида "ovg58keefc_hold 10".

Также у клиента в этот момент появится переменная "yandex_payment_method_id_hold" - она пригодится, если нужно будет подтвердить или отменить оплату через бота:

  1. чтобы подтвердить оплату и списать захолдированные средства, нужно использовать функцию "yookassa_payment_capture(payment_id)"
  2. чтобы отменить оплату - "yookassa_payment_cancel(payment_id)"

В параметр payment_id передается ранее сохраненный "yandex_payment_method_id_hold"

После подтверждения/отмены платежа уже придут привычные коллбэки "ovg58keefc_success 44" или "ovg58keefc_fail 44" соответственно.

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

Для генерации ссылки на оплату, вам необходимо в поле Калькулятор блока установить значение переменной payment_sum, сразу после этого появится переменная yandex_kassa_pay_url.

Также до установки значения переменной payment_sum, можно задать следующие необязательные переменные, для настройки платежа:
currency - валюта заказа. Код валюты в формате ISO-4217, по умолчанию RUB
payment_title – описание заказа. Если не указан, будет заполнен автоматически "Оплата счета 123456-123456"

  1. Создаем блок, в котором присваиваем в калькуляторе переменной payment_sum сумму в виде числового значения:

  1. Далее в следующем блоке указываем переменную #{yandex_kassa_pay_url} через конструкцию #{} в вложении либо в кнопке:

При тестировании схемы бот отработается следующим образом:

  1. Если #{yandex_kassa_pay_url} в кнопке, то придет кнопка, при клике на которую клиент перейдет в платежную форму:

  1. Если #{yandex_kassa_pay_url} лежит в поле url настройки вложений, то придет ссылка для оплаты:

И в первом, и во втором случае при клике на кнопку или переходе по ссылке, ваш клиент перенаправится на страницу оплаты:

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

После успешной или неуспешной оплаты в бот придут коллбэки, по которым вы сможете понять, что была успешная оплата. Эти коллбэки в системе вы видите как сообщения от пользователя, чтобы их не мог отправить пользователь, они состоят из ключа ЮKassa и приписки со статусом, например: test_k4kyf6E00dpq5ft7vGHmxXCo23JKziwt729O-WcdL8s_success. Также после успешной оплаты переменная yandex_kassa_payment_completed устанавливается в True.

Если ссылка создана с помощью кнопки с функцией Оплата или с помощью функции в калькуляторе, в бота АВТОМАТИЧЕСКИ придет КОЛЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова _success и через пробел сумма платежа.
&#xNAN;Для использования в настройках схемы достаточно его скопировать.

Например: ovg58keefc_success 44, где:

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

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

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

Эти коллбэки НЕ ВИДИТ пользователь, они отображаются только оператору.

Тип сравнения должен быть "Полное совпадение"

Для совершения повторного платежа обязательно необходимо обнулить payment_sum, ранее сформированную ссылку и уже после переназначить переменную payment_sum для получения свежей ссылки

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

Как подключить автоматические платежи

Для подключения возможности применения автоплатежей требуется связаться с Вашим менеджером. Вот несколько полезных советов:

  1. Звонить или писать в техподдержку необходимо самостоятельно
  2. Не забудьте подготовить все скрины о ценах в боте и о том, что подписку можно отменить
  3. Делать это лучше в будние дни
  4. Ожидание одобрения - 2-3 дня

Шаг 1. Включить автоплатежи в настройках ЮКассы в проекте Salebot.

Для подключения автоматических платежей в Salebot необходимо включить переключатель "Включить автоплатежи" для ЮKassa в разделе "Эквайринг":

В этом случае при оплате сервис ЮKassa предложит разрешить автосписания:

При переходе по ссылке ЮKassa объяснит как работают автосписания.

Шаг 2. Провести обычный платёж.

С помощью удобного способа сформировать ссылку на оплату. Рекомендуем использовать в блоке кнопку с функцией "Оплата" или с помощью функции get_yookassa_payment_url

После успешной оплаты у клиента появится переменная yandex_payment_method_id. Эту переменную необходимо использовать при повторных платежах.

Переменная yandex_payment_method_id обязательна для последующих платежей.

Если ее удалить, следующий автоплатеж провести НЕ получится.

Шаг 3. Планируем автосписание

От блока Успешная оплата планируем стрелку с таймером к блоку с автоплатежом. Для примера запланируем следующий платеж через 30 дней.

Шаг 4. Планируем регулярные списания и настраиваем возможность отказаться от автосписаний.

Для поведения повторного платежа необходимо использовать запрос:

Тип запроса: POST-json

URL: https://store.salebot.pro/function/yandex\_kassa\_auto\_pay

Параметры:
shop_id - идентификатор магазина из настроек
secret_key - ключ из настроек подключения
payment_sum - сумма платежа
yandex_payment_method_id - необходимо передать переменную: #{yandex_payment_method_id}
order_id - необходимо передать переменную: #{order_id}
payment_title - описание платежа(необязательный параметр)
capture - параметр, отвечающий за платеж без подтверждения пользователя. Установите значение равное 1 (параметр необязательный)

Сохраняемые значения из JSON-ответа:
response -> yandex_kassa_payment_id
По переменной yandex_kassa_payment_id система определит что именно оплатил пользователь. Для тестирования вы можете вывести на экран переменную #{custom_answer}. В случае успеха ответ будет вида: {"status":"1","response":"265b608b-000f-5000-a000-1fab5b6fd51b"}

Пример параметров:

{"shop_id": "653775", "secret_key": "test_k4kyf6E00dpq5ft7vGHmxXCo23JKziwt729O-WcdL8s", "payment_sum": 200, "yandex_payment_method_id": "#{yandex_payment_method_id}", "order_id": "#{order_id}"}

Для тестирования платежа вам необходимо перейти по ссылке для оплаты, выбрать средство платежа и оплатить

После успешной оплаты сможете посмотреть информацию о платеже:

При выполнении автоплатежа не должно быть ссылки на оплату ЮКассы и переменной payment_sum!

ОТМЕНИТЬ АВТОСПИСАНИЯ

Автоматические платежи необходимо использовать аккуратно, необходимо предусмотреть возможность отписки от платежа. Также, не всегда требуется подтверждение при проведении платежа и вы можете, в случае ошибки, списать все деньги у человека. Будьте аккуратны.

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

Данные чека должны быть заданы до указания суммы платежа.

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

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

products_for_receipt - это массив с перечисленными товарами чека, следующего вида:

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

  1. description - название товара (не более 128 символов)
  2. quantity - количество товара, может быть целое число, либо дробное через точку (например: 1 или 5 или 2.0 или 3.5)
  3. amount - цена за единицу товара

vat_code - ставка НДС. Возможные значения — числа от 1 до 6:
1 - Без НДС
2 - НДС по ставке 0%
3 - НДС по ставке 10%
4 - НДС чека по ставке 20%
5 - НДС чека по расчетной ставке 10/110
6 - НДС чека по расчетной ставке 20/120

tax_system_code - система налогообложения. Возможные значения — числа от 1 до 6:
1 - Общая система налогообложения
2 - Упрощенная (УСН, доходы)
3 - Упрощенная (УСН, доходы минус расходы)
4 - Единый налог на вмененный доход (ЕНВД) (отменен с 01.01.2021)
5 - Единый сельскохозяйственный налог (ЕСН)
6 - Патентная система налогообложения

Также необходимо передать контактные данные клиента, как минимум электронную почту или номер телефона:
email - электронная почта пользователя.
phone - телефон пользователя. Указывается в формате ITU-T E.164, например 79000000000.

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

full_name - для юрлица — название организации, для ИП и физического лица — ФИО

После определения переменных платежа, определяем переменную payment_sum, после которой сразу появится ссылка на оплату.

Общая стоимость всех товаров должна быть равной переменной payment_sum.

Обратите внимание: переменная payment_sum получает своё значение последней!

Из примера выше:

Как сформировать чеки ЮКасса для автоплатежей

Данные чека должны быть заданы ДО указания суммы платежа

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

Если списание за один товар

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

vat_code - ставка НДС. Возможные значения — числа от 1 до 6:

1 - Без НДС
2 - НДС по ставке 0%
3 - НДС по ставке 10%
4 - НДС чека по ставке 20%
5 - НДС чека по расчетной ставке 10/110
6 - НДС чека по расчетной ставке 20/120

tax_system_code - система налогообложения. Возможные значения — числа от 1 до 6:
1 - Общая система налогообложения
2 - Упрощенная (УСН, доходы)
3 - Упрощенная (УСН, доходы минус расходы)
4 - Единый налог на вмененный доход (ЕНВД) (отменен с 01.01.2021)
5 - Единый сельскохозяйственный налог (ЕСН)
6 - Патентная система налогообложения

Также необходимо передать контактные данные клиента, как минимум, электронную почту или номер телефона:
email - электронная почта пользователя.
phone - телефон пользователя. Указывается в формате ITU-T E.164, например 79000000000.

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

product_description - Наименование товара, если не передать будет иметь вид: 'Оплата счета 35342815-29200591'
full_name - для юр/лица — название организации, для ИП и физического лица — ФИО

Если списание сразу за несколько товаров

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

vat_code - ставка НДС. Возможные значения — числа от 1 до 6:

1 - Без НДС
2 - НДС по ставке 0%
3 - НДС по ставке 10%
4 - НДС чека по ставке 20%
5 - НДС чека по расчетной ставке 10/110
6 - НДС чека по расчетной ставке 20/120

tax_system_code - система налогообложения. Возможные значения — числа от 1 до 6:
1 - Общая система налогообложения
2 - Упрощенная (УСН, доходы)
3 - Упрощенная (УСН, доходы минус расходы)
4 - Единый налог на вмененный доход (ЕНВД) (отменен с 01.01.2021)
5 - Единый сельскохозяйственный налог (ЕСН)
6 - Патентная система налогообложения

products_for_receipt - это массив с перечисленными товарами чека (нужно записать в переменную и передать), имеет следующий вид:

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

Обратите внимание, строка описания одного товара имеет вид:
{"description": "Название товара", "quantity": "Количество товара", "amount": "Цена за единицу товара"}

description - название товара (не более 128 символов)
quantity - количество товара, может быть целое число, либо дробное через точку
(например: 1 или 5 или 2.0 или 3.5)
amount - цена за единицу товара

Общая стоимость всех товаров должна быть равна переменной payment_sum.

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

full_name - для юрлица — название организации, для ИП и физического лица — ФИО

Описание переменной, содержащей перечень описаний товара, для формирования чека:

Объявление переменной

Дополнительные параметры, передаваемые обязательно для формирования чека, выделены жирным:
{"shop_id": "123456", "secret_key": "#{secret_key}", "payment_sum": 13, "yandex_payment_method_id": "#{yandex_payment_method_id}", "order_id": "#{order_id}", "vat_code":"1", "tax_system_code":"#{tax_system_code}", "products_for_receipt": "#{for_receipt}", "email": "#{email}"}

Обратите внимание: переменная payment_sum получает своё значение последней!

Как сделать возврат платежа вместе с чеком

С помощью нашей интеграции с ЮKassa можно возвращать успешные платежи. Комиссии за проведение возврата нет. Комиссия ЮKassa за проведение платежа не возвращается.

Полный возврат

Тип запроса: POST-json

URL: https://store.salebot.pro/function/yookassa\_function

Параметры:
shop_id - идентификатор магазина из настроек
secret_key - ключ из настроек подключения
refund_sum - сумма возврата (пример 100 или с точкой 120.5)
yandex_kassa_payment_id - идентификатор платежа, необходимо передать переменную:
#{yandex_kassa_payment_id}

Дополнительно можно указать:
refund_description - комментарий к возврату, основание для возврата денег пользователю.

Сохраняемые значения из JSON-ответа:

status -> refund_status;
response -> resp
Для тестирования вы можете вывести на экран переменную #{custom_answer}.
В случае успеха ответ будет вида:
{"status":"canceled","response":"265b608b-000f-5000-a000-1fab5b6fd51b"}

status - статус возврата платежа. Возможные значения: canceled, succeeded или 0, если возникла ошибка
response - идентификатор возврата платежа в ЮKassa или описание ошибки

Пример параметров:

{"shop_id": "653775", "secret_key": "test_k4kyf6E00dpq5ft7vGHmxXCo23JKziwt729O-WcdL8s", "refund_sum": 100, "yandex_kassa_payment_id": "#{yandex_kassa_payment_id}"}

Частичный возврат

Тип запроса: POST-json

URL: https://store.salebot.pro/function/yookassa\_function

Параметры:
peace_refund - 1 - отмечаем, что возврат частичный
shop_id - идентификатор магазина из настроек
secret_key - ключ из настроек подключения
yandex_kassa_payment_id - идентификатор платежа, необходимо передать переменную: #{yandex_kassa_payment_id}
refund_products_list - список возвращаемых товаров, пример:

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

Важно, чтобы были одинарные кавычки в этом выражении (ниже представлен пример, который можно скопировать и заменить данные на свои).

Каждый товар содержит три значения:

{'description': 'Название товара', 'quantity': 'Количество товара', 'amount': 'Цена за единицу товара'}

  1. description - название товара (не более 128 символов)
  2. quantity - количество товара, может быть целое число, либо дробное через точку (например: 1 или 5 или 2.0 или 3.5)
  3. amount - цена за единицу товара


refund_sum - полная сумма возврата товаров из refund_products_list (пример 100 или с точкой 120.5)
vat_code - ставка НДС. Возможные значения — числа от 1 до 6:

1 - Без НДС
2 - НДС по ставке 0%
3 - НДС по ставке 10%
4 - НДС чека по ставке 20%
5 - НДС чека по расчетной ставке 10/110
6 - НДС чека по расчетной ставке 20/120

tax_system_code - система налогообложения. Возможные значения — числа от 1 до 6:
1 - Общая система налогообложения
2 - Упрощенная (УСН, доходы)
3 - Упрощенная (УСН, доходы минус расходы)
4 - Единый налог на вмененный доход (ЕНВД) (отменен с 01.01.2021)
5 - Единый сельскохозяйственный налог (ЕСН)
6 - Патентная система налогообложения

email - Электронная почта пользователя.
И\ИЛИ
phone - Телефон пользователя. Указывается в формате ITU-T E.164, например 79000000000.

Дополнительно можно указать:
full_name - для юрлица — название организации, для ИП и физического лица — ФИО
refund_description - комментарий к возврату, основание для возврата денег пользователю.

Сохраняемые значения из JSON-ответа:

status -> refund_status;
response -> resp

Для тестирования вы можете вывести на экран переменную #{custom_answer}.
В случае успеха ответ будет вида:
{"status":"canceled","response":"265b608b-000f-5000-a000-1fab5b6fd51b"}

status - статус возврата платежа. Возможные значения: canceled, succeeded или 0, если возникла ошибка
response - идентификатор возврата платежа в ЮKassa или описание ошибки

Пример параметров:

{"shop_id": "769963", "secret_key": "test_fMZ0RqpghcoETJ9fhWXbZJsM66DKyvBgJN1rr65Ioz", "refund_sum": 100, "yandex_kassa_payment_id": "#{yandex_kassa_payment_id}", "peace_refund": 1, "full_name": "Иванов Иван Иванович", "email": "example@gmail.com", "phone": "79000000000", "vat_code": 1, "tax_system_code": 6, "refund_products_list": "[{'description': 'Название товара', 'quantity': 'Количество товара', 'amount': 'Цена за единицу товара'}, {'description': 'Название товара 2', 'quantity': 'Количество товара 2', 'amount': 'Цена за единицу товара 2'}]"}