Залог YooKassa для Bitrix24

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

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

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

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

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

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

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

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

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

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

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

Уведомление об автовозврате

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

Сообщение уходит от имени сотрудника, который установил приложение: этот сотрудник должен состоять в выбранном чате, иначе сообщение не доставится. Кроме того, у локального приложения должно быть право (scope) im — доступ к мессенджеру портала; без него список чатов будет пуст, а уведомления не уйдут.

Выключено — сервис молчит. Включено и чат выбран — за указанное ниже время до автовозврата в чат уйдёт одно сообщение по каждому залогу.
Показываются недавние диалоги того сотрудника, который открыл эти настройки. Если нужного чата в списке нет (например, он только что создан) — нажмите «Обновить список» или укажите идентификатор вручную в поле ниже. Выбор из списка очищает поле ручного ввода.
Приоритетнее списка: пока поле заполнено, используется именно оно. Формат Bitrix24 — chat123 для группового чата или числовой ID сотрудника (123) для личного сообщения. Оставьте пустым, чтобы адресат брался из списка выше.
Целое число от 1 до 168 (7 суток — предельный срок холда YooKassa). Пусто — значение по умолчанию, 24 часа.

Платежи YooKassa

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

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