Sinov va ishchi rejim farqi
| Sinov | Ishchi | |
|---|---|---|
| API kalit prefiksi | sk_test_ |
sk_live_ |
| Tekshiruvlar | Haqiqiy tekshiruv yoʻq. Natija external_id qoʻshimchasi bilan tanlanadi |
Hujjat maʼlumotlarini oʻqish, hujjat haqiqiyligini tekshirish, shaxs ishtirokini tekshirish, selfi va hujjat mosligi hamda ixtiyoriy AML |
| Rasmlar | Istalgan rasm qabul qilinadi | Haqiqiy hujjat va haqiqiy odam kerak |
| Hujjat maʼlumotlari | Sintetik namuna, ombordan hech narsa oʻqilmaydi | Odamning hujjat maʼlumotlari |
| Webhooklar | Ishchi rejimdagidek yuboriladi, "env": "sandbox" bilan |
"env": "live" |
| Oylik limit | Cheklanmagan, lekin GET /usage → sandbox da hisoblanadi |
Tarifingiz limiti |
| Qachon ochiladi | Roʻyxatdan oʻtgan zahoti | Biznes tasdiqlangandan keyin |
Ikkalasi uchun asosiy URL bir xil: https://kyc.goxost.net/api/v1. Muhitni kalit belgilaydi va har bir kalit faqat oʻz muhitini koʻradi. Sinov rejimidagi arizachilar, sessiyalar, webhook endpointlari va tekshiruvlar ishchi rejimdan alohida; bir muhitdagi ID ikkinchisida 404 not_found qaytaradi.
Panelda bu rejimlar Sinov va Ishchi deb ataladi.
Sinov rejimida natijani tanlash
sk_test_ kalit bilan qaror arizachining external_id si qanday tugashiga bogʻliq. Qoʻshimcha sessiya yaratilganda oʻqiladi.
external_id oxiri |
Qaror | decision_type |
reject_labels |
|---|---|---|---|
boshqa har qanday (masalan, -green) |
GREEN |
null |
[] |
-expired |
RED |
retry |
DOC_EXPIRED |
-mismatch |
RED |
final |
FACE_MISMATCH |
-hold |
ON_HOLD |
null |
PEP_MATCH |
-sanctions |
RED |
final |
SANCTIONS_MATCH |
-duplicate |
RED |
final |
DUPLICATE |
-underage |
RED |
final |
UNDERAGE |
-age-unknown |
ON_HOLD |
null |
AGE_UNKNOWN |
-recapture |
ON_HOLD |
null |
DOC_SCREEN_RECAPTURE |
{ "external_id": "user-8812-hold" }
Izohlar:
-age-unknownfaqat «faqat yosh» senariysida ishlaydi (paneldagi Sozlamalar → Tekshiruvlar); boshqa senariylarda uGREENberadi. «Faqat yosh» senariysida har bir natijadaagetekshiruvi ham boʻladi,-sanctionsva-duplicateesaGREENberadi, chunki u yerda AML va takror tekshiruvlari ishlamaydi.-duplicatesinov rejimida boshqa arizachilarning ID larini qaytarmaydi.-recapturehujjat haqiqiyligi tekshiruvidan oʻtmagan holatni koʻrsatadi:warnholatidagidoc_fraudtekshiruvini qoʻshadi; boshqa sinov natijalarida bunday tekshiruv yoʻq.
Sinov rejimidagi hujjat maʼlumotlari
Sinov rejimida GET /verifications/{id} document.data ichida sintetik namunaviy hujjatni qaytaradi: «ERIKSSON ANNA MARIA», pasport L898902C3, davlat UTO. Sanalar tekshiruv vaqtiga nisbatan hisoblanadi. -expired da hujjat muddati oʻtgan (is_expired: true); -underage da yosh 16. «Faqat yosh» senariylarida document.data ishchi rejimdagidek null boʻladi.
Kodingizning har bir tarmogʻini sinov rejimida sinang: GREEN, retry bilan RED, final bilan RED va ON_HOLD hamda undan keyingi koʻrib chiqish. Sinov rejimidagi ON_HOLD ni POST /verifications/{id}/review orqali yoki panelda hal qilib, verification.reviewed ni qabul qilishingiz mumkin.
Sinov rejimida Direct API
sk_test_ kalit bilan Direct API haqiqiy tekshiruv oʻtkazmaydi: har bir tekshiruv 0.99 ball bilan soxta pass qaytaradi, hujjat tekshiruvi esa oʻsha sintetik namunani qaytaradi. Chaqiruvlar cheklanmaydi, lekin hisoblanadi.
Ishchi rejimga oʻtish
Sinov rejimi roʻyxatdan oʻtgan zahoti ochiladi. Ishchi rejim — sk_live_ kalit yaratish, ishchi API va paneldagi ishchi muhit — paneldagi ikki qadamdan keyin ochiladi:
- Biznes profili. Biznes turi (
company,entrepreneuryokiindividual), yuridik nom, roʻyxatdan oʻtish raqami (jismoniy shaxslar uchun ixtiyoriy), davlat, sayt, loyiha nomi va tavsifi, foydalanish maqsadi va tekshiruvning sukut boʻyicha maqsadi. Dalolatnomalar va ochiq tekshirish sahifasi tekshiruvni qaysi biznes va loyiha nima maqsadda oʻtkazganini shu profildan koʻrsatadi. - Egasining shaxsi. Hisob egasi oddiy KYC tekshiruvidan oʻtadi.
GREENhisobni tasdiqlaydi;ON_HOLDni GOXOST xodimlari koʻrib chiqadi;REDdan keyin qayta urinish mumkin (jami 3 ta urinish).
Ikkala qadam tugamaguncha sk_live_ kalitli har qanday soʻrov quyidagini qaytaradi:
{
"error": {
"code": "tenant_not_verified",
"message": "Live mode opens after your business profile and owner identity are verified.",
"request_id": "req_01m6yyj5gq0x3c7d2n8v5kp4rt"
}
}
HTTP holati 403 bilan. Keyinchalik yuridik nom, roʻyxatdan oʻtish raqami yoki biznes turini oʻzgartirsangiz, ishchi rejim ishlashda davom etadi, lekin profil qayta koʻrib chiqishga belgilanadi.
Limitlar va bepul tarif
Bepul tarif oyiga 100 ta ishchi tekshiruv ni oʻz ichiga oladi. Birlik sessiya yaratilganda band qilinadi va sessiya ishlatilmay muddati oʻtsa, yangi sessiya bilan almashtirilsa yoki arizachi topshirishdan oldin qayta tiklansa yoxud oʻchirilsa, qaytariladi. Alohida AML tekshiruvi va Direct API chaqiruvlarining shu limitdagi oʻz oylik hisoblagichlari bor. Ishchi rejim limiti tugaganda API 429 plan_limit_reached qaytaradi.
Hisoblagichlarni GET /usage bilan tekshiring:
{
"period": "2026-11",
"plan": "free",
"limit": 100,
"live": { "verifications": 12, "aml_checks": 0, "direct_checks": 0 },
"sandbox": { "verifications": 51, "aml_checks": 0, "direct_checks": 7 },
"core_url": "https://…/v1"
}
core_url — Direct API chaqiruvlari uchun asosiy URL.