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

# Invoices and payment recovery

> Pay an open invoice, update payment details, and understand what happens after a failed plan payment

## Pay an open plan invoice

If a plan payment fails, paid plan features and included plan credits are removed immediately. The workspace remains accessible so an owner can recover billing:

1. Open **Settings → Plan**.
2. Select **Pay invoice** to open the latest payable invoice.
3. If no payable invoice is available, the action opens **Manage billing** instead.

The paid plan becomes active again only after the payment is successfully confirmed. Marking an invoice as paid outside the online payment flow does not restore plan access.

<Note>
  Purchased top-up credits remain in the wallet after a failed plan payment. Only plan credits and plan-dependent limits or features are removed.
</Note>

## Manage billing

The **Manage billing** card at the end of the Plan page opens:

* invoice history and invoice PDFs,
* payment methods,
* cancellation at the end of the billing period.

Plan and price changes are intentionally unavailable there. Change plans only on **Settings → Plan**, where prices, add-ons, and workspace entitlements are validated together.

## Top-up invoices

Successful manual and automatic credit top-ups generate an invoice in the workspace's billing account. Credits are added only after the payment succeeds. A failed top-up never changes the existing wallet balance.

## API and MCP

The Public API exposes:

* `POST /api/v1/billing/invoice-payment`
* `POST /api/v1/billing/portal`

Both return only a short-lived `billing_url` on your platform or white-label domain. They never return customer, invoice, checkout, subscription, or connected-account identifiers.

The equivalent MCP tools are `create_invoice_payment_link` and `create_billing_portal_link`.