Step 1: Signup New User

Endpoint:

POST v1/signup

This endpoint registers a new user by providing an email and password.

Headers:

Body Parameters:

❗️

Password Requirements:

• Length: 10 to 32 characters
• Alphabet: only Latin letters
• Must contain at least 1 number
• Must contain at least 1 symbol (e.g., !, @, #, $)
• Must include at least 1 uppercase and 1 lowercase letter
• A weak password (e.g., including qwerty or 12345 combinations) will not be accepted
• The last 5 user's passwords cannot be specified as a new one

Request Example:

{
  "email": "[email protected]",
  "password": "testPassword663!"
}

Response:

{
  "result": "ok"
}

Optional Step: Verify Referral Code

Endpoint:

POST /referral/code/validate

This endpoint validates referral code entered by the user.

Headers:

Body Parameters:

Request Example:

{
  "code": "string"
}

Response:

{
  "result": "string"
}

Step 2: Confirm User Registration

Endpoint:

GET /terms-and-conditions

This endpoint retrieves actual version of terms and conditions: user should read it before taking further steps in creating account.

Headers:

Response:

{
  "documents": {
    "additionalProp": "string"
  },
  "partnerId": 0,
  "version": 0
}

Endpoint:

POST v1/signup/confirm

This endpoint confirms the signup process by verifying the email confirmation code, accepting terms and conditions, and completing user registration.

Headers:

Body Parameters:

🛡️ Email Verification Code – API Rules

📌 Code Format

✅ 6-digit numeric code
✅ Only numbers allowed

⏳ Code Expiry

✅ Valid for 5 minutes
❌ Expired codes cannot be used for verification

🔄 Resend Policy

✅ A new code can be requested once every 60 seconds by using POST v1/signup/confirm endpoint
❌ Frequent requests are restricted

⚠ Verification Attempts & Account Lock

✅ Users have 5 attempts to enter the correct code
❌ After 5 failed attempts, the account is temporarily locked and user's forcibly logged out
✅ To unlock the account user should contact the support team.

Request Example:

{
  "email": "string",
  "emailConfirmCode": "string",
  "password": "string",
  "referralCode": "string",
  "termsAndConditionsConfirmed": true,
  "termsAndConditionsVersion": 0,
  "userType": "CUSTOMER"
}

Response Example:

{
  "access_token": "eyJraWQiOiI5YzU1OWEyMS03ZGM3LTRjNzgtYTBkMi03OWMxNGU1MjY5Yjki...",
  "token_type": "Bearer",
  "refresh_token": "eyJraWQiOiI5YzU1OWEyMS03ZGM3LTRjNzgtYTBkMi03OWMxNGU1MjY5Yjki...",
  "scope": "accounts:create admin_users:edit admin_users:read",
  "expires_in": 86400,
  "user_id": "usr:5c7b8d05-ca2b-421c-8d97-9797e372e416"
}

This response provides an access_token that should be used for authenticated requests.

Step 3: SUMSUB Verification

To complete registration process, proceed with the SUMSUB verification. Learn more form SUMSUB KYC Guide.

Step 4: Subscription

Once registration and verification steps are completed, the user should be offered to opt a subscription.
Subscriptions provide recurring access to services based on different tiers.

To integrate and manage subscriptions, refer to the full Subscription Guide.