Улучшенные ссылки для оплаты | Документация для разработчиков
Улучшенные ссылки для оплаты
Обновлено: 12 декабря 2025 г
Обзор
Функция «Расширенные платежные ссылки» преобразует существующие URL-адреса платежных шлюзов в удобные и интуитивно понятные платежные интерфейсы внутри WhatsApp.
Это преобразует существующие платежные ссылки в процесс оформления заказа внутри приложения — никаких изменений в вашей платежной системе, сверке или настройке обратных вызовов не требуется. Когда поддерживаемая платежная ссылка отправляется через шаблон сообщения, она автоматически отображается в виде структурированного платежного окна, содержащего:
Эта функция значительно повышает коэффициент конверсии платежей за счет снижения сложностей при оформлении заказа и повышения доверия потребителей.
Сверхбыстрая настройка : продавцы могут самостоятельно создавать необходимые шаблоны WhatsApp и встраивать платежные ссылки из поддерживаемых платежных шлюзов — участие BSP не требуется.
Эта функция пока недоступна для широкой публики. Чтобы запросить доступ, пожалуйста, свяжитесь с представителем BSP или Meta, указав свой WABA ID , пример платежной ссылки и предпочтительный платежный шлюз (Razorpay, PayU или Cashfree).
Пользовательский опыт
В поддерживаемых версиях WhatsApp ссылка для оплаты отображается в виде улучшенного всплывающего окна:
Предварительные требования
Расширенные платежные ссылки — это функция, которая работает как с существующими API BSP, так и с API WhatsApp Business Cloud. Ни BSP, ни продавцам не нужно вносить какие-либо изменения в бэкэнд, API, сверку или обратные вызовы для включения этой функции. Ваша существующая интеграция с платежным шлюзом остается полностью неизменной.
Для использования расширенных платежных ссылок:
| Требование | Описание |
|---|---|
Список разрешенных WABA | Для использования расширенных платежных ссылок необходимо активировать ваш WABA ID. Отправьте запрос представителю вашей BSP или Meta, указав свой WABA ID, предпочтительный(е) платежный(е) шлюз(ы) и примеры платежных ссылок для проверки. |
Поддерживаемые платежные шлюзы | Активный аккаунт в Razorpay, PayU или Cashfree |
Соответствующий шаблон | Шаблон сообщения, настроенный без заголовка и с динамической кнопкой URL (см. Требования к шаблону ). |
Поддерживаемые платежные шлюзы
| Платежный шлюз | Статус |
|---|---|
Razorpay | ✅ Поддерживается |
PayU | ✅ Поддерживается |
Безналичный расчет | ✅ Поддерживается |
Интеграционный поток
Следующая диаграмма иллюстрирует весь процесс от отправки расширенной ссылки для оплаты до завершения платежа и обратных звонков:
Шаги:
https://rzp.io/i/abc123XYZ ).Отправка шаблонного сообщения — ваш сервер отправляет шаблонное сообщение через Cloud API или ваш BSP, встраивая динамическую часть платежной ссылки (суффикс) в компонент кнопки.Сообщение, отправленное в WhatsApp : потребитель получает расширенное окно оплаты с указанием суммы, валюты и кнопкой «Оплатить сейчас» для оформления заказа в приложении.Потребитель завершает оплату — потребитель нажимает кнопку «Оплатить сейчас» и оплачивает через приложения UPI, банковские карты, интернет-банкинг или электронные кошельки в WhatsApp.Платежный шлюз отправляет обратный вызов продавцу — ваша существующая конечная точка веб-перехватчика получает обратный вызов о статусе платежа с тем же форматом полезной нагрузки, что и раньше. Никаких изменений в URL-адресе веб-перехватчика, обработке полезной нагрузки или логике сверки не требуется.WhatsApp обновляет платежную карту — платежная карта автоматически отображает статус платежа (успешно или истекает) и отключает кнопку «Оплатить сейчас», чтобы предотвратить повторные платежи. Это происходит независимо и не требует никаких действий от продавца.Требования к шаблону
Шаблоны расширенных платежных ссылок должны соответствовать следующим ограничениям:
| Компонент | Требование |
|---|---|
Заголовок | Никаких ограничений — шаблоны не содержать заголовок с медиафайлами (изображением, видео или документом). |
Кнопка | Ровно одна динамическая кнопка URL с поддерживаемым префиксом ссылки PG. |
Продавцы могут самостоятельно создавать эти шаблоны, не привлекая своего поставщика бизнес-услуг (BSP). Шаблоны можно создавать любым из следующих способов:
Пример конфигурации шаблона
Ваш бизнес может предоставить клиентам возможность оплачивать покупки с помощью их любимых приложений UPI или других способов оплаты, принимаемых поддерживающими платежными шлюзами, не покидая WhatsApp.
Текст сообщения : "Привет 1, напоминание об оплате продления страховки #2. Сумма: ₹3" Кнопка : - Тип действия : " на сайт" - Текст кнопки : "Оплатить сейчас " - Тип URL : Динамический - URL сайта : https://pg.io/i/Важно : URL-адрес кнопки должен быть настроен как динамический чтобы при отправке платежной ссылки выполнялась корректная обработка.
Динамическая настройка префикса URL
При создании шаблона для динамической кнопки URL требуется префикс URL , соответствующий домену вашего платежного шлюза. Используйте один из следующих префиксов в зависимости от вашего платежного шлюза:
Razorpay
| Префикс URL |
|---|
https://rzp.io/rzp/ |
https://rzp.io/i/ |
PayU
| Префикс URL |
|---|
https://pmny.in/PAYUMN/ |
https://api.payu.in/ |
https://u.payu.in/PAYUMN/ |
Безналичный расчет
| Префикс URL |
|---|
https://payments.cashfree.com/links |
https://payments.cashfree.com/link/ |
https://cfre.in/CSHFRE/ |
Примечание : префикс URL-адреса, который вы указываете в шаблоне, должен соответствовать формату платежных ссылок, генерируемых вашей платежной системой. При отправке сообщения передавайте в параметр кнопки только динамическую часть (например, идентификатор ссылки).
Требования к платежной ссылке
| Требование | Подробности |
|---|---|
Среда | Данные должны быть получены в производственной среде (а не в песочнице/тестовом режиме) |
Статус | Ссылка должна быть активной и не просроченной |
Врата | Платеж должен осуществляться через поддерживаемый платежный шлюз (см. Поддерживаемые платежные шлюзы ). |
Формат URL | Должно совпадать с одним из поддерживаемых префиксов URL для вашего PG |
Используете обернутые или перенаправленные платежные ссылки? Для расширенных платежных ссылок требуются прямые URL-адреса платежных шлюзов, соответствующие поддерживаемым префиксам URL . Если ваша реализация обертывает ссылки платежного шлюза под вашим собственным доменом (например,
yourdomain.com/pay/... ) или перенаправляет на платежный шлюз со страницы, размещенной на вашем сервере, расширенные возможности не будут отображаться автоматически. В таких случаях вам потребуется обновить свой рабочий процесс, чтобы передавать прямую ссылку платежного шлюза в кнопке шаблона вместо обернутого или перенаправленного URL-адреса.Создание платежных ссылок
Обратитесь к документации вашей платежной системы:
Отправка платежных ссылок
Используйте Cloud API для отправки шаблона, содержащего ссылку для оплаты.
Запрос
POST /{ phone - number - id }/ messagesПример
curl - X POST "https://graph.facebook.com/v21.0/{PHONE_NUMBER_ID}/messages" \ - H "Authorization: Bearer {ACCESS_TOKEN}" \ - H "Content-Type: application/json" \ - d '{ "messaging_product": "whatsapp", "to": "919876543210", "type": "template", "template": { "name": "payment_reminder", "language": { "code": "en" }, "components": [ { "type": "body", "parameters": [ {"type": "text", "text": "Rishi"}, {"type": "text", "text": "ORD-12345"}, {"type": "text", "text": "1,999"} ] }, { "type": "button", "sub_type": "url", "индекс": "0", "параметры": [ { "тип": "текст", "текст": "abc123XYZ" } ] } ] } }'В этом примере, если префикс шаблонного URL — https://pg.io/i/, то конечный URL станет https://pg.io/i/abc123XYZ.
Суффикс ссылки для оплаты передается в компонент кнопки:
{
"type"
: "button" , "sub_type"
: "url" , "index"
: "0" , "parameters"
: [ {
"type"
: "text" , "text"
: "{PAYMENT_LINK_SUFFIX}" }
]
}
| Поле | Тип | Описание |
|---|---|---|
тип | нить | Должно быть «кнопка» |
подтип | нить | Должно быть «url» |
индекс | нить | Индекс кнопки: «0» для первой кнопки |
параметры[].тип | нить | Должно быть «текстом» |
параметры[].текст | нить | Динамическая часть URL-адреса платежной ссылки (добавляется к префиксу URL-адреса шаблона) |
Сверка платежей и обратные звонки
Расширенные платежные ссылки не вносят изменений в вашу существующую систему обработки платежей или внутреннюю инфраструктуру. Это означает:
| Аспект | Влияние |
|---|---|
Обратные вызовы/веб-хуки для платежей | Без изменений. Ваши существующие конечные точки веб-перехватчиков и потоки обратного вызова от платежного шлюза продолжают работать как обычно. |
Примирение | Без изменений. Процедура сверки остается такой же, как настроена в вашем платежном шлюзе (Razorpay, PayU или Cashfree). |
Урегулирование | Без изменений. Расчетные потоки и сроки остаются без изменений. |
Для внедрения расширенных платежных ссылок не требуется вносить изменения в интеграцию с бэкэндом.
Отчетность
Отчетность по расширенным платежным системам формируется на основе данных из двух источников:
| Метрика | Источник | Подробности |
|---|---|---|
клики по ссылкам | WhatsApp | Показатели кликов по ссылкам платежных шлюзов доступны в аналитике WhatsApp. |
Статус платежей, процент успешных/неудачных операций, возвраты средств, расчеты | Платежный шлюз | Вся отчетность по платежам по-прежнему осуществляется через ваш платежный шлюз (Razorpay, PayU или Cashfree). Используйте существующие панели мониторинга и отчеты. |
Дополнительная настройка отчетов не требуется. WhatsApp обеспечивает прозрачность в отношении взаимодействия по ссылкам, а ваш платежный шлюз остается источником достоверной информации по всем показателям платежей и транзакций.
Передовые методы
| Упражняться | Подробности |
|---|---|
Используйте производственные ссылки | Ссылки в тестовой/песочнице не будут отображать улучшенные всплывающие окна |
Установить разумный срок действия | Конвертация баланса и обеспечение безопасности в течение 24-48 часов |
Укажите контекст | Укажите сумму и детали заказа в тексте сообщения |
Всего одна кнопка | Поддержка нескольких кнопок отсутствует |
Соответствует префиксу URL | Убедитесь, что префикс URL-адреса шаблона соответствует формату ссылки вашего PG |
Ограничения
Поиск неисправностей
Платежная ссылка не отображается в виде всплывающего окна
| Проверять | Действие |
|---|---|
Включен ли WABA в список разрешенных организаций? | Уточните информацию у представителя BSP или Meta |
Поддерживается PG? | Необходимо использовать Razorpay, PayU или Cashfree |
Правильный ли префикс URL? | Префикс URL-адреса шаблона должен соответствовать форматам, поддерживаемым вашей группой разработчиков |
Ссылка активна? | Проверьте, не истек ли срок действия ссылки |
Соответствует ли шаблон требованиям? | Без заголовка, одна динамическая кнопка URL |
Примечание : Если ваш шаблон был неправильно отнесен к какой-либо категории, вы можете обжаловать присвоенную категорию. Подробную информацию о процессе обжалования в Руководстве по категоризации шаблонов вспомогательного шаблона из библиотеки шаблонов. Это гарантирует правильную категоризацию и предоставляет рекомендации по структуре содержимого шаблона.