Skip to main content
Para obter o catálogo completo derivado do esquema, consulte todos os exemplos.

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.
Para configuração do endpoint, validação de assinatura e comportamento de repetição, consulte Configurar webhooks.

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

Resposta

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

Explicação