Criar Webhooks

Os webhooks são notificações de eentos que acontecem em nossos servidores. Essas notificações podem ser enviadas para outras aplicações para notificar quando um checkout ou qrcode foi pago ou quando um pagamento é processado.

Para cadastrar um webhook, é necessario acessar a nossa plataforma online e no menu lateral procure por webhooks. Na pagina que abrir configure seu webhook.

• OBS: Nossos webhooks esperam uma resposta 200 ou 201 do servidor notificado.

As notificações webhooks emitidas possuem o formato json e são emitidas via requisição POST. Para notificações de entrada (Todos os metodos) o json segue o padrão abaixo:

{
  "id": 476,
  "callback": null,
  "account": "00000022",
  "type": "credit",
  "status": "paid",
  "amount": "1.85",
  "currency": "BRL",
  "reference": "ae3cda5a5f374825b6e67c3541",
  "payment_at": "2025-12-15 17:13:54",
  "created_at": "2025-12-15 17:13:54",
  "notify_at": "2025-12-15 17:13:54",
  "event_type": "transaction",
  "event_method": "paid"
}

Para notificações de saída, o json segue o padrão abaixo:

{
  "id": 483,
  "callback": null,
  "account": "00000022",
  "type": "debit",
  "status": "paid",
  "amount": "-7.500000000000000000",
  "currency": "BRL",
  "reference": "E48756121202512152142gvlpUAejikO",
  "payment_at": "2025-12-15 18:42:52",
  "created_at": "2025-12-15 18:42:07",
  "notify_at": "2025-12-15 18:42:52",
  "event_type": "transaction",
  "event_method": "paid"
}

Para notificações de saída rejeitada, o json segue o padrão abaixo:

{
  "id": 483,
  "callback": null,
  "account": "00000022",
  "type": "debit",
  "status": "reject",
  "amount": "-7.500000000000000000",
  "currency": "BRL",
  "reference": "E48756121202512152142gvlpUAejikO",
  "payment_at": "2025-12-15 18:42:52",
  "created_at": "2025-12-15 18:42:07",
  "notify_at": "2025-12-15 18:42:52",
  "event_type": "transaction",
  "event_method": "reject"
}

Para notificações de saída com falha, o json segue o padrão abaixo:

{
  "id": 483,
  "callback": null,
  "account": "00000022",
  "type": "debit",
  "status": "failed",
  "amount": "-7.500000000000000000",
  "currency": "BRL",
  "reference": "E48756121202512152142gvlpUAejikO",
  "payment_at": "2025-12-15 18:42:52",
  "created_at": "2025-12-15 18:42:07",
  "notify_at": "2025-12-15 18:42:52",
  "event_type": "transaction",
  "event_method": "failed"
}