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

Платежи в один клик | Документация для разработчиков

Платежи в один клик

Обновлено: 14 ноября 2025 г
Эта функция пока недоступна для широкой публики и предназначена только для компаний, расположенных в Бразилии, и их бразильских клиентов. Для включения платежей для ваших компаний, пожалуйста, свяжитесь со своим партнером по решениям.
API для платежей также позволяет компаниям принимать платежи от своих клиентов через WhatsApp с помощью функции «Платежи в один клик».
При использовании этой интеграции WhatsApp облегчает общение между продавцами и покупателями. Продавцы несут ответственность за хранение платежных данных и интеграцию с поставщиком платежных услуг (PSP) для отправки этих данных, завершения и подтверждения платежей.

Прежде чем начать

    Ознакомьтесь с API заказов . Заказы — это точка входа для сбора платежей в WhatsApp.Вам потребуется существующая интеграция с платежным сервисом и автоматическая сверка платежей при их совершении.Статус заказа необходимо обновить сразу после совершения платежа.

    Этапы интеграции

    На следующей диаграмме показана типичная интеграция с системой платежей в один клик.
    Изображение

    1. Отправьте сообщение с подробной информацией о заказе

    Полное руководство по интеграции находится на странице API заказов .
    Если для этого заказа доступна оплата в один клик, вам потребуется указать offsite_card_pay в payment_settings .
    Конечная точка
    POST /{ PHONE_NUMBER_ID }/ messages
    Пример полезной нагрузки
    { "recipient_type": "individual", "to": "<PHONE_NUMBER> ", "type": "interactive", "interactive": { "type": "order_details", "body": { "text": "Содержание вашего сообщения" }, "action": { "name": "review_and_pay", "parameters": { "reference_id": "<UNIQUE_REFERENCE_ID> ", "type": "digital-goods", "payment_type": "br", "payment_settings": [ { "type": "offsite_card_pay", "offsite_card_pay": { "last_four_digits": "5235", "credential_id": "1234567" } } ], "currency": "BRL", "total_amount": { "value": 50000, "offset": 100 }, "order": { "status": "pending", "tax": { "value": 0, "offset": 100, "description": "optional text" }, "items": [ { "retailer_id": "1234567", "name": "Cake", "amount": { "value": 50000, "offset": 100 }, "quantity": 1 } ], "subtotal": { "value": 50000, "смещение": 100 } } } } } }
    Объект параметров
    
Название поля

Необязательный?

Тип

Описание

    настройки оплаты
    Необязательный
    Список объектов конфигурации, связанных с платежами.
    Настройки оплаты
    
Название поля

Необязательный?

Тип

Описание

    тип
    Необходимый
    Нить
    Должно быть offsite_card_pay .
    offsite_card_pay
    Необходимый
    Объект Offsite Card Pay, который будет использоваться для отображения этой опции покупателям в процессе оформления заказа.
    Внешнее устройство для оплаты картой
    Название поляНеобязательный?ТипОписание
    последние_четыре_цифры
    Необходимый
    Нить
    Последние четыре цифры карты, которые будут отображены пользователю для подтверждения перед принятием платежа (при нажатии кнопки «Отправить платеж»).
    credential_id
    Необходимый
    Нить
    Идентификатор учетных данных, связанных с картой. После того, как пользователь нажмет кнопку «Отправить платеж», продавец получит веб-хук от Meta, уведомляющий о подтверждении платежа от пользователя. Полезная нагрузка этого веб-хука будет содержать этот credential_id, который продавец будет использовать для определения карты или учетных данных для платежей.
    2. Получите уведомление веб-перехватчика
    Этот веб-хук подтверждает намерение покупателя совершить платеж и содержит идентификатор учетных данных для использования.
    Пример полезной нагрузки уведомления веб-перехватчика
    { "object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ", "изменения": [ { "значение": { "messaging_product": "whatsapp", "метаданные": { "отображаемый_номер_телефона": "<BUSINESS_DISPLAY_PHONE_NUMBER> ", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID> " }, "контакты": [ { "профиль": { "имя": "<WHATSAPP_USER_NAME> " }, "wa_id": "<WHATSAPP_USER_ID> " } ], "сообщения": [ { "из": "<WHATSAPP_USER_PHONE_NUMBER> ", "идентификатор": "<WHATSAPP_MESSAGE_ID> ", "временная метка": "<WEBHOOK_SENT_TIMESTAMP> ", "from_logical_id": "64244926160970", "type": "interactive", "interactive": { "type": "payment_method", "payment_method": { "payment_method": "offsite_card_pay", "payment_timestamp": 1726170122, "reference_id": "pix_test_webhook", "last_four_digits": "5235", "credential_id": "1234567" } } } ] }, "field": "messages" } ] } ] }
    3. Отправить уведомление о статусе заказа
    После подтверждения платежа необходимо отправить обновление статуса заказа. Следуйте инструкциям по интеграции на странице API заказов .
    
    
            
    
    
    

            
    
        
    
    
    

    
    

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