Skip to main content

​
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.
Purchased top-up credits remain in the wallet after a failed plan payment. Only plan credits and plan-dependent limits or features are removed.

​
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.