Buying credits

Credits are the unit of account across PortModels. 1 credit = 1 USD. Every model call — whichever app makes it — is priced in credits and drawn from your balance.

Topping up#

Choose an amount and you are sent to a hosted Stripe Checkout page. Payment details are entered on Stripe's page, not on PortModels.

The API equivalent is credits.checkout, which takes amount, success_url, and cancel_url and returns a checkout_url to send the user to:

{
  "checkout_url": "https://checkout.stripe.com/c/pay/...",
  "session_id": "cs_...",
  "amount": 25,
  "message": "Complete the payment at checkout_url; credits arrive on confirmation"
}

Redirect URLs must be https, except localhost and 127.0.0.1 during development.

When credits arrive#

Credits are granted when Stripe confirms the payment, not when you are redirected back. The confirmation webhook is the only path that ever adds credits to a balance — so a top-up lands even if you close the browser on the success page, and a cancelled or failed payment never grants anything.

If a balance hasn't updated within a minute or two of a successful payment, check Billing history before retrying: a duplicate purchase is easier to avoid than to unwind.

Checking your balance#

Your balance is shown in the account area, and returned by credits.balance along with an account snapshot.

Running out mid-task#

A call that would take your balance below zero is rejected before it reaches a provider — you are not charged for it, and the app should tell you your balance is too low rather than failing silently. Top up and retry; nothing else needs resetting.