> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

<Note>Полный каталог на основе схемы см. в разделе [все примеры](/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples).</Note>

## Что это такое

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

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

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

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

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

## Запрос

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

## Ответ

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

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

<Note>Информацию о настройке конечной точки, проверке подписи и логике повторных попыток см. в разделе [Настройка вебхуков](/ru/api-reference/guides/api-fundamentals/configure-webhooks).</Note>

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

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

### Запрос

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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 theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

### Пояснение

* Информацию об отправке сообщений с деталями заказа для приема платежей см. в разделах [Шаблонное сообщение с деталями заказа](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#order-details-template-message) и [Интерактивное сообщение с деталями заказа](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-order-details-message).
* Как только клиент попытается совершить оплату, вы начнете получать обновления статуса платежа. Чтобы уведомить клиента о статусе заказа, см. разделы [Шаблонное сообщение со статусом заказа](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#order-status-template-message) и [Интерактивное сообщение со статусом заказа](/ru/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-order-status-message).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.