Visão Geral

O que são Webhooks?

Os webhooks da Cakto enviam uma requisição POST com informações sobre cada pedido assim que um evento ocorre na plataforma.

A Cakto interpreta qualquer resposta do seu sistema como entregue com sucesso. Não é necessário retornar um status específico.

Cada requisição de webhook contém três campos principais:

Campo	Descrição
`secret`	Chave secreta configurada por você para validar a autenticidade da chamada
`event`	Identificador do tipo de evento ocorrido
`data`	Objeto com todos os detalhes da transação

Use o campo event presente em todos os payloads para identificar o tipo de notificação e processar cada caso adequadamente.

{
  "secret": "sua-chave-secreta",
  "event": "purchase_approved",
  "data": { ... }
}

Sempre valide o campo secret antes de processar qualquer evento para garantir que a requisição veio da Cakto.