Adding credits
Top up from the Billing page: Add credits opens a Stripe-hosted checkout, minimum $5, maximum $4,999 per transaction, and card details never touch Pearl’s servers. Credits are applied when the payment settles, usually within moments of checkout completing. For a new self-serve organization on Basic, a successful purchase of at least $5 also unlocks higher Basic inference limits automatically: 600 requests per minute and 50 concurrent requests per model. A saved credit card is not required, and you stay on Basic. Welcome credits and promotional grants do not qualify; custom invitation settings and custom rate limits are preserved. See Plans & rate limits.- Every top-up, manual or automatic, appears in the Billing page’s payment history with its amount, type, and status (including the failure reason when a charge doesn’t go through). Invoices you have paid appear there too, linking to Stripe’s invoice page for the receipt.
- Only billing admins (and org admins) can add credits or manage payment settings, other roles see the balance and are pointed to a billing admin. See Team & roles.
When the balance runs out
An exhausted balance is an account state, not a transient error: API requests are declined with a402 until you top up (see error handling). Balance changes propagate to the network within about a minute in both directions, running dry and re-funding both take effect quickly.
Unpaid invoices
Requests already running when the balance reaches $0 still finish, so usage can run slightly past your credits. Whatever your credits have not covered when the month’s invoice is issued stays on that invoice, which Stripe emails to your billing contact. Until it is paid, API requests are declined with a402, and top-ups and auto-recharge are paused, whatever your balance.
Billing admins pay it from the Billing page, where each unpaid invoice has a Pay invoice button that opens Stripe’s secure payment page, or from the link in Stripe’s email. Paying it adds no credit: once it is paid, requests resume within a few minutes if your balance is above $0, and otherwise after you add credits.
Enterprise (invoiced) accounts
Higher-volume organizations can switch from prepaid to monthly invoicing: usage is metered identically, but instead of topping up, you operate against a credit line and receive an invoice at the start of each month. Prepaid credits are drawn first; usage beyond them accrues to the credit line and is settled on the next invoice, so you pay for inference after the fact instead of topping up a balance in advance. The Billing page changes accordingly:
Interested in invoicing? Reach out through the dashboard’s Support tab, the switch is made by our team, not self-serve.