Webhook de Transações

Webhooks são configurados direto no painel: acesse Integrações → Webhooks, cadastre a URL de destino e escolha quais eventos ela deve receber.

Ao cadastrar um webhook você recebe um código exclusivo, enviado em toda notificação no header X-Webhook-Code. Compare esse valor no seu endpoint para confirmar que a chamada veio da nossa plataforma (comparação simples de string — não é uma assinatura HMAC):

O código pode ser regenerado a qualquer momento pelo painel, caso precise invalidar o anterior.

Payload genérico

O id é o identificador que retornamos na criação da transação — use-o pra casar a notificação com o registro do seu lado. Já e2e só existe depois que o pagamento é confirmado pelo provider, então pode vir null em eventos anteriores a isso.

{
  "event": "transaction.paid",
  "id": "uuid",
  "e2e": "uuid",
  "status": "paid",
  "gross_amount_cents": 10000,
  "net_amount_cents": 9800,
  "paid_at": "2026-06-30T10:05:00Z",
  "metadata": { "pedido_id": "12345" }
}

Eventos Disponíveis

Estes são os eventos enviados para a URL configurada no painel ou informada no campo postback_url da requisição.

Evento	Descrição
transaction.paid	Pagamento confirmado
transaction.failed	Pagamento falhou
transaction.canceled	Cancelada
transaction.refunded	Estorno

Fluxo de Exemplo

Solicitação de deposito — POST /api/v1/deposit

Processamento — o processador recebe a transferência via PIX

Confirmação via Webhook

✅ Em caso de sucesso

Webhook transaction.paid → saque concluído

❌ Em caso de falha

Webhook transaction.failed → saldo estornado

Payload genérico#

Eventos Disponíveis#

Fluxo de Exemplo#

Payload genérico

Eventos Disponíveis

Fluxo de Exemplo