> ## 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.

# Eventos de On-Ramp

> Notificações em tempo real relacionadas a mudanças de status de onramp.

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

```json theme={null}
{
  "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

```json theme={null}
{
  "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

```json theme={null}
{
  "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

```json theme={null}
{
  "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"
    }
  }
}
```