# Balance Webhooks

Balance webhooks notify you about credits to your Funded Balance. They apply only to merchants on the Funded Balance model.

> **Note:** The sample payloads on this page are pretty-printed. The body Glomo sends is the RFC 8785 canonical form of the same object, and the `X-Glomopay-Signature` header is computed over those bytes. See [Webhook Authentication & Security](/platform/webhooks#webhook-authentication--security).


When an Add Balance top-up succeeds, the standard [Payment webhook](/platform/webhooks/payment) also fires for the Add Fund payment (`event_type: success`, with `payin_type: add_funds`).

| Event Type | Description |
|  --- | --- |
|  balance.funded_balance.credited  | An Add Balance top-up has been credited to the Funded Balance. |


## Sample Payload

```Sample
{
  "entity_type": "balance",
  "event_type": "balance.funded_balance.credited",
  "data": {
    "payment_id": "addfunds_691eeb9aV79Uk",
    "amount": 5000000,
    "currency": "USD",
    "bank_transfer_reference": "UTR123456789012",
    "funds_credit_date": "2026-05-20",
    "balance_available_after_credit": 12500000,
    "balance_pending_after_credit": 0,
    "timestamp": "2026-05-12T10:20:47Z"
  }
}
```

| Field | Description |
|  --- | --- |
| `payment_id` | Identifier of the Add Fund payment that credited the balance. |
| `amount` | Credited amount, in the smallest currency unit (see [Understanding Payment Amounts](/platform/webhooks/payment#understanding-payment-amounts)). |
| `currency` | Currency of the credit, in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. |
| `bank_transfer_reference` | Reference of the inbound bank transfer (e.g. UTR). `null` if not yet available. |
| `funds_credit_date` | Date the funds were credited. `null` if not available. |
| `balance_available_after_credit` | Funded Balance available (this currency) after the credit, in the smallest currency unit. |
| `balance_pending_after_credit` | Funded Balance pending (this currency) after the credit, in the smallest currency unit. |
| `timestamp` | Event time, in ISO 8601 format. |