User Onboarding

User Onboarding

User onboarding is the first operational dependency for Crypto as a Service. A user must reach ACTIVE status before they can place orders, make withdrawals, or receive deposits.

For the complete onboarding reference (user statuses, onboarding tasks, supported legal ID formats, identity documents, error codes, webhooks, and country-specific rules), see the User Onboarding section.


Quick reference


Recommended sequence

  1. Create the user with POST /crypto/v2/users.
  2. Retrieve missing onboarding requirements.
  3. Submit required fields and documents.
  4. Track status via USER_ONBOARDING_UPDATE webhooks until the user is ACTIVE.

Sandbox behavior

In the sandbox environment, creating a user with the name fail (case-insensitive) triggers a rejection response. Use any other name to simulate a successful onboarding flow.


Did this page help you?