API ба платформын үйл явдал

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

Хандалт ба толгой

Хүсэлт тодорхой байгууллага, тодорхой локальд хандана. Түлхүүр хандах хүрээтэй олгогдож, ажлыг зогсоолгүй дахин гаргагдаж, хүчингүй болгож болно.

API-ийн баримт бичиг
Organization-Id
Байгууллагыг тодорхойлно. Түрээслэгчид тусдаа сан горимд үүгээр холболт сонгогдоно.
Language-Code
Хариуны локаль: лавлах, төлөвийн нэр, баримтын текст энэ хэлээр буцна.
X-Api-Key
Түншийн интеграцийн түлхүүр. Хандах хүрээ нь боломжит аргуудын багцыг хязгаарлана.
Idempotency-Key
Мөнгөн гүйлгээний давталтын түлхүүр: дахин илгээхэд хоёр дахь гүйлгээ үүсэхгүй.

API хэсгүүд

Аргууд сэдвийн чиглэлээр бүлэглэгдэж, платформын бүтцийг давтана.

Хүсэлт

Хүсэлт үүсгэх, шалгалтын алхам, баримт, андеррайтингийн шийдвэр.

/applications

Харилцагч

Профайл, танигч, баримт, зөвшөөрөл, банкны мэдээлэл.

/customers

Гэрээ

Төлбөрийн хуваарь, тооцоолол, төлбөр, өрийн бүрэлдэхүүнээр хуваарилалт.

/loans

Скоринг

Загвар, дүрэм, шинж, нөлөөлсөн хүчин зүйлийн жагсаалттай үр дүн.

/scoring

Комплаенс ба AML

Бүртгэлийн шалгалт, сэрэмжлүүлэг, эрсдэлийн профайл, зохицуулагчид мэдэгдэх.

/compliance, /aml

Өр барагдуулалт

Хэрэг, холбоо барилт, төлөх амлалт, шүүхийн ажиллагаа, шаардах эрхийн багц.

/collection

Санхүүжилт

Хөрөнгө оруулагч, татан төвлөрүүлэх гэрээ, бондын цуврал, төлбөр.

/funding

Тайлан

Маягтын загвар, ноорог, шалгалт, шаардлагатай форматаар ачаалах.

/reporting, /tax-reporting

Харилцагчийн кабинет

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

/public/customer

Үйл явдал ба вэбхук

Гэрээний өөрчлөлт гарах дараалалаар гадагш нийтлэгдэнэ. Хүргэлт өсөн нэмэгдэх завсартай давталтаар баталгаажиж, хүргэгдээгүй мессеж алдагдалгүйгээр тусдаа дараалалд ордог.

  • Үйл явдлын захиалга

    Хүлээн авах хаяг, үйл явдлын багц, гарын үсгийн нууц байгууллагад тохируулагдана.

  • Хүргэлтийн бүртгэл

    Оролдлого бүрд хариуны код, бие, дараагийн давталтын хугацаа харагдана.

  • Товчоонд илгээх үйл явдал

    Гэрээ ба зээлийн шугамын гучин гурван төрлийн үйл явдал зээлийн мэдээллийн санд илгээгдэнэ.

  • Нягтланд илгээх үйл явдал

    Гучин гурван төрлийн үйл явдал бүртгэлийн системд HTTP эсвэл файл солилцоогоор илгээгдэнэ.

Орчин ба хязгаарлалт

Бодит холболт хүртэл гадаад нийлүүлэгч түр орлуулагч горимд ажиллана: систем бүтнээрээ хариулах боловч мөнгө хөдлөхгүй, бодит шалгалт хийгдэхгүй.

Гадаад үйлчилгээ рүү хийсэн дуудлага бүр хүсэлт ба хариуны агуулгатайгаа хамт бүртгэлд хадгалагдаж, API түлхүүрийг зөвхөн хэш хэлбэрээр хадгална.

Хүсэлтийн жишээ
GET /Applications/GetApplications?Offset=0&Count=20
Organization-Id: 42
Language-Code: ru
X-Api-Key: ••••••••
Хариуны формат
Нэгдсэн бүрхүүл дэх JSON: код, амжилтын шинж, алдааны текст, ачаалал.
Хуудаслалт
Серверийн талд. Шилжилт ба тоо хүсэлтэд дамжиж, хариунд нийт бичлэгийн тоо ирнэ.
Идемпотент байдал
Мөнгөн гүйлгээ, хуваарийн өөрчлөлтөд заавал.
Локалчлал
Зургаан хэл. Локаль байгууллагын тохиргоогоор бус, хүсэлтийн толгойгоор тодорхойлогдоно.
Туршилтын орчин
Ижил гэрээтэй, нийлүүлэгчийн оронд түр орлуулагчтай тусдаа хүрээ.
Хувилбарчлал
Нийцэхгүй өөрчлөлт тусдаа хувилбараар гарч, хуучин нь дагалдах гэрээний дагуу ажилласаар байна.

Түгээмэл асуулт

Интерфэйсгүйгээр зөвхөн API-аар ажиллаж болох уу

Тийм. Ажилтны интерфэйс мөн API-г ашигладаг тул интерфэйст боломжтой хувилбар түлхүүрийн хандах хүрээний хүрээнд гадаад үйлчлүүлэгчид ч боломжтой.

Түншийн баталгаажуулалт хэрхэн зохион байгуулагдсан бэ

Түнш хязгаарлагдмал хандах хүрээтэй түлхүүр авна. Түлхүүр хэш хэлбэрээр хадгалагдаж, зогсолтгүй дахин гаргагдаж, бүх дуудлага хүсэлт, хариуны биетэйгээ гадаад хандалтын бүртгэлд ордог.

Төлбөрийг дахин илгээвэл юу болох вэ

Мөнгөн гүйлгээ давталтын түлхүүр хүлээн авна. Мөн түлхүүртэй давтагдсан хүсэлт эхний гүйлгээний үр дүнг буцааж, хоёр дахь гүйлгээ үүсгэхгүй.

Хугацаа хэтрэлт эсвэл төлөлтийн мэдэгдлийг хэрхэн авах вэ

Үйл явдлын захиалгаар. Хүлээн авах хаяг, үйл явдлын багц, гарын үсгийн нууцыг зааж өгнө. Хүргэлтийн оролдлого бүр бүртгэгдэж, амжилтгүй нь өсөн нэмэгдэх завсартайгаар давтагдана.