Before you start
Only the workspace owner or an admin can manage its billing: its saved cards
and the buying of credit. Every member may read the balance and the statement
of the workspace they are in.
Buy credit
1
Open Billing
Sign in to the dashboard and open Billing. The Balance tab is the default and
is where the Add credit panel lives.
2
Choose the credit you want
Pick one of the amounts offered, or type your own. The figure is the credit you
receive, not the amount charged.An amount below the minimum is refused at the field: the refusal appears inline
and the continue control stays disabled, so you never learn the minimum by being
bounced back from a payment page.
3
Read the three lines
The panel shows the same three lines whatever you type, and they move as you type:
The rate is read live from the dashboard rather than written into the screen, so
what you see is the rate your checkout session will use. Where a card is already
saved, it is named inside the same box, so the card, the total, the credit and
the rate are read together before you commit.
4
Apply a code, if you have one
Have a code? opens a single Promo code field with an Apply control,
and one field serves both kinds of code. A Hopscotch credit code adds credit to
your balance on its own, with no purchase, and the screen says so: the amount
“added to your balance”. A discount code from our payment provider is checked
against the amount you typed and reduces the charge at checkout: the screen
reads the code “applied” with the amount off. A credit code is redeemable once
per workspace, and credit it grants is spent before credit you paid for.
5
Continue to payment
The control opens a checkout session with our payment provider and sends you to
their hosted page. Nothing has been charged at this point: a checkout session is
not a payment.Press it once. Each attempt opens its own checkout session, and two sessions can
become two charges if both are paid.
6
Pay
Enter the card on the hosted page. We never see the card number. If the card is
declined, the hosted page is where you are told and where you can try another.
7
Come back
You are returned to the Balance tab, which says the purchase is pending. That
is honest rather than cautious: credit is granted when the signed confirmation
from the payment provider reaches us, which is usually seconds.You do not have to stay on the page. Closing it changes nothing either way.
If something goes wrong
You left the payment page. The screen says no card was charged and no credit was added, and you can start again. A saved card is untouched by this: nothing on any failure path in this product removes a saved card. The purchase could not be started. The amount you typed is preserved. Do not press Continue again straight away: each attempt opens its own checkout session, and a purchase that did start charges nothing unless you finish paying for it. Quote the request id shown with the failure if you need us. The credit has not arrived. Reload the Balance tab. Credit lands only on the confirmed payment, so a purchase that has been paid arrives without any further action from you. If it has not arrived after a few minutes, quote the payment id from your statement.Read the statement
The Statement tab lists every transaction, newest first, fifty lines to a page, with date filters. A purchase line carries the amount charged, the credit granted and the fee, as three sub-fields of the one line, which is what explains any gap between your card statement and your balance. The running balance on each page is the sum of your transactions up to that line. It is there so you can check our arithmetic. It is not your available balance: that is on the Balance tab and accounts for credit currently held for requests in flight. The Statement tab is live today, one of the two tabs on the Billing screen alongside Balance. What you see there is the live record, not a preview of a screen still being designed.Set the low credit notice
You can be emailed once when your available balance falls below a figure you choose. The setting is on the Limits tab in Settings, and it is the owner’s to change.- The threshold is a whole number of minor units, from 0 to 100000. 500 means 5.00.
- 0 turns the email off. The screen says so in words rather than leaving you to infer it from a number.
- You are emailed once per crossing. No second email is sent until the balance goes back above the figure and falls below it again.
Your saved card
Your card is kept by our payment provider so that the next purchase does not ask for it again. We store no card number and no expiry: the brand and the last four digits are read from the provider when they are shown, so there is nothing on our side that can go stale. A saved card can be removed, which means the next purchase asks for a card again; it changes nothing about credit you have already bought and nothing about your balance. The card controls are on the Billing screen’s Payment tab, under Your card. Adding a card opens a setup session with our payment provider, and nothing is charged. With more than one card saved, Make default records which one pays and charges nothing. Remove asks you to confirm, and if the card you are removing is the one that pays while others remain, the screen asks which card takes over before it lets go of the old one.Auto reload
By default nothing charges your card while you are away, and the Auto reload section on the Billing screen says so: “Off. You are only charged when you buy credits yourself.” Turning it on takes two figures and a card. When credits fall below is the threshold, and Buy this many is the credit bought each time the balance crosses it. Both are dollar figures; the amount is at least the smallest purchase we accept, and the threshold can be set to zero to turn the reload off again. With no card on file the screen asks for one first, because a reload with nothing to charge is not a reload. Once on, the summary line reads what will happen: “On. Buys AMOUNT when the balance falls below THRESHOLD, so requests never stop.” A reload that is declined does not retry forever. After a run of consecutive failed charges the reload stops, the screen says so, and a new card or a manual purchase starts it again. The threshold is separate from the low credit email’s threshold below; the two do not have to agree. Setting either figure takes the same authority as buying credit: owner or admin.Next
Credits and billing
How billing works in full: the fee, holds, and what happens at zero.
Spend controls
The spend rate cap and the pause, before you need them.
Every response carries the same id on two headers:
x-hopscotch-request-id,
which is ours, and x-request-id, which is the one the official OpenAI SDKs
surface on their error objects. Every error envelope repeats it as
request_id. Quote it when you ask us about a request. Without it we are
guessing at which of your requests you mean.