> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BILLING_INVOICE_PAID

> Fired when a billing invoice is successfully paid via crypto deposit.

Fires when a crypto deposit fully covers a pending invoice. The invoice status moves to `PAID` and — if it was a setup invoice — your program is activated.

## Event Type

```
BILLING_INVOICE_PAID
```

## Payload

```json theme={null}
{
  "event":       "BILLING_INVOICE_PAID",
  "eventId":     "EVTJHLTPQH45SAP",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-26T14:13:26Z",
  "data": {
    "invoiceId":     "INVTEST000001AB",
    "invoiceNumber": "INV-2026-TEST-001",
    "amount":        50.00,
    "paid":          50.00,
    "currency":      "USD",
    "paymentMethod": "CRYPTO",
    "txHash":        "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "network":       "TRON"
  }
}
```

## Payload Fields

| Field           | Type   | Description                                         |
| --------------- | ------ | --------------------------------------------------- |
| `invoiceId`     | string | Unique invoice identifier                           |
| `invoiceNumber` | string | Human-readable invoice number                       |
| `amount`        | number | Original invoice amount in dollars                  |
| `paid`          | number | Amount actually applied to this invoice, in dollars |
| `currency`      | string | Currency code (always `USD`)                        |
| `paymentMethod` | string | Always `CRYPTO` for on-chain payments               |
| `txHash`        | string | Blockchain transaction hash of the deposit          |
| `network`       | string | Blockchain network — `TRON` or `ETH`                |

For the full event group documentation see [Billing Events](/v3.20/webhooks/events/billing-events).

<RequestExample>
  ```json Webhook Payload theme={null}
  {
    "event":       "BILLING_INVOICE_PAID",
    "eventId":     "EVTJHLTPQH45SAP",
    "businessId":  "BUS1A2B3C4D5E6F",
    "environment": "LIVE",
    "timestamp":   "2026-05-26T14:13:26Z",
    "data": {
      "invoiceId":     "INVTEST000001AB",
      "invoiceNumber": "INV-2026-TEST-001",
      "amount":        50.00,
      "paid":          50.00,
      "currency":      "USD",
      "paymentMethod": "CRYPTO",
      "txHash":        "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
      "network":       "TRON"
    }
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {}
  ```
</ResponseExample>


## OpenAPI

````yaml v3.20/openapi.json webhook BILLING_INVOICE_PAID
openapi: 3.1.0
info:
  title: FYATU CaaS API v3.20
  description: >-
    FYATU Cards-as-a-Service API — API key authentication, Cardholder
    lifecycle, Card issuance, Transactions, Webhooks, and Programs.
  version: 3.20.0
  contact:
    name: FYATU Support
    url: https://fyatu.com
    email: support@fyatu.com
servers:
  - url: https://api.fyatu.com/api/v3.20
    description: >-
      FYATU CaaS API — the environment (LIVE or SANDBOX) is determined by the
      API key, not the URL
security:
  - BearerAuth: []
tags:
  - name: Meta
    description: Liveness, account info, and supported event types
  - name: Account
    description: Account-level balance and funding status
  - name: Programs
    description: Read card program configuration
  - name: Cardholders
    description: Create and manage cardholder profiles
  - name: Cards
    description: Issue, fund, freeze, and terminate virtual cards
  - name: Transactions
    description: Read-only card transaction history
  - name: Webhooks
    description: Manage webhook endpoints for real-time event delivery
  - name: Products
    description: Read card product configurations
paths: {}
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key from the FYATU CaaS portal. Pass as `Authorization: Bearer
        <key>`.

````