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

Улучшенные ссылки для оплаты | Документация для разработчиков

Улучшенные ссылки для оплаты

Обновлено: 12 декабря 2025 г

Обзор

Функция «Расширенные платежные ссылки» преобразует существующие URL-адреса платежных шлюзов в удобные и интуитивно понятные платежные интерфейсы внутри WhatsApp.
Это преобразует существующие платежные ссылки в процесс оформления заказа внутри приложения — никаких изменений в вашей платежной системе, сверке или настройке обратных вызовов не требуется. Когда поддерживаемая платежная ссылка отправляется через шаблон сообщения, она автоматически отображается в виде структурированного платежного окна, содержащего:
    Сумма и валюта отображаются четко.Кнопка «Оплатить сейчас» для удобного оформления заказаОплата через приложение с помощью UPI Intent или размещенной страницы оплаты.
    Эта функция значительно повышает коэффициент конверсии платежей за счет снижения сложностей при оформлении заказа и повышения доверия потребителей.
    Сверхбыстрая настройка : продавцы могут самостоятельно создавать необходимые шаблоны WhatsApp и встраивать платежные ссылки из поддерживаемых платежных шлюзов — участие BSP не требуется.
    Эта функция пока недоступна для широкой публики. Чтобы запросить доступ, пожалуйста, свяжитесь с представителем BSP или Meta, указав свой WABA ID , пример платежной ссылки и предпочтительный платежный шлюз (Razorpay, PayU или Cashfree).

    Пользовательский опыт

    В поддерживаемых версиях WhatsApp ссылка для оплаты отображается в виде улучшенного всплывающего окна:
    Изображение
      Расширенная платежная карта : отображает сумму, валюту и кнопку призыва к действию.Оформление заказа внутри приложения:
        UPI : Прямое переключение на приложения UPI (Google Pay, PhonePe, Paytm и др.)Другие способы : встроенный браузер в приложении для работы с картами, интернет-банкинг или электронные кошельки.Автоматическое обновление статуса : информация о платежной карте автоматически обновляется в зависимости от завершения или истечения срока действия платежа, а также отключается кнопка «Оплатить сейчас», чтобы предотвратить повторные платежи.

        Предварительные требования

        Расширенные платежные ссылки — это функция, которая работает как с существующими API BSP, так и с API WhatsApp Business Cloud. Ни BSP, ни продавцам не нужно вносить какие-либо изменения в бэкэнд, API, сверку или обратные вызовы для включения этой функции. Ваша существующая интеграция с платежным шлюзом остается полностью неизменной.
        Для использования расширенных платежных ссылок:
        Требование Описание
        Список разрешенных WABA
        Для использования расширенных платежных ссылок необходимо активировать ваш WABA ID. Отправьте запрос представителю вашей BSP или Meta, указав свой WABA ID, предпочтительный(е) платежный(е) шлюз(ы) и примеры платежных ссылок для проверки.
        Поддерживаемые платежные шлюзы
        Активный аккаунт в Razorpay, PayU или Cashfree
        Соответствующий шаблон
        Шаблон сообщения, настроенный без заголовка и с динамической кнопкой URL (см. Требования к шаблону ).

        Поддерживаемые платежные шлюзы

        Платежный шлюз Статус
        Razorpay
        ✅ Поддерживается
        PayU
        ✅ Поддерживается
        Безналичный расчет
        ✅ Поддерживается

        Интеграционный поток

        Следующая диаграмма иллюстрирует весь процесс от отправки расширенной ссылки для оплаты до завершения платежа и обратных звонков:
        Сквозной процесс EPL: продавец создает платежную ссылку через PG, отправляет шаблонное сообщение, потребитель оплачивает покупку в приложении, PG отправляет веб-хук продавцу (без изменений), WhatsApp автоматически обновляет данные платежной карты
        Шаги:
          Создание платежной ссылки — ваш сервер обращается к API платежного шлюза (Razorpay, PayU или Cashfree) для создания платежной ссылки для транзакции.URL-адрес ссылки для получения платежа — платежный шлюз возвращает URL-адрес (например, https://rzp.io/i/abc123XYZ ).Отправка шаблонного сообщения — ваш сервер отправляет шаблонное сообщение через Cloud API или ваш BSP, встраивая динамическую часть платежной ссылки (суффикс) в компонент кнопки.Сообщение, отправленное в WhatsApp : потребитель получает расширенное окно оплаты с указанием суммы, валюты и кнопкой «Оплатить сейчас» для оформления заказа в приложении.Потребитель завершает оплату — потребитель нажимает кнопку «Оплатить сейчас» и оплачивает через приложения UPI, банковские карты, интернет-банкинг или электронные кошельки в WhatsApp.Платежный шлюз отправляет обратный вызов продавцу — ваша существующая конечная точка веб-перехватчика получает обратный вызов о статусе платежа с тем же форматом полезной нагрузки, что и раньше. Никаких изменений в URL-адресе веб-перехватчика, обработке полезной нагрузки или логике сверки не требуется.WhatsApp обновляет платежную карту — платежная карта автоматически отображает статус платежа (успешно или истекает) и отключает кнопку «Оплатить сейчас», чтобы предотвратить повторные платежи. Это происходит независимо и не требует никаких действий от продавца.

          Требования к шаблону

          Шаблоны расширенных платежных ссылок должны соответствовать следующим ограничениям:
          Компонент Требование
          Заголовок
          Никаких ограничений — шаблоны не содержать заголовок с медиафайлами (изображением, видео или документом).
          Кнопка
          Ровно одна динамическая кнопка URL с поддерживаемым префиксом ссылки PG.
          Продавцы могут самостоятельно создавать эти шаблоны, не привлекая своего поставщика бизнес-услуг (BSP). Шаблоны можно создавать любым из следующих способов:
            Библиотека шаблонов (рекомендуется)Менеджер WhatsApp⁠API управления бизнесомПанель мониторинга 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-адреса.

            Создание платежных ссылок

            Обратитесь к документации вашей платежной системы:
              Razorpay : Создание платежной ссылки (API) ⁠ Панель управления ⁠PayU : ссылки для оплатыCashfree : Ссылки для оплаты

              Сверка платежей и обратные звонки

              Расширенные платежные ссылки не вносят изменений в вашу существующую систему обработки платежей или внутреннюю инфраструктуру. Это означает:
              Аспект Влияние
              Обратные вызовы/веб-хуки для платежей
              Без изменений. Ваши существующие конечные точки веб-перехватчиков и потоки обратного вызова от платежного шлюза продолжают работать как обычно.
              Примирение
              Без изменений. Процедура сверки остается такой же, как настроена в вашем платежном шлюзе (Razorpay, PayU или Cashfree).
              Урегулирование
              Без изменений. Расчетные потоки и сроки остаются без изменений.
              Для внедрения расширенных платежных ссылок не требуется вносить изменения в интеграцию с бэкэндом.

              Отчетность

              Отчетность по расширенным платежным системам формируется на основе данных из двух источников:
              Метрика Источник Подробности
              клики по ссылкам
              WhatsApp
              Показатели кликов по ссылкам платежных шлюзов доступны в аналитике WhatsApp.
              Статус платежей, процент успешных/неудачных операций, возвраты средств, расчеты
              Платежный шлюз
              Вся отчетность по платежам по-прежнему осуществляется через ваш платежный шлюз (Razorpay, PayU или Cashfree). Используйте существующие панели мониторинга и отчеты.
              Дополнительная настройка отчетов не требуется. WhatsApp обеспечивает прозрачность в отношении взаимодействия по ссылкам, а ваш платежный шлюз остается источником достоверной информации по всем показателям платежей и транзакций.

              Передовые методы

              Упражняться Подробности
              Используйте производственные ссылки
              Ссылки в тестовой/песочнице не будут отображать улучшенные всплывающие окна
              Установить разумный срок действия
              Конвертация баланса и обеспечение безопасности в течение 24-48 часов
              Укажите контекст
              Укажите сумму и детали заказа в тексте сообщения
              Всего одна кнопка
              Поддержка нескольких кнопок отсутствует
              Соответствует префиксу URL
              Убедитесь, что префикс URL-адреса шаблона соответствует формату ссылки вашего PG

              Ограничения

                В каждом шаблонном сообщении должна быть только одна ссылка для оплаты Компоненты заголовка Требуется всего одна кнопкаУлучшенное отображение зависит от версии WhatsApp, установленной у получателяВ настоящее время доступно только Индии Поведение показателей платежей : Расширенные платежные ссылки создают UPI-интент при каждом нажатии кнопки «Оплатить сейчас». Это означает:
                  Общее количество попыток оплаты будет выше, чем до начала Премьер-лигиИстекшие намерения регистрируются как неудачные, что может завышать показатели неудач (например, веб-хуки Razorpay для истекших намерений UPI: «Платеж не удался, так как вы не смогли завершить его вовремя»)Рекомендация : При расчете показателей успешности исключайте ошибки, связанные с истечением срока действия платежа.

                  Поиск неисправностей

                  Проверять Действие
                  Включен ли WABA в список разрешенных организаций?
                  Уточните информацию у представителя BSP или Meta
                  Поддерживается PG?
                  Необходимо использовать Razorpay, PayU или Cashfree
                  Правильный ли префикс URL?
                  Префикс URL-адреса шаблона должен соответствовать форматам, поддерживаемым вашей группой разработчиков
                  Ссылка активна?
                  Проверьте, не истек ли срок действия ссылки
                  Соответствует ли шаблон требованиям?
                  Без заголовка, одна динамическая кнопка URL
                  Примечание : Если ваш шаблон был неправильно отнесен к какой-либо категории, вы можете обжаловать присвоенную категорию. Подробную информацию о процессе обжалования в Руководстве по категоризации шаблонов вспомогательного шаблона из библиотеки шаблонов. Это гарантирует правильную категоризацию и предоставляет рекомендации по структуре содержимого шаблона.

                  Получение помощи

                    Пользователи API напрямую или компании, использующие Meta Managed Businesses : свяжитесь с представителем Meta.Партнеры BSP : Обратитесь к своему BSP за поддержкой в ​​интеграции.Проблемы с платежным шлюзом : обратитесь к документации вашего платежного шлюза или в службу поддержки.

                    Комментарии отсутствуют

                    Вернуться наверх