Ссылки и статусы оплаты

Prodamus поддерживает полный платёжный сценарий: создать ссылку на разрешённую покупку, отправить её клиенту, дождаться надёжного подтверждения и продолжить диалог или автоматизацию по результату.

Создание ссылки

Инструмент создания ссылки использует только аккаунт, позиции и цены из настроек экземпляра. Senler автоматически передаёт контекст проекта, агента, канала, диалога и лида; эти служебные значения не нужно запрашивать у покупателя.

Приложение создаёт уникальный order_id, отправляет его в Prodamus как номер заказа и возвращает агенту платёжную ссылку. Сразу после создания заказ получает статус pending: ссылка готова, но подтверждение оплаты ещё не поступило.

Повторный технический вызов с тем же идентификатором события не создаёт второй заказ. Новый осознанный вызов инструмента создаёт новую ссылку и новый order_id.

Подтверждение оплаты

Переход покупателя на страницу успешной оплаты не является подтверждением. Приложение меняет статус только после подписанного webhook от Prodamus, сверяя магазин, номер заказа, подпись и сумму.

После подтверждения приложение сохраняет оплату и передаёт Senler событие payment.paid для агента и диалога, в котором была создана ссылка. Событие содержит ID заказа, сумму, валюту и позиции заказа. Эти данные становятся служебным контекстом агента и не показываются покупателю отдельным техническим сообщением.

Агент реагирует только если событие «Оплата подтверждена» включено в его настройках. Текст ответа и дальнейшие действия определяются инструкцией агента. Повтор одного webhook не создаёт повторную реакцию: Prodamus и Senler используют стабильный идентификатор события.

Проверка статуса

Инструмент проверки возвращает сохранённые order_id, status, paid, сумму и платёжную ссылку. Он читает состояние приложения и не делает новый запрос к Prodamus при каждом вызове.

Для проверки агент должен передать order_id, который вернул инструмент создания ссылки. Заказ должен принадлежать текущему проекту и диалогу. Приложение не выбирает заказ из истории автоматически.

Автоматизации

В редакторе автоматизации доступны шаги «Создать ссылку на оплату», «Проверить оплату» и «Ждать оплату».

Типовая схема создаёт ссылку, отправляет её покупателю и ждёт подтверждения Prodamus. На снимке отмечен:

1. Шаг «Создать ссылку на оплату» — он создаёт заказ и сохраняет ссылку и order_id в переменные процесса; следующие узлы отправляют ссылку клиенту и проверяют оплату.

Чтобы добавить действие вручную:

1. Нажмите «Добавить шаг», чтобы открыть каталог узлов.
2. В группе приложений выберите нужный шаг Prodamus: создание ссылки, проверку статуса или ожидание оплаты.

«Создать ссылку на оплату» настраивается во встроенном окне Prodamus. Выберите активный аккаунт и задайте одну фиксированную позицию, название, цену, количество и необязательное описание. Обычный конструктор параметров Senler для этого шага не показывается: одновременно использовать iframe и конструктор нельзя.

Выделите шаг и нажмите «Настроить». На снимке отмечены:

1. Аккаунт Prodamus — выберите платёжную страницу, на которой должен создаваться заказ.
2. «Результат шага» — проверьте имена переменных, куда сохранятся order_id, платёжная ссылка, статус, сумма и код позиции.
3. Позиция и фиксированная цена — задайте товар или услугу, название, цену, количество и необязательное описание.

После заполнения сохраните настройки кнопкой Senler.io вне встроенной страницы.

В блоке «Результат шага» задаются переменные процесса для order_id, payment_url, status, amount_kopecks и item_code. По умолчанию Prodamus предлагает одноимённые переменные, поэтому обычно достаточно сохранить шаг. Имена можно изменить прямо в этом блоке. В следующих шагах значения доступны как {{run.order_id}}, {{run.payment_url}} и так далее; стандартный шаг сообщения может отправить покупателю {{run.payment_url}}.

«Проверить оплату» и «Ждать оплату» принимают входной order_id. Если в процессе уже есть одноимённая переменная, Senler подставляет её автоматически; при необходимости выберите другую. Эти шаги не возвращают order_id повторно: проверка возвращает status и paid, а ожидание — status, paid и необязательный paid_at.

«Проверить оплату» сразу продолжает сценарий через ветку «Оплачено», «Ожидается» или «Не оплачено». «Ждать оплату» приостанавливает запуск до подписанного webhook и продолжает его через итоговую ветку. Ожидание действует не дольше срока callback, показанного платформой.

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

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

Значение	Что означает	Что делать
pending	Ссылка создана, подтверждённая оплата ещё не получена	Предложить покупателю завершить оплату или проверить статус позже
paid: true	Подписанное уведомление проверено, сумма совпала	Можно продолжать оплаченный сценарий

Не считайте скриншот, сообщение покупателя или страницу успеха доказательством оплаты — используйте только сохранённый статус инструмента.