Платёжные ссылки в IVR и у ИИ-агента
MonoPbx принимает платежи, ни разу не касаясь карты. IVR или ИИ-агент отправляет звонящему платёжную ссылку (Stripe Checkout, Mercado Pago Checkout Pro или платёжную ссылку Conekta) по SMS или WhatsApp. Звонящий платит на странице провайдера, а вебхук провайдера сообщает MonoPbx результат.
Настройка
- Откройте Админ > Подключения > Интеграции, установите провайдера (
stripe,mercado_pagoилиconekta) и вставьте секретный API-ключ (Stripesk_..., токен доступа Mercado Pago или закрытый ключ Conekta). Ключ запечатывается ключом данных компании и больше не показывается. Необязательные настройки: валюта по умолчанию и страница, на которую возвращается плательщик. - В том же разделе создайте точку входящих хуков для коннектора и зарегистрируйте её адрес
https://<host>/hooks/int/<connector>/<install_key>в кабинете провайдера: события Stripecheckout.session.*, уведомления Mercado Pago темыpayment, Conektaorder.paid,order.declined,order.expired,order.refunded. Для Stripe используйте схему подписи Stripe, для остальных — секрет подписи провайдера. - Разрешите инструменты ИИ
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-значный номер заказа, проходящий контрольную сумму карты, тоже маскируется.