Улучшенные ссылки для оплаты | Документация для разработчиков
Улучшенные ссылки для оплаты
Обновлено: 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
https://rzp.io/rzp/https://rzp.io/i/PayU
https://pmny.in/PAYUMN/https://api.payu.in/https://u.payu.in/PAYUMN/Безналичный расчет
https://payments.cashfree.com/linkshttps://payments.cashfree.com/link/https://cfre.in/CSHFRE/Примечание : префикс URL-адреса, который вы указываете в шаблоне, должен соответствовать формату платежных ссылок, генерируемых вашей платежной системой. При отправке сообщения передавайте в параметр кнопки только динамическую часть (например, идентификатор ссылки).
Требования к платежной ссылке
Среда
Данные должны быть получены в производственной среде (а не в песочнице/тестовом режиме)
Статус
Ссылка должна быть активной и не просроченной
Врата
Платеж должен осуществляться через поддерживаемый платежный шлюз (см. Поддерживаемые платежные шлюзы ).
Формат URL
Должно совпадать с одним из поддерживаемых префиксов URL для вашего PG
Используете обернутые или перенаправленные платежные ссылки? Для расширенных платежных ссылок требуются прямые URL-адреса платежных шлюзов, соответствующие поддерживаемым префиксам URL . Если ваша реализация обертывает ссылки платежного шлюза под вашим собственным доменом (например,
yourdomain.com/pay/... ) или перенаправляет на платежный шлюз со страницы, размещенной на вашем сервере, расширенные возможности не будут отображаться автоматически. В таких случаях вам потребуется обновить свой рабочий процесс, чтобы передавать прямую ссылку платежного шлюза в кнопке шаблона вместо обернутого или перенаправленного URL-адреса.Создание платежных ссылок
Обратитесь к документации вашей платежной системы:
Отправка
Ссылки для оплаты
Запрос
ПОЧТА /{телефон-number-идентификатор}/сообщенияПример
локон -X POST "https://graph.facebook.com/v21.0/{PHONE_NUMBER_ID}/messages" \
-ЧАС "Authorization: Bearer {ACCESS_TOKEN}" \
-ЧАС "Content-Type: application/json" \
-д '{ "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", "index": "0", "parameters": [ { "type": "text", "text": "abc123XYZ" } ] } ] } }'{"тип":"кнопка","sub_type":"url","индекс":"0","параметры": [{"тип":"текст","текст":"{PAYMENT_LINK_SUFFIX}"}]}
Сверка платежей и обратные звонки
Расширенные платежные ссылки не вносят изменений в вашу существующую систему обработки платежей или внутреннюю инфраструктуру. Это означает:
Обратные вызовы/веб-хуки для платежей
Без изменений. Ваши существующие конечные точки веб-перехватчиков и потоки обратного вызова от платежного шлюза продолжают работать как обычно.
Примирение
Без изменений. Процедура сверки остается такой же, как настроена в вашем платежном шлюзе (Razorpay, PayU или Cashfree).
Урегулирование
Без изменений. Расчетные потоки и сроки остаются без изменений.
Для внедрения расширенных платежных ссылок не требуется вносить изменения в интеграцию с бэкэндом.
Отчетность
Отчетность по расширенным платежным системам формируется на основе данных из двух источников:
клики по ссылкам
WhatsApp
Показатели кликов по ссылкам платежных шлюзов доступны в аналитике WhatsApp.
Статус платежей, процент успешных/неудачных операций, возвраты средств, расчеты
Платежный шлюз
Вся отчетность по платежам по-прежнему осуществляется через ваш платежный шлюз (Razorpay, PayU или Cashfree). Используйте существующие панели мониторинга и отчеты.
Дополнительная настройка отчетов не требуется. WhatsApp обеспечивает прозрачность в отношении взаимодействия по ссылкам, а ваш платежный шлюз остается источником достоверной информации по всем показателям платежей и транзакций.
Передовые методы
Используйте производственные ссылки
Ссылки в тестовой/песочнице не будут отображать улучшенные всплывающие окна
Установить разумный срок действия
Конвертация баланса и обеспечение безопасности в течение 24-48 часов
Укажите контекст
Укажите сумму и детали заказа в тексте сообщения
Всего одна кнопка
Поддержка нескольких кнопок отсутствует
Соответствует префиксу URL
Убедитесь, что префикс URL-адреса шаблона соответствует формату ссылки вашего PG
Ограничения
Поиск неисправностей
Платежная ссылка не отображается в виде всплывающего окна
Включен ли WABA в список разрешенных организаций?
Уточните информацию у представителя BSP или Meta
Поддерживается PG?
Необходимо использовать Razorpay, PayU или Cashfree
Правильный ли префикс URL?
Префикс URL-адреса шаблона должен соответствовать форматам, поддерживаемым вашей группой разработчиков
Ссылка активна?
Проверьте, не истек ли срок действия ссылки
Соответствует ли шаблон требованиям?
Без заголовка, одна динамическая кнопка URL
Примечание : Если ваш шаблон был неправильно отнесен к какой-либо категории, вы можете обжаловать присвоенную категорию. Подробную информацию о процессе обжалования в Руководстве по категоризации шаблонов вспомогательного шаблона из библиотеки шаблонов. Это гарантирует правильную категоризацию и предоставляет рекомендации по структуре содержимого шаблона.