Залог YooKassa для Bitrix24

Приложение установлено и работает. Управление залогом вынесено в карточку сделки — поле «Залог YooKassa»: холдирование, полный и частичный возврат, списание.

Если поле не отображается, добавьте его в карточку сделки (Настроить карточку → поле «Залог YooKassa», тип yk_deposit) либо воспользуйтесь кнопками ниже.

Маппинг полей сделки

Поле-источник — числовое поле сделки, из которого берётся сумма залога (если не задано, сумма вводится вручную). Поле-назначение — числовое поле сделки, куда записывается сумма удержанного залога (если не задано — не записывается).

Поля «Залог принят» и «Залог возвращён» — поля сделки типа «Да/Нет». Сервис проставляет их сам: «принят» — когда клиент оплатил залог и средства захолдированы, «возвращён» — когда залог вернулся клиенту (полный возврат или остаток при частичном списании). Если поле не выбрано — не проставляется.

Строковое поле сделки, в которое сервис положит ссылку на форму в момент её выдачи (и очистит при отзыве). Нужно, чтобы ссылку могли отправить клиенту роботы и бизнес-процессы.

Форма для клиента

По кнопке «Сформировать ссылку для клиента» в карточке сделки менеджер выдаёт клиенту ссылку на публичную форму. Клиент вводит имя, телефон, e-mail и адрес, соглашается с офертой — и только после этого создаётся платёж. Сумму клиент не вводит: она берётся из поля-источника выше.

Версии оферты и политики обязательны. Без версии запись «клиент согласился с офертой» юридически бесполезна: документ можно переписать задним числом. Версия фиксируется сразу в трёх местах — в метаданных платежа YooKassa, в таймлайне сделки и в локальной записи о выданной ссылке.

Только https. Пока не заполнено, ссылки клиентам не выдаются.
Только https. Выводится в блоке о персональных данных на форме.
Подставляется клиенту в поле «Назначение платежа»; он может его изменить.
От 1 до 168 (7 суток — предельный срок холда YooKassa). Пусто — значение по умолчанию.
Строковое поле сделки, из которого адрес подставляется в форму клиента.
Имя, телефон, e-mail и адрес из карточки увидит любой, кому переслали ссылку. Выключите, если клиент должен вводить их сам.
Работает, когда подстановка включена. Снятый чекбокс означает, что клиент вводит это поле сам — например, адрес показать можно, а телефон гостя нет.

Реквизиты оператора персональных данных выводятся на публичной форме в блоке 152-ФЗ: клиент должен видеть, кому именно он даёт согласие. Если не заполнить, форма сошлётся на реквизиты из оферты.

Платежи YooKassa

Список берётся напрямую из YooKassa, поэтому в нём видны и те платежи, записи которых в Bitrix потерялись (в колонке «Сделка» — «нет записи»). Холд можно отменить, списанный платёж — вернуть клиенту. Операции доступны только администратору портала.

Показать платежи за последние 90 дней