Skip to content
DocsGuides

Going live

Check these before real traffic.

  1. Check you are on an `sb_live_` key and that X-Test-Scenario is gone. A live key returns 400 test_scenario_on_live_key if the header is still there. See Test mode.
  2. Add a payment method in the console's Billing page before your free pages run out, or live requests return 402 free_pages_exhausted.
  3. Store `livemode` with whatever you read the document for, so a fixture that reached your database can be found.
  4. 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.
  5. Set a client timeout of at least 180 seconds, or send with async=true. Files over 60 pages need async. See Async reads.
  6. Add a live webhook endpoint if you use webhooks, and verify every signature against the raw body. See Webhooks.
  7. Filter on `account.type` before summing credits as income. See Amounts and directions.
  8. Branch on `verification.reconciled` and route anything false to a person. See Verification.
  9. Route `authenticity.risk: "high"` to a person. See Authenticity signals.
  10. Iterate `accounts` instead of reading accounts[0], and keep them separate. See Accounts and periods.
  11. Branch on `error.code`, never on the message or a substring of it.
  12. Keep 4 synchronous reads in flight or fewer, or handle 429 with a short backoff. See Limits.
  13. 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.
  14. Set your retention period in the console's Settings to what your own policy allows. See Security and data retention.
  15. 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]