Eventos de Saques

Eventos disponíveis

Quando cada evento dispara

withdrawal.requested

Disparado quando um saque é solicitado via API ou pelo painel. Se o merchant possui aprovação automática habilitada, o saque é processado imediatamente; caso contrário, aguarda aprovação manual.

withdrawal.approved

Disparado quando um administrador aprova um saque pendente. O saque é então enviado para processamento pela adquirente.

withdrawal.rejected

Disparado quando um administrador rejeita um saque pendente. O valor reservado é devolvido à carteira do merchant/submerchant.

withdrawal.processing

Disparado quando a adquirente confirma que o saque está em processamento. Este evento é originado por notificações da adquirente (webhook da adquirente).

withdrawal.completed

Disparado quando a adquirente confirma que o saque foi concluído e o valor foi transferido ao destinatário.

withdrawal.failed

Disparado quando o saque falha no processamento pela adquirente. O valor reservado é devolvido automaticamente à carteira do merchant/submerchant.

Payload de exemplo

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "event": "withdrawal.completed",
  "withdrawal": {
    "id": "w1d2r3a4-w5a6-7890-wdrl-000000000001",
    "merchant_id": "m1e2r3c4-h5a6-7890-ntid-000000000001",
    "submerchant_id": null,
    "wallet_id": "w1a2l3l4-e5t6-7890-wllt-000000000001",
    "status": "completed",
    "amount"

Campos do objeto withdrawal

Tipos de destinatário (recipient_snapshot)

PIX

{
  "type": "pix",
  "details": {
    "pix_key": "joao@exemplo.com",
    "pix_key_type": "email"
  }
}

TED

{
  "type": "ted",
  "details": {
    "bank_code": "001",
    "branch_number": "1234",
    "branch_check_digit": "0",
    "account_number": "12345",
    "account_check_digit": "6",
    "account_type": "checking",
    "holder_name": 

Criptomoeda

{
  "type": "crypto",
  "details": {
    "crypto_currency": "USDT",
    "crypto_network": "tron",
    "crypto_wallet": "TXyz..."
  }
}