# Manage balance, top-ups and payments

> Check the current balance and SMS prices, make a top-up, configure automatic top-ups, and review payment history.
> Source: https://docs.23telecom.co.uk/guide/billing/

Instructions for LLMs: This is one page of the 23 Telecom messaging API docs
(SMS today; more channels planned). Base URL: https://restlink23telecom.com/api/v1,
auth via the X-API-Key header. Match errors on the error_code field, never on
description text. Full docs: https://docs.23telecom.co.uk/llms-full.txt · Schemas: https://docs.23telecom.co.uk/openapi.yaml

Billing pages show the funds and prices used by the active workspace.

## Check balance and pricing

1. Open **Billing**.
2. Open **Balance** and review **Current Balance**.
3. Open **SMS pricing**.
4. Search for the destination or network you plan to use.

Balance values require balance access. The broadcast estimate combines eligible recipients, message parts, destinations, and current prices.

## Make a top-up

1. Open **Billing**.
2. Open **Payment methods**.
3. Select **Top up**.
4. Enter the **Amount**.
5. Select **Continue to payment**.
6. Complete the payment form.
7. Wait for the result before closing the page.

Payment methods appears only when at least one payment method is enabled for the account.

## Configure automatic top-up

1. Under **Payment methods**, open **Credit cards**.
2. Select **Add card** and complete the card form.
3. Open **Auto top-up**.
4. Turn on **Enable auto top-up**.
5. Set **Trigger when balance falls below**.
6. Set **Top up by**.
7. Choose **Card to charge**.
8. Select **Save settings**.

Turning automatic top-up off and saving disables future automatic charges.

## Read payment history

1. Open **Payment history**.
2. Filter with **All**, **Deposits**, **Withdrawals**, or **Adjustments**.
3. Review **Date**, **Type**, **Method**, **Status**, **Description**, and **Amount**.

**Settled** means the payment completed. **Processing** means it is still pending. **Declined** means it did not complete. Settled rows are included in the summary totals.

## Permissions

Changing payment methods, making top-ups, and updating automatic top-up require billing-manage permission. A member without it sees **Read-only billing access** and cannot submit changes.

## Troubleshooting

1. Check that the active workspace is correct before paying.
2. Wait for a processing payment to settle before trying again.
3. Add a saved card before enabling automatic top-up.
4. Ask the account owner to review billing and balance access when values or actions are hidden.