Getting started with GOXOST KYC
Create an account, get a sandbox key, open live mode and choose how to integrate.
On this page
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
- Sign up at https://kyc.goxost.net/register and sign in to the panel.
- 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
- In the panel, open API keys and choose Create key.
- Select the Sandbox environment. The key starts with
sk_test_. - 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:
- 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.
- 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
- Your backend creates an applicant (
POST /applicants). - It creates a session for the applicant and gets a one-time
urland atoken. - The customer completes the check.
- GOXOST KYC sends a webhook to your backend.
- 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.