Going live
Check these before real traffic.
- Check you are on an `sb_live_` key and that
X-Test-Scenariois gone. A live key returns400 test_scenario_on_live_keyif the header is still there. See Test mode. - Add a payment method in the console's Billing page before your free pages run out, or live requests return
402 free_pages_exhausted. - Store `livemode` with whatever you read the document for, so a fixture that reached your database can be found.
- Send an `Idempotency-Key` on every request, generated once per document and reused by every attempt. Without it, a timeout you retry is a second charge. See Idempotency and retries.
- Set a client timeout of at least 180 seconds, or send with
async=true. Files over 60 pages need async. See Async reads. - Add a live webhook endpoint if you use webhooks, and verify every signature against the raw body. See Webhooks.
- Filter on `account.type` before summing credits as income. See Amounts and directions.
- Branch on `verification.reconciled` and route anything false to a person. See Verification.
- Route `authenticity.risk: "high"` to a person. See Authenticity signals.
- Iterate `accounts` instead of reading
accounts[0], and keep them separate. See Accounts and periods. - Branch on `error.code`, never on the message or a substring of it.
- Keep 4 synchronous reads in flight or fewer, or handle
429with a short backoff. See Limits. - Store `doc.id` against whatever you read the document for. It fetches the document again for your retention period, and it is the handle for any support question.
- Set your retention period in the console's Settings to what your own policy allows. See Security and data retention.
- Invite your team and give each person the role they need. See Console and teams.
Volume#
Every account has a monthly page cap, 25,000 pages unless we have raised it, which stops a runaway loop turning into an invoice. There is nothing to buy. Email [email protected] with your expected volume and we raise it before you reach it.
Support#
[email protected], with the documentId if there is one.
Something wrong or missing on this page? [email protected]