Dalolatnoma nima
Dalolatnoma yakuniy qarori bor har bir tekshiruvga beriladi — GREEN yoki RED. ON_HOLD ishga dalolatnoma xodimingiz qaror qilgandan keyin beriladi. U qarordan taxminan 5 daqiqa keyin tayyor boʻladi, buni certificate.issued webhooki xabar qiladi.
Dalolatnomada nimalar bor:
| Boʻlim | Mazmuni |
|---|---|
| Soʻrovchi | Kompaniyangiz (biznes profilidagi yuridik nom), loyiha, sayt |
| Maqsad | Tekshiruv nima uchun qilingani: sessiya purpose i, boʻlmasa arizachiniki, u ham boʻlmasa biznes profilingizdagi standart maqsad |
| Shaxs | Toʻliq ism, tugʻilgan sana, hujjat turi, mamlakati va raqami |
| Qaror | Tasdiqlangan, rad etilgan yoki bekor qilingan (koʻrib chiqish muddati oʻtgan), qaror sanasi, qoʻlda qaror qilingan boʻlsa — xodim |
| Bajarilgan tekshiruvlar | Qaysi tekshiruvlar qilingani (hujjat, selfi va hujjat mosligi, shaxs ishtirokini tekshirish, sanksiyalar, …) oddiy soʻzlar bilan |
| Amal qilish muddati | GREEN uchun — qachongacha amal qiladi (qarordan 2 yil); RED da muddat boʻlmaydi |
| Rozilik | Odam qachon rozilik bergani, rozilik matni versiyasi, qurilma va IP manzil |
| Shartnoma | Sessiya yaratishda contract yuborgan boʻlsangiz — shartnoma raqami va uning SHA-256 qiymati |
| Rasmlar | Tekshiruvda ishlatilgan saqlangan rasmlarning SHA-256 izlari |
PDF da dalolatnoma raqami (crt_…) va uning tekshiruv sahifasini ochadigan QR kod bor. Ballar, mashina sabab kodlari va ichki qaror usuli chop etilmaydi.
Dalolatnoma hech qachon oʻzgarmaydi. Qayta koʻrib chiqishdan keyin qaror oʻzgarsa, yangi versiya beriladi, eskisi esa almashtirilgan deb belgilanadi. Arizachi oʻchirilganda saqlangan dalolatnoma matni oʻchiriladi va tekshiruv sahifasi dalolatnomani bekor qilingan deb koʻrsatadi.
Sinov rejimida yaratilgan dalolatnomalarda «Sinov rejimi — bu dalolatnoma yuridik kuchga ega emas» degan belgi boʻladi.
Dalolatnoma tekshiruv oʻtkazilganini va oʻsha sanada nima koʻrsatganini isbotlaydi. U shaxsni tasdiqlovchi hujjat emas va mijoz bilan shartnomangizni tasdiqlamaydi.
API orqali yuklab olish
GET /verifications/{id}/certificate yakuniy tekshiruvning dalolatnomasini qaytaradi.
| Parametr | Qiymatlar | Standart |
|---|---|---|
format |
pdf — chop etishga tayyor PDF (crt_….pdf nomi bilan yuklanadi); json — mashina oʻqiydigan mazmun |
json |
lang |
PDF tili: uz, ru, en |
uz |
curl "https://kyc.goxost.net/api/v1/verifications/ver_01m6yyj5dztvhsx7kk9h8qwcnf/certificate?format=pdf&lang=en" \
-H "Authorization: Bearer sk_live_…" \
-o certificate.pdf
$client = new GuzzleHttp\Client(['base_uri' => 'https://kyc.goxost.net/api/v1/']);
$client->get('verifications/ver_01m6yyj5dztvhsx7kk9h8qwcnf/certificate', [
'headers' => ['Authorization' => 'Bearer ' . getenv('KYC_SECRET_KEY')],
'query' => ['format' => 'pdf', 'lang' => 'en'],
'sink' => __DIR__ . '/certificate.pdf',
]);
import { writeFile } from 'node:fs/promises';
const res = await fetch(
'https://kyc.goxost.net/api/v1/verifications/ver_01m6yyj5dztvhsx7kk9h8qwcnf/certificate?format=pdf&lang=en',
{ headers: { Authorization: `Bearer ${process.env.KYC_SECRET_KEY}` } },
);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
await writeFile('certificate.pdf', Buffer.from(await res.arrayBuffer()));
import os, requests
res = requests.get(
"https://kyc.goxost.net/api/v1/verifications/ver_01m6yyj5dztvhsx7kk9h8qwcnf/certificate",
headers={"Authorization": f"Bearer {os.environ['KYC_SECRET_KEY']}"},
params={"format": "pdf", "lang": "en"},
)
res.raise_for_status()
open("certificate.pdf", "wb").write(res.content)
JSON formatida PDF dagi mazmunning oʻzi tuzilgan koʻrinishda keladi (certificate.requester, certificate.purpose, certificate.subject, certificate.verification, certificate.valid_until, certificate.verify_url, …), qoʻshimcha ravishda uning elektron imzosi va status hamda superseded_by bor meta bloki. Keyin kerak boʻlsa, PDF yoki JSON ni hujjatlaringiz bilan saqlab qoʻying. Haqiqiyligini isbotlash uchun tekshiruv sahifasidan yoki GET /certificates/{id} dan foydalaning — imzoni faqat GOXOST KYC tekshiradi.
Takroriy soʻrovlar aynan bir xil hujjatni qaytaradi. Har bir yuklab olish audit jurnalingizga yoziladi.
| Xato | Qachon |
|---|---|
409 conflict |
Tekshiruv ON_HOLD holatida (yakuniy qaror hali yoʻq) |
404 not_found |
Nomaʼlum tekshiruv yoki arizachi oʻchirilgan |
400 validation_failed |
Qoʻllab-quvvatlanmaydigan format yoki lang |
503 certificate_unavailable |
Dalolatnomalar vaqtincha mavjud emas — keyinroq urinib koʻring |
Panelda arizachi sahifasidagi Dalolatnomani yuklab olish tugmasi xuddi shu fayllarni beradi.
Dalolatnomani tekshirish
Dalolatnomani isbot kerak boʻlgan har kimga bering — bankka, hamkorga, odamning oʻziga. Ularga hisob kerak emas. https://kyc.goxost.net/verify sahifasi uch usulni taklif qiladi.
1. Raqam yoki QR kod orqali
PDF dagi QR kodni skanerlang, https://kyc.goxost.net/verify/crt_… havolasini oching yoki https://kyc.goxost.net/verify dagi qidiruvga dalolatnoma raqamini yozing (yoki havolani qoʻying). Sahifa quyidagilarni koʻrsatadi:
- dalolatnoma haqiqiymi, yaroqsizmi, yangi versiya bilan almashtirilganmi yoki bekor qilinganmi;
- soʻrovchi va maqsad;
- berilgan sana, qaror va amal qilish muddati;
- hujjat turi va yashirilgan hujjat raqami (birinchi 2 va oxirgi 4 belgi, masalan
L8•••02C3); - odam qachon rozilik bergani.
Odamning ismi, tugʻilgan sanasi va boshqa shaxsiy maʼlumotlari bu yerda koʻrsatilmaydi.
2. PDF ni yuklash
Shu sahifaning oʻzida PDF faylni yuklang (4 MB gacha). U GOXOST KYC bergan PDF bilan bayt-ma-bayt solishtiriladi — har qanday oʻzgarish, hatto bitta belgi ham tekshiruvdan oʻtmaydi. Fayl saqlanmaydi.
3. Nusxadagi hujjat raqamini kiritish
Kimdir bosma nusxa yoki skan koʻrsatsa, unda yozilgan toʻliq hujjat raqamini kiriting. Raqam dalolatnomaga mos kelsa, sahifa nusxa bilan solishtirish uchun toʻliq ism va hujjat raqamini ochadi. Mos kelmasa, nusxa oʻzgartirilgan yoki soxta. Bitta dalolatnomani bu usulda kuniga 20 martagacha tekshirish mumkin.
Dalolatnomani qayerda ulashsangiz ham, yoniga tekshiruv havolasini qoʻying — oluvchi uni bir bosishda tasdiqlay oladi.
Dalolatnoma holati
Oʻz dalolatnomalaringizdan birini koddan tekshirish uchun shu muhitning API kaliti bilan GET /certificates/{certificate_id} ni chaqiring. Javobda shaxsiy maʼlumot yoʻq.
curl https://kyc.goxost.net/api/v1/certificates/crt_01m6yyj5eaqdmyg2ty0mheaj3h \
-H "Authorization: Bearer sk_live_…"
{
"certificate_id": "crt_01m6yyj5eaqdmyg2ty0mheaj3h",
"version": 1,
"status": "current",
"signature_valid": true,
"valid": true,
"decision": "GREEN",
"outcome": "approved",
"issued_at": "2026-11-09T10:09:30Z",
"valid_until": "2028-11-09T10:04:12Z",
"expired": false,
"superseded_by": null,
"verify_url": "https://kyc.goxost.net/verify/crt_01m6yyj5eaqdmyg2ty0mheaj3h"
}
status |
Maʼnosi |
|---|---|
current |
Dalolatnomaning eng soʻnggi versiyasi |
superseded |
Qayta koʻrib chiqish yangi versiya berdi — superseded_by ga qarang |
revoked |
Arizachi oʻchirildi; dalolatnoma bekor qilingan |
invalid_signature |
Saqlangan matn imzosiga mos kelmaydi — unga ishonmang |
valid — «bu odam hozir tasdiqlanganmi?» degan savolga yagona javob: u faqat status current, qaror GREEN va valid_until hali oʻtmagan boʻlsa true boʻladi.
Amal qilish muddati va qayta tekshiruv
GREEN natija qarordan boshlab 2 yil amal qiladi (tekshiruv, arizachi va dalolatnomadagi valid_until). Muddat tugashidan 30 kun oldin va tugaganda yana applicant.reverification_due keladi. Odamni qayta tekshirish uchun POST /applicants/{id}/reset ni chaqiring va yangi sessiya yarating — yangi tekshiruvga oʻz dalolatnomasi beriladi.