# Billing and payments

| Page | Path | What it is for |
|---|---|---|
| **Invoices** | `/admin/invoices` | Invoices, payments and PDFs |
| **Transactions** | `/admin/transactions` | Payments and refunds log |
| **Quotes** | `/admin/quotes` | Quotes and proposals |
| **Billing tools** | `/admin/billing-tools` | Mass pay, merge, split and more |
| **Overdue** | `/admin/overdue` | Reminders and late fees |
| **Gift cards** | `/admin/gift-cards` | Gift cards and balances |
| **Billable items** | `/admin/billable-items` | One-off and recurring charges |
| **Payment gateways** | `/admin/gateways` | Payment gateways and fees |
| **Taxes** | `/admin/tax` | Tax rules, VAT and OSS |
| **Currencies** | `/admin/currencies` | Currencies and exchange rates |
| **Legal entities** | `/admin/legal-entities` | Issuing companies |

## Invoices

Invoices are created for new orders and, by the daily `billing.recurring` task, for renewals. An invoice is `draft` (not visible to the client), `unpaid`, `paid` or `void`; a zero-total invoice or a credit note is paid immediately. Staff can add payments and refunds, apply credit and void unpaid invoices that have no payment yet. Clients download a PDF (and a UBL e-invoice) from the client area.

## Overdue invoices and dunning

The daily `billing.overdue` task sends overdue reminders, suspends services and queues the panel actions, following the rules in Admin → Billing → **Overdue**. The daily `billing.autopay` task charges due invoices to the client's default saved payment method, retries on the configured schedule and mails a dunning notice after each failed attempt.

## Payment gateways

Gateways are addons of kind `gateway`. Install one in Admin → Addons & integrations → **Addons**, then enable it and fill its settings in Admin → Billing → **Payment gateways**. The settings form is generated from the gateway's own schema; secrets are stored encrypted and never shown again. The page also has a test-webhook tool and a delivery log.

Bundled gateways:

| Addon | Id | Settings |
|---|---|---|
| [Adyen-style redirect](developers/addon-adyen.md) | `gateway-adyen` | `merchant_account` `api_base` |
| [Crypto (Coinbase Commerce-style)](developers/addon-crypto.md) | `gateway-crypto` | `api_base` |
| [Custom HTTP gateway](developers/addon-custom.md) | `gateway-custom-http` | `name` `create` `webhook` `refund` |
| [GoCardless](developers/addon-gocardless.md) | `gateway-gocardless` | `sandbox` `api_base` |
| [Manual bank transfer](developers/addon-manual.md) | `gateway-manual` | `instructions` |
| [Mollie](developers/addon-mollie.md) | `gateway-mollie` | `api_base` |
| [Paddle](developers/addon-paddle.md) | `gateway-paddle` | `live` `api_base` |
| [PayPal](developers/addon-paypal.md) | `gateway-paypal` | `live` `api_base` |
| [Razorpay](developers/addon-razorpay.md) | `gateway-razorpay` | `api_base` |
| [Stripe](developers/addon-stripe.md) | `gateway-stripe` | `api_base` `payment_method_configuration` `payment_method_types` |

## Tax, currencies and legal entities

- **Tax**: tax rules (VAT, sales tax). EU VAT numbers are validated against VIES (`PELTY_VIES_URL`).
- **Currencies**: enable currencies and their exchange rates.
- **Legal entities**: invoice from more than one company.

## Credit and gift cards

Clients can add funds to their account credit and pay invoices with it; staff manage gift cards in Admin → Billing → **Gift cards**.