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

# Exemplos de Webhook de Pagamento Atualizado do WhatsApp

> Processe atualizações de status de pagamento do WhatsApp.

<Note>Para obter o catálogo completo derivado do esquema, consulte [todos os exemplos](/pt/api-reference/guides/examples/webhook-examples/webhook-payload-examples).</Note>

## O que é

Processe atualizações de status de pagamento do WhatsApp.

## Antes de começar

* Crie um endpoint HTTPS público em sua aplicação.
* Configure um endpoint de webhook da YCloud para os tipos de eventos necessários.
* Armazene o segredo de assinatura do endpoint com segurança.
* Torne o processamento de eventos idempotente.

## Como funciona

A YCloud envia uma requisição HTTP `POST` quando o evento ocorre. Verifique a assinatura, registre o evento de forma durável, retorne uma resposta `2xx` e processe tarefas lentas de forma assíncrona.

## Requisição

Os cenários abaixo mostram requisições entregues ao seu URL de webhook. Trate o `id` do evento como o identificador de entrega e use `type` para rotear o payload.

## Resposta

Retorne um status `2xx` após aceitar o evento.

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

<Note>Para configuração do endpoint, validação de assinatura e comportamento de repetição, consulte [Configurar webhooks](/pt/api-reference/guides/api-fundamentals/configure-webhooks).</Note>

## Transação de pagamento atualizada

Você recebe atualizações via webhooks quando o status da transação iniciada pelo usuário é alterado. Isso ocorre quando o status do pagamento muda para `captured` (quando o pagamento é concluído com sucesso) ou `pending` (quando o usuário tentou, mas ainda não recebeu a confirmação de transação bem-sucedida).

### Requisição

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

### Resposta

Confirme a entrega após aceitar o evento de forma durável.

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

### Explicação

* Para enviar mensagens com detalhes do pedido a fim de receber pagamentos, consulte [Mensagem de modelo de detalhes do pedido](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#order-details-template-message) e [Mensagem interativa de detalhes do pedido](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-order-details-message).
* Assim que o cliente tentar realizar o pagamento, você receberá atualizações de pagamento. Para notificar o cliente sobre o status do pedido, consulte [Mensagem de modelo de status do pedido](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#order-status-template-message) e [Mensagem interativa de status do pedido](/pt/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.