Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.bullring.finance/llms.txt

Use this file to discover all available pages before exploring further.

Webhooks permitem que sua aplicação receba notificações em tempo real quando eventos acontecem em sua conta Bullring. Em vez de fazer polling na API, enviaremos uma requisição HTTP POST para sua URL configurada.

​
On-Ramp Pendente

{
  "event": "onramp.status.pending",
  "data": {
    "id": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "status": "pending",
    "client_onramp_reference": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "account_id": "e704d0ec-5d19-49a1-b66c-86cd683f2d92",
    "created_at": "2026-01-23T16:45:43.276Z",
    "from": {
        "amount": "94.43",
        "currency": "BRL"
    },
    "to": {
        "asset": "USDC",
        "gross_amount": "95.47",
        "net_amount": "94.43",
        "address": "2fFUHpCEXhdQtSxompq8qbyU7EjjrtkMnr7ZT4ovF9A9"
    },
    "pricing": {
        "fx_rate": "0.19094342",
        "fees": {
            "onramp_fee": "1.5",
            "onramp_fee_currency": "brl",
            "network_fee": "0.75",
            "network_fee_asset": "USDC",
            "total_fees": "5.43",
            "total_fees_currency": "brl"
        }
    },
    "settlement": {
        "collection_id": "2ccc3c92-a256-4a21-836c-770da3522f42"
    }
  }
}

​
On-Ramp Pago

{
  "event": "onramp.status.paid",
  "data": {
    "id": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "status": "paid",
    "client_onramp_reference": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "account_id": "e704d0ec-5d19-49a1-b66c-86cd683f2d92",
    "created_at": "2026-01-23T16:45:43.276Z",
    "updated_at": "2026-01-23T16:50:43.276Z",
    "from": {
        "amount": "94.43",
        "currency": "BRL"
    },
    "to": {
        "asset": "USDC",
        "gross_amount": "95.47",
        "net_amount": "94.43",
        "address": "2fFUHpCEXhdQtSxompq8qbyU7EjjrtkMnr7ZT4ovF9A9"
    },
    "pricing": {
        "fx_rate": "0.19094342",
        "fees": {
            "onramp_fee": "1.5",
            "onramp_fee_currency": "brl",
            "network_fee": "0.75",
            "network_fee_asset": "USDC",
            "total_fees": "5.43",
            "total_fees_currency": "brl"
        }
    },
    "settlement": {
        "collection_id": "2ccc3c92-a256-4a21-836c-770da3522f42"
    }
  }
}

​
On-Ramp Concluído

{
  "event": "onramp.status.completed",
  "data": {
    "id": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "status": "completed",
    "client_onramp_reference": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "account_id": "e704d0ec-5d19-49a1-b66c-86cd683f2d92",
    "created_at": "2026-01-23T16:45:43.276Z",
    "updated_at": "2026-01-23T16:50:43.276Z",
    "from": {
        "amount": "94.43",
        "currency": "BRL"
    },
    "to": {
        "asset": "USDC",
        "gross_amount": "95.47",
        "net_amount": "94.43",
        "address": "2fFUHpCEXhdQtSxompq8qbyU7EjjrtkMnr7ZT4ovF9A9"
    },
    "pricing": {
        "fx_rate": "0.19094342",
        "fees": {
            "onramp_fee": "1.5",
            "onramp_fee_currency": "brl",
            "network_fee": "0.75",
            "network_fee_asset": "USDC",
            "total_fees": "5.43",
            "total_fees_currency": "brl"
        }
    },
    "settlement": {
        "collection_id": "2ccc3c92-a256-4a21-836c-770da3522f42",
        "transaction_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
    }
  }
}

​
On-Ramp Falhou

{
  "event": "onramp.status.failed",
  "data": {
    "id": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "status": "failed",
    "client_onramp_reference": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "account_id": "e704d0ec-5d19-49a1-b66c-86cd683f2d92",
    "created_at": "2026-01-23T16:45:43.276Z",
    "updated_at": "2026-01-23T16:50:43.276Z",
    "from": {
        "amount": "94.43",
        "currency": "BRL"
    },
    "to": {
        "asset": "USDC",
        "gross_amount": "95.47",
        "net_amount": "94.43",
        "address": "2fFUHpCEXhdQtSxompq8qbyU7EjjrtkMnr7ZT4ovF9A9"
    },
    "pricing": {
        "fx_rate": "0.19094342",
        "fees": {
            "onramp_fee": "1.5",
            "onramp_fee_currency": "brl",
            "network_fee": "0.75",
            "network_fee_asset": "USDC",
            "total_fees": "5.43",
            "total_fees_currency": "brl"
        }
    },
    "settlement": {
        "collection_id": "2ccc3c92-a256-4a21-836c-770da3522f42"
    }
  }
}