Примеры Webhook для обновления платежей WhatsApp

Полный каталог на основе схемы см. в разделе все примеры.

Что это такое

Обработка обновлений статуса платежей WhatsApp.

Перед началом работы

Создайте общедоступную конечную точку HTTPS в своем приложении.
Настройте конечную точку webhook YCloud для необходимых типов событий.
Надежно сохраните секретный ключ подписи конечной точки.
Обеспечьте идемпотентность обработки событий.

Как это работает

YCloud отправляет HTTP-запрос POST при возникновении события. Проверьте подпись, надежно сохраните событие, верните ответ 2xx и выполняйте длительные операции асинхронно.

Запрос

Ниже приведены примеры запросов, отправляемых на ваш URL вебхука. Используйте id события как идентификатор доставки, а type — для маршрутизации полезной нагрузки.

Ответ

Верните статус 2xx после успешного принятия события.

HTTP/1.1 200 OK

Информацию о настройке конечной точки, проверке подписи и логике повторных попыток см. в разделе Настройка вебхуков.

Транзакция платежа обновлена

Вы получаете обновления через вебхуки при изменении статуса транзакции, инициированной пользователем. Это происходит, когда статус платежа меняется на captured (платеж успешно завершен) или pending (пользователь попытался совершить платеж, но подтверждение успешной транзакции еще не получено).

Запрос

{
  "id": "evt_eEkn26qar3nOB8md",
  "type": "whatsapp.payment.updated",
  "apiVersion": "v2",
  "createTime": "2024-10-10T07:08:00.000Z",
  "whatsappPayment": {
    "wabaId": "WABA-ID",
    "referenceId": "<reference-id>",
    "status": "captured | pending",
    "transactions": [
      {
        "id": "<transaction-id>",
        "type": "billdesk | payu | razorpay | zaakpay",
        "status": "pending | success | failed",
        "createdTimestamp": 1728544066000,
        "updatedTimestamp": 1728544066000,
        "amount": {
          "value": 21000,
          "offset": 100
        },
        "currency": "INR",
        "methodType": "upi | card | wallet | netbanking",
        "error": {
          "code": "error-code",
          "reason": "error-reason"
        }
      }
    ]
  }
}

Ответ

Подтвердите доставку после надежного сохранения события.

HTTP/1.1 200 OK

Пояснение

Информацию об отправке сообщений с деталями заказа для приема платежей см. в разделах Шаблонное сообщение с деталями заказа и Интерактивное сообщение с деталями заказа.
Как только клиент попытается совершить оплату, вы начнете получать обновления статуса платежа. Чтобы уведомить клиента о статусе заказа, см. разделы Шаблонное сообщение со статусом заказа и Интерактивное сообщение со статусом заказа.

Начало работы

Руководства

Конечные точки

Webhooks

Примеры Webhook для обновления платежей WhatsApp

Что это такое

Перед началом работы

Как это работает

Запрос

Ответ

Транзакция платежа обновлена

Запрос

Ответ

Пояснение

​Что это такое

​Перед началом работы

​Как это работает

​Запрос

​Ответ

​Транзакция платежа обновлена

​Запрос

​Ответ

​Пояснение

Что это такое

Перед началом работы

Как это работает

Запрос

Ответ

Транзакция платежа обновлена

Запрос

Ответ

Пояснение