Webhooks

Webhooks avisam sua aplicação quando o status de uma cobrança, payout ou assinatura muda. Sem polling: a plataforma chama a URL que você configurou.

Configure a URL em cada cobrança (campo webhook_url) ou no portal do lojista. A plataforma envia um POST com o payload abaixo sempre que o status muda.

Webhook de cobrança

POST https://your-store.com/webhook/charge

{
  "charge_uuid": "c3d4e5f6-7a8b-9c0d-1e2f-3a4b5c6d7e8f",
  "wallet_uuid": "00000000-0000-0000-0000-000000000000",
  "description": "Order #1234",
  "status": "paid",
  "installment_count": 3,
  "reference_external_id": "ORDER-1234",
  "subscription_uuid": null
}

Webhook de payout

POST https://your-store.com/webhook/payout

{
  "payout_uuid": "1c2d3e4f-5a6b-7c8d-9e0f-a1b2c3d4e5f6",
  "wallet_uuid": "00000000-0000-0000-0000-000000000000",
  "status": "realized",
  "type_payout": "pix",
  "amount": 1500.00,
  "currency": "BRL",
  "transaction_reference": "REF-0001"
}