Кабинет нээх

Зээлийн процесст зориулсан API

Ажилтан кабинетад хийдэг бүхнийг таны систем API-аар хийнэ: шалгалт үүсгэж, зээлдэгчид холбоос илгээж, дүгнэлт ба PDF авна. Үр дүн вебхукаар ирдэг тул үйлчилгээнээс байнга лавлах шаардлагагүй.

Зарчим

  • Хаягт хувилбар

    Бүх арга /api/v1 дор байна. Нийцгүй өөрчлөлт шинэ хувилбараар гарч, хуучин нь ажилласаар байна.

  • Нэгдсэн хариу

    Арга бүр success, code, error, value буцаана. Алдаа Accept-Language-д заасан хэлээр текстээр ирнэ.

  • Идемпотент байдал

    Хугацаа хэтэрсний дараа ижил Idempotency-Key-ээр шалгалтыг дахин үүсгэвэл аль хэдийн үүссэн шалгалтыг буцаана.

  • Өөрийн хүсэлтийн дугаар

    Шалгалтад таны системийн externalReferenceId-г дамжуулж, манай танигчийг хадгалахгүйгээр түүгээр шалгалтыг олно.

Хандалт

Систем байгууллагын нэрийн өмнөөс ажиллана. Хоёр арга тохирох бөгөөд хоёулаа нэг API түлхүүр, нэг хандах эрхийг ашиглана.

  • API түлхүүр

    X-API-Key ба VeriCore-Organization-Id толгой. Түлхүүрийн нууцыг сервер үүсгэж, нэг удаа харуулаад зөвхөн хэш хэлбэрээр хадгална.

  • OAuth2 client credentials

    Түлхүүрийг /api/v1/oauth/token хаягаар богино хугацааны токеноор солино. OAuth2-ын стандарт урсгал хүлээдэг системд тохирно.

  • Хандах эрх

    Арван нэгэн хүрээ: шалгалт, баримт бичиг, нийлүүлэгчийн шалгалт, гар шалгалт, үйлдлийн түүх, хэрэглээний бүртгэл, байгууллагын тохиргоог унших ба бичих.

  • IP цагаан жагсаалт

    Байгууллага түлхүүрээ хүлээн авах хаягуудыг хязгаарлаж болно. Хоосон жагсаалт хязгааргүй гэсэн үг.

API дахь шалгалтын зам

Хүсэлтээс дүгнэлт хүртэл зургаан дуудлага. Скан, задлах, шалгах алхмуудыг платформын оркестратор таны оролцоогүйгээр гүйцэтгэж болно.

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

    Шалгалт үүсгэх: зээлдэгч ба тайлангийн улс, хүсэлт гаргагчийн төрөл, таны хүсэлтийн дугаар

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

    Зээлдэгчид байршуулах портал руу нэг удаагийн холбоос олгох

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

    Эсвэл гарын үсэгтэй холбоосоор файлаа өөрөө байршуулах

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

    Зээлдэгчид KYC эсвэл KYB сесс эхлүүлэх

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

    Дүгнэлт гаргах: хувийн мэдээллийн тулгалт, жинхэнэ байдал, тэмдэглэгээ, зөвлөмж

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

    QR кодтой дүгнэлтийн PDF авах

Шалгалт үүсгэх

Хариуд зээлдэгчийн порталын хаяг шууд агуулагдана. Холбоосыг SMS, мессенжерээр илгээх эсвэл дэлгэцэн дээр QR кодоор үзүүлж болно.

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/…"
  }
}

Вебхук

Хаягаа хэрэгтэй үйл явдалд бүртгүүлнэ үү. Хүргэлт бүр цагийн тэмдэг ба хүсэлтийн биеэс HMAC-SHA256 гарын үсэгтэй, алдаа гарвал давтагдаж, хүргэлтийн журналд хадгалагдана.

case.status_changed

Шалгалт шинэ төлөвт шилжсэн

document.uploaded

Зээлдэгч эсвэл таны систем баримт байршуулсан

document.status_changed

Баримт боловсруулалтын төлөв өөрчлөгдсөн

manual_review.status_changed

Гар шалгалтын даалгавар өөрчлөгдсөн

summary.generated

Андеррайтингийн дүгнэлт гарсан

Гарын үсгийг хэрхэн шалгах вэ

«Цагийн тэмдэг, цэг, хүсэлтийн бие» мөрөөс хаягийн нууцаар HMAC-SHA256-г дахин тооцоолж, X-VeriCore-Signature толгойтой харьцуулна уу. Хэт хуучин цагийн тэмдэгтэй хүсэлтийг татгалзана уу.

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

Олгосон тайланг шалгах

PDF дахь QR код нийтийн шалгах хаяг руу хөтөлнө. Үүнийг өөрийн «тайлан шалгах» интерфэйст суулгаж болно: хариу нь тайланг платформ олгосон эсэх, өөрчлөгдсөн эсэхийг харуулна.

QR кодоор шалгадаг тайлан

API хамгаалалт

  • Нийтийн хаягууд дээр хүсэлтийн давтамжийн хязгаар, тайланг нууц үгээр нээхэд тусдаа хатуу хязгаар
  • Вебхукийн хаягийг шалгана: хувийн сүлжээ, аюултай схемийг татгалзана
  • Баримтыг хязгаарлагдмал хугацаатай, гарын үсэгтэй холбоосоор дамжуулна
  • Файл хадгалах түлхүүрийг сервер тооцоолох тул харилцагч өөр хүний файлыг зааж чадахгүй
  • Ажлын орчинд API-ийн баримт бичигт нэргүй хандалтыг хаасан

Баримт бичиг ба туршилтын орчин

Зургаан хэлээр Scalar интерфэйстэй OpenAPI 3.1 тодорхойлолт, интеграцыг тохируулах туршилтын шалгалттай үнэгүй туршилтын орчин.

API-ийн баримт бичигТуршилтын орчноос эхлэх