Webhook de Transferências

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": "withdrawal.paid",
  "id": "e5f6a1b2-c3d4-7890-efgh-4567890abcde",
  "e2e": "b8f2a1c4-...",
  "status": "paid",
  "gross_amount_cents": 50000,
  "net_amount_cents": 49000,
  "pix_key_type": "cpf",
  "pix_key": "12345678909",
  "paid_at": "2026-06-30T11:05:00Z",
  "balance_refunded": false
}

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
withdrawal.paid	Saque efetuado
withdrawal.failed	Saque falhou
withdrawal.canceled	Saque cancelado
withdrawal.refunded	Saque estornado

Fluxo de Exemplo

Solicitação de saque — POST /api/v1/withdraw → saldo debitado

Processamento — o processador efetua a transferência via PIX

Confirmação via Webhook

✅ Em caso de sucesso

Webhook withdrawal.paid → saque concluído

❌ Em caso de falha

Webhook withdrawal.failed → saldo estornado

Payload genérico#

Eventos Disponíveis#

Fluxo de Exemplo#

Payload genérico

Eventos Disponíveis

Fluxo de Exemplo