Webhooks de saque

Avisos de um payout criado pela API.

payment_processedPayout Confirmado

Enviado quando o saque é processado. status vem success. O corpo traz a carteira, os valores, a rede e customer_info.

json

{
  "data": {
    "status": "success",
    "wallet": "0xBeef0000000000000000000000000000000000b2",
    "network": "BinanceSmartChain",
    "created_at": "2026-03-01 13:00:00",
    "fiat_amount": "40.00",
    "network_fee": "0.00000400",
    "confirmed_at": "2026-03-01 13:00:06",
    "percent_rate": "0.50",
    "reference_id": "33333333-3333-4333-8333-333333333333",
    "transactions": "0xdef0000000000000000000000000000000000000000000000000000000000abc",
    "crypto_amount": "40.00000000",
    "customer_info": "customer@example.com",
    "fiat_currency": "USD",
    "crypto_currency": "USDT",
    "internal_reference": "44444444-4444-4444-8444-444444444444"
  },
  "event": "payment_processed",
  "timestamp": "2026-03-01 13:00:16"
}

payment_failedPayout Falhou

Enviado quando o saque não pode ser concluído. O corpo traz só status, reference_id e internal_reference.

json

{
  "data": {
    "status": "failed",
    "reference_id": "55555555-5555-4555-8555-555555555555",
    "internal_reference": "66666666-6666-4666-8666-666666666666"
  },
  "event": "payment_failed",
  "timestamp": "2026-03-01 13:05:00"
}

Sua integração precisa tratar este aviso: localize o payout por reference_id ou internal_reference e decida o que informar ao seu cliente. Para pagar de novo, crie um novo payout com um novo reference_id.

customer_infoPayin & Payout

Seu próprio identificador do cliente, como ID de usuário, e-mail ou número do pedido. Ele volta nos webhooks e nas listagens, então você sabe de quem é cada transação, inclusive os payins que a Bifrost cria por conta própria (pagamentos adicionais e depósitos em endereço fixo), cujo reference_id é gerado pela Bifrost.

"customer_info": "user@email.com" ou "user_12345_order_67890"