Перейти к основному содержимому

Платёжные ссылки в IVR и у ИИ-агента

MonoPbx принимает платежи, ни разу не касаясь карты. IVR или ИИ-агент отправляет звонящему платёжную ссылку (Stripe Checkout, Mercado Pago Checkout Pro или платёжную ссылку Conekta) по SMS или WhatsApp. Звонящий платит на странице провайдера, а вебхук провайдера сообщает MonoPbx результат.

Настройка​

  1. Откройте Админ > Подключения > Интеграции, установите провайдера (stripe, mercado_pago или conekta) и вставьте секретный API-ключ (Stripe sk_..., токен доступа Mercado Pago или закрытый ключ Conekta). Ключ запечатывается ключом данных компании и больше не показывается. Необязательные настройки: валюта по умолчанию и страница, на которую возвращается плательщик.
  2. В том же разделе создайте точку входящих хуков для коннектора и зарегистрируйте её адрес https://<host>/hooks/int/<connector>/<install_key> в кабинете провайдера: события Stripe checkout.session.*, уведомления Mercado Pago темы payment, Conekta order.paid, order.declined, order.expired, order.refunded. Для Stripe используйте схему подписи Stripe, для остальных — секрет подписи провайдера.
  3. Разрешите инструменты ИИ send_payment_link и payment_status в установке, если ИИ-агент должен принимать платежи.

Сообщение уходит через бизнес-настройки ИИ компании: номер-отправитель SMS либо канал WhatsApp с утверждённым шаблоном с одним параметром. Без них инструмент отвечает delivery_refused.

В сценарии звонка​

{ "type": "payment_link",
"config": { "provider": "conekta", "amount_var": "amt", "currency": "MXN",
"description": "Deposit", "channel": "whatsapp" },
"next": "thanks", "on_error": "agent" }

Используйте amount_minor (фиксированная сумма в центах) или amount_var (переменная с центами, например из шага collect). Ссылка уходит звонящему или на номер из to_var. Ссылка провайдера сохраняется в payment_ref (или reference_var). Ошибки идут по выходу on_error.

Статусы и события​

Каждая ссылка: pending, затем paid, failed, expired или refunded по вебхуку. Оплаченная ссылка не возвращается назад. Сохраняются только последние четыре цифры номера получателя. Оплаченная или неудавшаяся ссылка один раз порождает события integration.payment_succeeded и integration.payment_failed (провайдер, ссылка, сумма, валюта; никогда не плательщик и не номер).

Без номеров карт​

  • Плательщик вводит карту на странице провайдера, никогда не по телефону.
  • На клавиатуре шаг collect отбрасывает ввод, похожий на номер карты, и идёт по выходу тайм-аута.
  • Номера карт, набранные или произнесённые цифрами, заменяются на [card number removed] до сохранения расшифровки, SMS или сообщения чата.
  • Описание инструмента ИИ с номером карты отклоняется, а модель получает ссылку-идентификатор, но не саму ссылку.

Защита предпочитает маскировать, поэтому 16-значный номер заказа, проходящий контрольную сумму карты, тоже маскируется.