> ## 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.

# Ejemplos de Webhook de pago de WhatsApp actualizado

> Gestiona las actualizaciones del estado de pago de WhatsApp.

<Note>Para consultar el catálogo exhaustivo derivado del esquema, consulta [todos los ejemplos](/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples).</Note>

## Qué es

Gestiona las actualizaciones del estado de pago de WhatsApp.

## Antes de comenzar

* Crea un endpoint HTTPS público en tu aplicación.
* Configura un endpoint de webhook de YCloud para los tipos de eventos que necesites.
* Almacena el secreto de firma del endpoint de forma segura.
* Haz que el procesamiento de eventos sea idempotente.

## Cómo funciona

YCloud envía una solicitud HTTP `POST` cuando ocurre el evento. Verifica la firma, registra el evento de forma duradera, devuelve una respuesta `2xx` y procesa las tareas lentas de forma asíncrona.

## Solicitud

Los escenarios a continuación muestran las solicitudes enviadas a tu URL de webhook. Trata el evento `id` como el identificador de entrega y utiliza `type` para enrutar la carga útil.

## Respuesta

Devuelve un estado `2xx` después de aceptar el evento.

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

<Note>Para la configuración del endpoint, la validación de firmas y el comportamiento de reintentos, consulta [Configurar webhooks](/es/api-reference/guides/api-fundamentals/configure-webhooks).</Note>

## Transacción de pago actualizada

Recibes actualizaciones a través de webhooks cuando cambia el estado de la transacción iniciada por el usuario. Ocurre cuando el estado del pago cambia a `captured` (cuando el pago se completa con éxito) o a `pending` (cuando el usuario lo intentó pero aún no se recibe la señal de transacción exitosa).

### Solicitud

```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"
        }
      }
    ]
  }
}
```

### Respuesta

Confirma la recepción tras aceptar el evento de forma duradera.

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

### Explicación

* Para enviar mensajes con detalles del pedido para recibir pagos, consulta [Mensaje de plantilla de detalles del pedido](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#order-details-template-message) y [Mensaje interactivo de detalles del pedido](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-order-details-message).
* Una vez que el cliente intente realizar el pago, recibirás actualizaciones del pago. Para notificar al cliente el estado del pedido, consulta [Mensaje de plantilla de estado del pedido](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#order-status-template-message) y [Mensaje interactivo de estado del pedido](/es/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.