Asosiy qismga oʻtish
API hujjati API kalitini olish

Integratsiya · 7-bob

Dalolatnomalar

Har bir yakuniy tekshiruvga elektron imzo bilan tasdiqlangan tekshiruv dalolatnomasi beriladi. Unda tekshiruvni kim, nima uchun soʻragani va qanday qaror chiqqani yoziladi. Uning haqiqiyligini istalgan odam https://kyc.goxost.net/verify sahifasida tekshira oladi.

4 daqiqa oʻqish

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.

Eslatma

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.

Maslahat

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.