Onboarding checklist

The checks to finish before you onboard customers in live: keys, webhooks, idempotency, error handling and funding.

Work through this list before you onboard customers in live:

1. Test in sandbox. Run each flow you plan to offer with your sandbox key, and check the known sandbox issues for steps you can't complete there yet.
2. Use your live key. Copy your live secret key from the Dashboard and keep it on your server only. See Authentication.
3. Register your live webhook. Add your live webhook URL in the Dashboard with Production selected, and store its whsec_ secret. Sandbox and live each have their own URL and secret.
4. Verify and deduplicate webhooks. Check the signature on every event, and process each event_id once. See Webhooks.
5. Send a new idempotency key with every POST. Reuse a key only to retry the same request. See Idempotent requests.
6. Handle retries and errors. Back off on 429 and 5xx. After a timeout, check whether a payment ran before you retry it. See Errors and Rate limits.
7. Fund your main accounts. Send money to each main account's wallet address or bank deposit details.