Kabinetni ochish

Kredit konveyeri uchun API

Xodim kabinetda qiladigan hamma narsani tizimingiz API orqali bajaradi: tekshiruv yaratadi, qarz oluvchiga havola yuboradi, yakuniy hisobot va PDF oladi. Natija webhook orqali keladi, xizmatni soʻrab turish shart emas.

Tamoyillar

  • Manzilda versiya

    Barcha metodlar /api/v1 ostida. Mos kelmaydigan oʻzgarishlar yangi versiyada chiqadi, eskisi ishlashda davom etadi.

  • Yagona javob

    Har bir metod success, code, error va value qaytaradi. Xato Accept-Language dagi tilda matn sifatida keladi.

  • Idempotentlik

    Taym-autdan keyin xuddi shu Idempotency-Key bilan tekshiruv yaratishni takrorlash allaqachon yaratilgan tekshiruvni qaytaradi.

  • Oʻz ariza raqamingiz

    Tekshiruvga tizimingizning externalReferenceId si uzatiladi, tekshiruv bizning identifikatorlarimizni saqlamasdan shu orqali topiladi.

Kirish

Tizim tashkilot nomidan ishlaydi. Ikki usul mos keladi, ikkalasi ham bitta API kaliti va bir xil kirish huquqlaridan foydalanadi.

  • API kaliti

    X-API-Key va VeriCore-Organization-Id sarlavhalari. Kalit siri serverda yaratiladi, bir marta koʻrsatiladi va faqat xesh koʻrinishida saqlanadi.

  • OAuth2 client credentials

    Kalit /api/v1/oauth/token manzilida qisqa muddatli tokenga almashtiriladi. Standart OAuth2 oqimini kutadigan tizimlar uchun mos.

  • Kirish huquqlari

    Oʻn bitta soha: tekshiruvlar, hujjatlar, provayder tekshiruvlari, qoʻlda tekshirish, amallar tarixi, foydalanish hisobi va tashkilot sozlamalari, oʻqish va yozish uchun.

  • IP oq roʻyxati

    Tashkilot oʻz kalitlari qabul qilinadigan manzillarni cheklashi mumkin. Boʻsh roʻyxat cheklovsiz degani.

API orqali tekshiruv yoʻli

Arizadan yakuniy hisobotgacha oltita chaqiruv. Skanerlash, tahlil va tekshiruv qadamlarini platforma orkestratori sizning ishtirokingizsiz bajarishi mumkin.

  1. 01POST/api/v1/verification-cases

    Tekshiruv yaratish: qarz oluvchi va hisobot davlati, ariza beruvchi turi, ariza raqamingiz

  2. 02POST/verification-cases/{id}/upload-link

    Qarz oluvchiga yuklash portaliga bir martalik havola berish

  3. 03POST/verification-cases/{id}/documents/signed-upload-url

    Yoki faylni imzolangan havola orqali oʻzingiz yuklash

  4. 04POST/verification-cases/{id}/provider-checks/start-session

    Qarz oluvchi uchun KYC yoki KYB sessiyasini boshlash

  5. 05POST/verification-cases/{id}/summary/generate

    Yakuniy hisobotni yigʻish: shaxsni solishtirish, haqiqiylik, belgilar, tavsiya

  6. 06GET/verification-cases/{id}/summary/pdf

    QR-kodli yakuniy hisobot PDF ini olish

Tekshiruv yaratish

Javobda darhol qarz oluvchi uchun portal manzili boʻladi. Havolani SMS, messenjer orqali yuborish yoki ekranda QR-kod sifatida koʻrsatish mumkin.

POST /api/v1/verification-cases
X-API-Key: vk_live_…
VeriCore-Organization-Id: 7c1f…
Idempotency-Key: 5b0e8f2a-…

{
  "externalReferenceId": "LOAN-2026-104233",
  "applicantType": "Individual",
  "applicantCountryCode": "UZ",
  "reportCountryCode": "UZ"
}
{
  "success": true,
  "code": 200,
  "value": {
    "id": "c4d1…",
    "status": "AwaitingApplicant",
    "applicantUploadUrl": "https://app.vericore.a3.solutions/apply/…"
  }
}

Webhooklar

Manzilni kerakli hodisalarga obuna qiling. Har bir yetkazish vaqt belgisi va soʻrov tanasidan HMAC-SHA256 bilan imzolanadi, nosozlikda takrorlanadi va yetkazish jurnalida saqlanadi.

case.status_changed

Tekshiruv yangi holatga oʻtdi

document.uploaded

Qarz oluvchi yoki tizimingiz hujjat yukladi

document.status_changed

Hujjatni qayta ishlash holati oʻzgardi

manual_review.status_changed

Qoʻlda tekshirish vazifasi oʻzgardi

summary.generated

Yakuniy hisobot shakllantirildi

Imzoni qanday tekshirish kerak

HMAC-SHA256 ni “vaqt belgisi, nuqta, soʻrov tanasi” qatoridan manzil siri bilan qayta hisoblang va X-VeriCore-Signature sarlavhasi bilan solishtiring. Vaqt belgisi juda eski boʻlgan soʻrovni rad eting.

X-VeriCore-Event: summary.generated
X-VeriCore-Delivery: 9a71…
X-VeriCore-Timestamp: 1791964800
X-VeriCore-Signature: 3f6c…

Berilgan hisobotni tekshirish

PDF dagi QR-kod ommaviy tekshiruv manziliga olib boradi. Uni oʻz “hisobotni tekshirish” interfeysingizga oʻrnatish mumkin: javob hisobot platforma tomonidan berilgani va oʻzgartirilmaganini koʻrsatadi.

QR-kod orqali tekshiriladigan hisobot

API himoyasi

  • Ommaviy manzillarda soʻrovlar chastotasini cheklash, hisobotni parol bilan ochish uchun alohida qatʼiy limit
  • Webhook manzillari tekshiriladi: xususiy tarmoqlar va xavfsiz boʻlmagan sxemalar rad etiladi
  • Hujjatlar muddati cheklangan imzolangan havolalar orqali uzatiladi
  • Fayl saqlash kaliti server tomonidan hisoblanadi, mijoz birovning faylini koʻrsata olmaydi
  • Ishchi muhitda API hujjatlari anonim kirishdan yopiq

Hujjatlar va sinov muhiti

Olti tilda Scalar interfeysli OpenAPI 3.1 tavsifi va integratsiyani sozlash uchun test tekshiruvlari bilan bepul sinov muhiti.

API hujjatlariSinov muhitidan boshlash