GOXOST KYC nima qiladi
Foydalanuvchi shaxsni tasdiqlovchi hujjatini suratga oladi va qisqa selfi tushadi. Shundan soʻng GOXOST KYC:
- hujjat maʼlumotlarini oʻqiydi, hujjat haqiqiyligini, yaroqliligini va muddati oʻtmaganini tekshiradi;
- tekshiruvda haqiqiy shaxs ishtirok etayotganini tekshiradi (shaxs ishtirokini tekshirish);
- selfini hujjatdagi surat bilan solishtiradi (selfi va hujjat mosligi);
- ixtiyoriy ravishda ismni sanksiya roʻyxatlaridan (OFAC SDN, BMT, Buyuk Britaniya, YeI) qidiradi va hisobingiz ichida takroriy hujjatlarni izlaydi.
Har bir tekshiruv bitta qaror bilan tugaydi:
| Qaror | Maʼnosi | Siz nima qilasiz |
|---|---|---|
GREEN |
Barcha tekshiruvlardan oʻtdi | Foydalanuvchini qabul qiling |
RED |
Tekshiruvlardan biri oʻtmadi. decision_type foydalanuvchi qayta urinishi mumkinmi (retry) yoki yoʻqmi (final) — shuni bildiradi |
Sababini tushuntiring, ruxsat boʻlsa qayta urinishni taklif qiling |
ON_HOLD |
Natija aniq emas, qarorni odam qabul qilishi kerak | Paneldagi qoʻlda koʻrib chiqishni kuting yoki API orqali qaror qiling |
RED va ON_HOLD doim DOC_EXPIRED yoki FACE_MISMATCH kabi mashina oʻqiydigan reject_labels bilan keladi. Toʻliq roʻyxat — Tekshiruv jarayoni bobida.
Integratsiya qanday ishlaydi
- Backendingiz arizachi yaratadi — tekshiriladigan odam, sizdagi foydalanuvchi ID siga (
external_id) bogʻlangan. - Backendingiz shu arizachi uchun sessiya yaratadi va bir martalik
urlhamdatokenoladi. - Foydalanuvchi senariydan oʻtadi — siz uni
urlga (hosted sahifa) yuborasiz yokitokenbilan veb-embed (kyc.js) yoki Flutter SDK ni ishga tushirasiz. - GOXOST KYC backendingizga webhook yuboradi (
verification.completedyokiverification.on_hold). - Backendingiz qarorni oʻqiydi —
GET /verifications/{id}orqali — va foydalanuvchingizni yangilaydi.
Your backend ──POST /applicants──────────────▶ GOXOST KYC → apl_…
Your backend ──POST /applicants/{id}/sessions▶ GOXOST KYC → { url, token }
User ──opens url / SDK with token────▶ hosted flow (document + selfie)
GOXOST KYC ──webhook verification.completed▶ Your backend
Your backend ──GET /verifications/{id}────────▶ GOXOST KYC → decision, checks, document data
Brauzer yoki ilovada koʻrsatilgan natija faqat foydalanuvchi tajribasi uchun — brauzerdagi xabarni soxtalashtirish mumkin. Yakuniy qarorni doim backendingizda, webhook yoki GET /verifications/{id} dan oling.
Maxfiy API kalit serveringizda qoladi. Brauzer yoki ilova faqat qisqa muddatli sessiya url i yoki token ini oladi.
Integratsiya variantlari
Barcha variantlar bir xil backend API va bir xil webhooklardan foydalanadi; ular faqat foydalanuvchi senariydan qayerda oʻtishi bilan farq qiladi.
| Variant | Kim uchun qulay | Siz nima qilasiz | Bob |
|---|---|---|---|
| Hosted havola | Eng tez boshlash; e-mail, SMS, chat yoki QR kod orqali havola | Faqat backend chaqiruvlari. Foydalanuvchini url ga yoʻnaltirasiz |
Tekshiruv jarayoni |
Veb-embed (kyc.js) |
Foydalanuvchini saytingizda qoldirish | Bitta konteyner element va bitta script tegi | Web SDK |
| Flutter SDK | Android va iOS ilovalari; hujjatning elektron tekshiruvini ham bajara oladi | Bitta KycFlow.start chaqiruvi |
Flutter |
| WordPress plagini | WordPress saytlari | Plaginni oʻrnatib sozlaysiz | WordPress |
| Direct API | Oʻz suratga olish interfeysingiz yoki qoʻlingizdagi rasmlarni server tomonda tekshirish | Hammasi: suratga olish, UX, qaror mantigʻi | Direct API |
Direct API holatsiz: u siz yuborgan rasmlarni tekshiradi va natijani javobda qaytaradi. U arizachi yaratmaydi, hech narsa saqlamaydi va webhook yubormaydi.
Muhitlar
| Sinov | Ishchi | |
|---|---|---|
| API kalit | sk_test_… |
sk_live_… |
| Tekshiruvlar | Soxta — natijani oʻzingiz tanlaysiz | Haqiqiy hujjat, selfi va shaxs ishtiroki tekshiruvlari |
| Oylik limit | Cheklanmagan (lekin hisoblanadi) | Tarifingiz limiti |
| Qachon ochiladi | Roʻyxatdan oʻtgan zahoti | Biznes tasdiqlangandan keyin |
Ikkala muhit bir xil asosiy URL dan foydalanadi; muhitni kalit belgilaydi. Maʼlumotlar muhitlar orasida aralashmaydi: sinov kaliti ishchi rejim arizachilarini koʻrmaydi, sinov va ishchi rejimdagi bir xil external_id esa ikki xil arizachi. Batafsil — Sinov va ishchi rejim.
Asosiy URL va qoidalar
https://kyc.goxost.net/api/v1
- HTTPS orqali JSON, UTF-8. Vaqt ISO 8601 formatida, UTC da (
2026-11-09T10:00:00Z). Ballar0dan1gacha boʻlgan son. - Har bir soʻrovni
Authorization: Bearer sk_test_…yokisk_live_…bilan autentifikatsiya qiling — Autentifikatsiya bobiga qarang. - ID lar tur prefiksiga ega:
apl_arizachi,ses_sessiya,ver_tekshiruv,whk_webhook,whd_webhook yetkazilishi,evt_hodisa. - Har bir javobda
X-Request-Id: req_…sarlavhasi bor. Yordam markaziga murojaat yuborganda uni qoʻshing.
Keyin nimani oʻqish kerak
- Tez boshlash — sinov rejimidagi birinchi tekshiruvingiz, besh qadamda.
- Autentifikatsiya — API kalitlar, sessiya tokenlari va idempotentlik.
- Tekshiruv jarayoni — arizachilar, sessiyalar, qarorlar va qoʻlda koʻrib chiqish.
- Webhooklar — hodisalar, imzolar va qayta yuborishlar.
- Xatolar — xato kodlari, soʻrov limitlari va xavfsiz qayta urinish.
- API maʼlumotnomasi — har bir endpoint va maydon. Xom sxema — /docs/openapi.yaml, Postman toʻplami — /docs/postman.json.