> ## 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 Depósito

> Notificações em tempo real para quando fundos são recebidos

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

### Depósito Pago

```json theme={null}
{
  "event": "deposit.status.paid",
  "data": {
    "id": "0a484300-33a6-435f-ba44-8d9c10c51457",
    "reference": "13360e66-bc53-44d8-98c8-25df91eb525c",
    "account_id": "28007014-1855-4559-8da0-fdca137e97aa",
    "net_amount": {
      "value": 960,
      "currency": "NGN"
    },
    "gross_amount": {
      "value": 980,
      "currency": "NGN"
    },
    "fee": {
      "value": "20.00000000",
      "currency": "NGN"
    },
    "status": "completed",
    "created_at": "2026-02-03T13:29:01.910Z",
    "updated_at": "2026-02-03T13:29:01.910Z",
    "payer": {
      "bank_account_number": "0000000000",
      "bank_account_name": "Mr. Linwood Emmerich III",
      "bank_name": "Maplerad",
      "bank_code": ""
    },
    "receiver": {
      "bank_account_number": "5953717576",
      "bank_account_name": "Cornelius Langworth",
      "bank_name": "Maplerad"
    },
    "settlement": {
      "settlement_at": "2026-02-03T13:29:01.910Z"
    }
  }
}
```

```json theme={null}
{
  "event": "deposit.status.paid",
  "data": {
    "id": "4d3aae75-defd-4f34-856d-0efc5eca211d",
    "reference": "4d3aae75defd4f34856d0efc5eca211d",
    "account_id": "28007014-1855-4559-8da0-fdca137e97aa",
    "net_amount": {
      "value": 210,
      "currency": "BRL"
    },
    "gross_amount": {
      "value": 210,
      "currency": "BRL"
    },
    "fee": {
      "value": 0,
      "currency": "BRL"
    },
    "status": "completed",
    "created_at": "2026-02-03T16:34:31.138Z",
    "updated_at": "2026-02-03T16:35:46.634Z",
    "payer": {},
    "receiver": {
      "name": "Unegbu"
    },
    "settlement": {
      "settlement_at": "2026-02-03T16:35:46.634Z",
      "end_to_end_id": "4d3aae75defd4f34856d0efc5eca211d"
    }
  }
}
```

### Depósito Não Pago

```json theme={null}
{
  "event": "deposit.status.unpaid",
  "data": {
    "id": "4d3aae75-defd-4f34-856d-0efc5eca211d",
    "reference": "4d3aae75defd4f34856d0efc5eca211d",
    "account_id": "28007014-1855-4559-8da0-fdca137e97aa",
    "net_amount": {
      "value": 210,
      "currency": "BRL"
    },
    "gross_amount": {
      "value": 210,
      "currency": "BRL"
    },
    "fee": {
      "value": 0,
      "currency": "BRL"
    },
    "status": "completed",
    "created_at": "2026-02-03T16:34:31.138Z",
    "updated_at": "2026-02-03T16:35:46.634Z",
    "payer": {},
    "receiver": {
      "name": "Unegbu"
    },
    "settlement": {
      "settlement_at": "2026-02-03T16:35:46.634Z",
      "end_to_end_id": "4d3aae75defd4f34856d0efc5eca211d"
    }
  }
}
```