Skip to content

Chapter 2 · For businesses

Getting started with GOXOST KYC

Create an account, get a sandbox key, open live mode and choose how to integrate.

2 min read

On this page
  1. 1. Create an account
  2. 2. Get a sandbox key
  3. 3. Open live mode
  4. 4. Choose an integration
  5. How it works
  6. Documentation

GOXOST KYC verifies your customers' identity online. You send a customer to the check, they photograph their document and take a selfie, and your server receives the decision: GREEN (approved), RED (rejected) or ON_HOLD (needs manual review).

1. Create an account

  1. Sign up at https://kyc.goxost.net/register and sign in to the panel.
  2. The Sandbox environment is available right after sign-up. It runs no real checks — you choose the result yourself, so you can test your whole integration safely.

2. Get a sandbox key

  1. In the panel, open API keys and choose Create key.
  2. Select the Sandbox environment. The key starts with sk_test_.
  3. Copy the key right away — it is shown only once. Store it in your server's secrets.

The secret key is for your backend only. Never put it in a browser, a mobile app or a public repository.

3. Open live mode

The Live environment (sk_live_ keys and real checks) opens after two steps in the panel:

  1. Business profile — business type, legal name, registration number (optional for individuals), country, website, project name and description, use case and the default verification purpose. This information appears on verification certificates.
  2. Owner identity — the account owner passes a normal verification. GREEN verifies the account; ON_HOLD is reviewed by GOXOST staff; after RED you can try again (3 attempts in total).

Until both steps are done, any request with an sk_live_ key returns 403 tenant_not_verified.

4. Choose an integration

All options use the same API and webhooks:

Option Best for
Hosted link The fastest start: send the link by email, SMS, chat or QR code
Web SDK (kyc.js) Keeping the customer on your website
Flutter SDK Android and iOS apps
WordPress plugin WordPress sites
Direct API Your own capture UI, or checking images you already have on your server

How it works

  1. Your backend creates an applicant (POST /applicants).
  2. It creates a session for the applicant and gets a one-time url and a token.
  3. The customer completes the check.
  4. GOXOST KYC sends a webhook to your backend.
  5. Your backend reads the decision with GET /verifications/{id}.

Always take the final decision on your backend — from the webhook or the API. The result shown in the browser or app is for the user experience only.

Documentation

The full guide, code samples and API reference are at https://kyc.goxost.net/docs. Start with the Quickstart chapter: your first sandbox verification in five steps.

Was this article helpful?

Didn’t find an answer?

Send a request — a specialist will check your account and reply.