Eventos

Referencia completa dos eventos de webhook disponiveis.

DEPOSIT_ASSET_SUCCESS

Disparado quando um deposito PIX e confirmado com sucesso.

Payload

{
  "event": "DEPOSIT_ASSET_SUCCESS",
  "data": {
    "success": true,
    "transactionId": "67a1b2c3d4e5f67890abcdef",
    "chargeId": "67a1b2c3d4e5f67890abcde0",
    "value": 5000,
    "creditedValue": 4950,
    "fee": 50,
    "providerId": "eulen-charge-id-123"
  }
}

Campos

Campo	Tipo	Descricao
success	Boolean	Sempre true para este evento
transactionId	String	ID da transacao criada no sistema
chargeId	String	ID da cobranca original
value	Number	Valor original do deposito em centavos
creditedValue	Number	Valor creditado na conta (descontada a taxa) em centavos
fee	Number	Taxa total cobrada em centavos
providerId	String	ID do provedor de pagamento

Calculo da taxa

O valor creditado e calculado como:

creditedValue = value - fee

A taxa pode ser fixa ou percentual, conforme configuracao da conta.

---

PAYOUT_SUCCESSFUL

Disparado quando um pagamento ou saque e realizado com sucesso.

Payload

{
  "event": "PAYOUT_SUCCESSFUL",
  "data": {
    "success": true,
    "invoice": "lnbc500n1...",
    "valueInSatoshis": 50000,
    "pixKey": "email@exemplo.com",
    "valueInBrl": "50.00",
    "fee": 100,
    "quote": {
      "brlAmount": "50.00",
      "btcAmount": 0.00005,
      "satoshis": 50000,
      "btcToBrlRate": 350000
    }
  }
}

Campos

Campo	Tipo	Descricao
success	Boolean	Sempre true para este evento
invoice	String	Hash ou identificador do pagamento
valueInSatoshis	Number	Valor em satoshis (se Lightning)
pixKey	String	Chave PIX de destino
valueInBrl	String	Valor em reais
fee	Number	Taxa cobrada em centavos
quote.brlAmount	String	Valor em BRL da cotacao
quote.btcAmount	Number	Valor em BTC
quote.satoshis	Number	Valor em satoshis
quote.btcToBrlRate	Number	Taxa de conversao BTC/BRL no momento

---

PAYOUT_FAILED

Disparado quando um pagamento ou saque falha.

Payload

{
  "event": "PAYOUT_FAILED",
  "data": {
    "success": false,
    "error": "Insufficient funds",
    "transactionId": "67a1b2c3d4e5f67890abcdef"
  }
}

Campos

Campo	Tipo	Descricao
success	Boolean	Sempre false para este evento
error	String	Mensagem descrevendo o motivo da falha
transactionId	String	ID da transacao que falhou