Asosiy qismga oʻtish
API hujjati API kalitini olish

Boshlash · 1-bob

Umumiy koʻrinish

GOXOST KYC foydalanuvchingiz haqiqiy odam ekanini va uning qoʻlida haqiqiy shaxsni tasdiqlovchi hujjat borligini tekshiradi hamda backendingizga uni qabul qilish-qilmaslikni aytadi.

3 daqiqa oʻqish

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

  1. Backendingiz arizachi yaratadi — tekshiriladigan odam, sizdagi foydalanuvchi ID siga (external_id) bogʻlangan.
  2. Backendingiz shu arizachi uchun sessiya yaratadi va bir martalik url hamda token oladi.
  3. Foydalanuvchi senariydan oʻtadi — siz uni url ga (hosted sahifa) yuborasiz yoki token bilan veb-embed (kyc.js) yoki Flutter SDK ni ishga tushirasiz.
  4. GOXOST KYC backendingizga webhook yuboradi (verification.completed yoki verification.on_hold).
  5. 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
Muhim

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). Ballar 0 dan 1 gacha boʻlgan son.
  • Har bir soʻrovni Authorization: Bearer sk_test_… yoki sk_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

  1. Tez boshlash — sinov rejimidagi birinchi tekshiruvingiz, besh qadamda.
  2. Autentifikatsiya — API kalitlar, sessiya tokenlari va idempotentlik.
  3. Tekshiruv jarayoni — arizachilar, sessiyalar, qarorlar va qoʻlda koʻrib chiqish.
  4. Webhooklar — hodisalar, imzolar va qayta yuborishlar.
  5. Xatolar — xato kodlari, soʻrov limitlari va xavfsiz qayta urinish.
  6. API maʼlumotnomasi — har bir endpoint va maydon. Xom sxema — /docs/openapi.yaml, Postman toʻplami — /docs/postman.json.

Mundarija