Подключаем платёжную систему к Битрикс24, чтобы запрос оплаты, подтверждение провайдера и возврат были связаны с конкретным заказом. Настраиваем суммы, идентификаторы и состояния, учитывая частичную оплату и повторные уведомления.
Основание оплаты и способ подключения
Выбираем объект Битрикс24, содержащий согласованную сумму и назначение: заказ, счёт либо связанный процесс продажи. Источник цены и получатель должны быть определены, особенно при нескольких организациях. Платёжная попытка имеет свой ID и не совпадает с номером сделки. У одного заказа могут быть несколько попыток и несколько частичных платежей.
ДляЮ Kassa, банковского эквайринга или другого выбранного провайдера проверяем готовое приложение и нужные API-операции. СБП, карта и иные способы доступны по условиям конкретной схемы. Комиссии, договор и география определяются провайдером; техническое подключение не заменяет выбор этих условий.
Создание запроса и подтверждение суммы
Перед отправкой проверяем актуальность заказа, сумму, валюту и признаки нужного сценария. В CRM сохраняем платёжный ID и ссылку либо другой результат сервиса. Для повторного нажатия задаём, когда используется прежний запрос, а когда допустима новая попытка. Защита от дубля применяется к конкретной операции и ключу, поддерживаемому API.
При изменении заказа проверяем судьбу действующей ссылки: её нельзя продолжать считать корректной без согласованного правила. Если старая попытка всё-таки завершится, сотрудник должен увидеть расхождение и порядок разбора. Повторная оплата уже оплаченного заказа не становится штатным способом устранить потерянный ответ.
Серверный факт вместо страницы успеха
Переход пользователя обратно на сайт не подтверждает оплату: он может закрыть страницу или открыть её без завершённой операции. Состояние получаем по официальному протоколу провайдера, проверяя достоверность уведомления и при необходимости запрашивая объект. Сумму, валюту и принадлежность сопоставляем с ожидаемой операцией.
При одностадийной модели успешный платёж имеет один маршрут завершения; при двухстадийной нужно отдельно учесть ожидание подтверждения и окончательное списание в поддерживаемом составе. Переход в успешную стадию CRM не должен срабатывать на промежуточном состоянии. Журнал сохраняет исходное событие и принятое решение.
Доплаты, отмены и возвраты
Остаток к оплате рассчитываем по подтверждённым операциям. Для доплаты создаётся связанный запрос, а недоплата не закрывает весь заказ автоматически. Отмена незавершённого платежа и возврат уже списанных денег — разные операции с разными ограничениями.
Полный и частичный возврат связываем с исходным платежом, суммой и основанием. Повтор команды сначала проверяет прежний результат, а уведомление о возврате не запускает новый возврат. Если требуется фискализация, чек и платёж имеют отдельные состояния и критерии: банковское подтверждение не доказывает успешное создание чека. Конкретный кассовый состав определяется отдельно.
Надёжная обработка и рабочая сверка
Уведомления могут повторяться и приходить позже других действий. Сохраняем ID операции, текущее подтверждённое состояние и обработанный результат; старое событие не откатывает уже принятый факт. При таймауте проверяем доступный статус прежде, чем создать новый запрос. Ошибка отдельной операции остаётся видимой сотруднику.
Для сверки выделяем платёж без заказа, заказ без подтверждения и несоответствие суммы. Проходим закрытую страницу браузера, повтор webhook, частичную оплату и возврат, отозванный доступ и восстановление. Передаём карту состояний, настроенное подключение и инструкции. Тестовый режим не выдаём за факт рабочего списания; порядок перехода в рабочий аккаунт согласуется в составе запуска.
Страница «успешно» подтверждает оплату?
Нет. Подтверждение получает сервер по протоколу провайдера с проверкой операции и суммы. Браузерный переход может отсутствовать или не отражать окончательное состояние.
Можно принимать несколько оплат по одной сделке?
При подходящей модели — да. Каждая операция имеет собственный ID, а оплаченная сумма и остаток считаются по подтверждённым результатам. Одно событие не закрывает весь заказ без сверки.
Подключение включает чек?
Только если фискализация выделена в согласованном составе и поддерживается выбранной схемой. Банковская оплата и чек связаны, но имеют отдельные результаты и обработку ошибок.
Что произойдёт при двойном уведомлении?
Оно должно обновить прежнюю операцию без второй оплаты или повторного действия CRM. Проверяемидентификатор и подтверждённое состояние; неверную сумму направляем на разбор.