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 HTTPPOST 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 oid do evento como o identificador de entrega e use type para rotear o payload.
Resposta
Retorne um status2xx 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 paracaptured (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
- Para enviar mensagens com detalhes do pedido a fim de receber pagamentos, consulte Mensagem de modelo de detalhes do pedido e Mensagem interativa de detalhes do pedido.
- 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 e Mensagem interativa de status do pedido.

