Skip to main content

Topping up credits

Topping up takes two taps. The flow is the same whether you open it from your billing screen, from the credits pill at the top of any screen, or from the "out of credits" paywall.

Where to start​

Three entry points lead to the same pack picker:

  • Profile → Billing → Buy credits. The deliberate path. Use this when you want to look at your balance, your purchase history, and your usage before deciding which pack to buy.
  • The credits pill, top right of every screen. Tap the balance to open the billing screen and continue from there.
  • The "out of credits" modal. If an action stops because your balance is too low, the modal includes a Top up button that opens the pack picker directly. Your in-progress action is held — you pay, return, and continue.

The pack picker​

The pack picker is a bottom sheet that lists all available credit packs (see Plans and pricing for the current list). Each row shows the pack size, the price, and the per-credit cost so larger packs are easy to compare against smaller ones.

Tap a pack and ClaudeLab does three things:

  1. Calls the billing-topup edge function on the server to create a Paddle transaction.
  2. Closes the bottom sheet so you don't return to a stuck spinner.
  3. Opens the hosted Paddle checkout URL in your browser.

You complete payment on Paddle's hosted checkout — card, Google Pay, or Apple Pay are accepted. ClaudeLab never sees your card details.

Returning to the app​

When the Paddle checkout completes successfully:

  1. Paddle sends a webhook to ClaudeLab.
  2. The webhook credits your account based on the pack you bought.
  3. The next time the app comes to the foreground, the credits store re-fetches your balance and the new total appears in the pill at the top of the screen.

If the webhook is delayed for any reason, pulling Profile → Billing forces a fresh refresh.

Receipts​

Paddle sends an email receipt for every successful purchase. The receipt includes the transaction ID, the price, the tax breakdown, and a link to a Paddle-hosted invoice you can download as PDF. Keep that transaction ID — you need it for any refund request.

Inside the app, every successful pack purchase also appears as a row in Profile → Billing → Purchases, showing the pack size, the credits granted, the date, and the amount paid.

If checkout fails​

A failed checkout never debits your account. If you abandon the Paddle page, close the browser, or the card declines, no credits are added and no usage row appears. You can simply tap the pack again and try a different payment method.

If a charge appears on your card but credits do not arrive within a few minutes, contact support@claudelab.me with the Paddle transaction ID. Do not initiate a chargeback before contacting support — see Refund policy.

tip

You do not need to top up before starting a session. The starter grant on a new account is enough to run your first practice session, and I tell you in plain language when you are getting close to the warning line.