Nenda kwenye maudhui makuu

Wasanidi programu na uendeshaji wa kiotomatiki

REST API, webhooks na kusaini kidijitali kwa mifumo inayozunguka kitabu chako cha mikopo

Tumia API kusoma na kuandika wakopaji, mikopo na marejesho kutoka programu yako mwenyewe, webhooks kupata habari za mabadiliko yanapotokea, na kusaini kidijitali kulikojengwa ndani ili nyaraka za mkopo zisainiwe bila huduma tofauti ya sahihi.

Orodhesha wakopaji 20 wa kwanzabash
curl "https://api.lendbox.io/borrowers?page=1&limit=20" \
  -H "Authorization: Bearer live_your_api_key"
Hali
Imejengwa ndani
Mipango
API kwenye Business, Growth na Enterprise
Mazingira
Majaribio (sandbox) na uzalishaji
Nyaraka
api.lendbox.io/docs

Anza haraka

Hatua nne kutoka mwanzo kabisa hadi jibu lako la kwanza.

  1. 1Tengeneza ufunguoKwenye dashibodi, fungua API Integration → REST API na uchague Generate New API Key. Uhifadhi mahali salama. Kutengeneza ufunguo mpya kunasimamisha ule wa zamani, hivyo ubadilishe kila mtu mwenye ufikiaji anapoondoka.
  2. 2Chagua mazingiraMajaribio (sandbox) na uzalishaji ni mazingira tofauti, kila moja na URL yake ya msingi, funguo zake na data yake: https://sandbox-api.lendbox.io na https://api.lendbox.io. Funguo za sandbox zinaanza na sandbox_ na funguo za uzalishaji na live_. Jenga dhidi ya sandbox kwanza.
  3. 3Tuma ufunguo kwenye kila ombiUpitishe kama bearer token kwenye kichwa cha Authorization. Misimbo ya majibu ambayo API inarudisha imeorodheshwa kwenye ukurasa huohuo wa dashibodi.
  4. 4Fanya kazi kutoka kwenye marejeoKila endpoint, kigezo na muundo wa jibu uko kwenye nyaraka za umma katika api.lendbox.io/docs. Orodha ya wakopaji, kwa mfano, inagawanywa kwa kurasa kwa vigezo vya page na limit.
Ukurasa wa REST API wenye kadi ya ufunguo wa API, kichwa cha Authorization na URL za msingi za sandbox na uzalishaji

Ufunguo mmoja kwa kila eneo la kazi, ukionyeshwa pamoja na kichwa cha kuutumia na URL zote mbili za msingi.

Timu zinajenga nini juu yake

Miunganisho mingi iko katika mojawapo ya mifumo minne. Kila mmoja unatumia endpoints zilizo kwenye marejeo ya umma leo.

  • Sajili wateja kutoka programu yako mwenyewe

    Unda wakopaji na mikopo kutoka tovuti yako mwenyewe au programu yako ya usajili kwa maombi ya POST, ili ombi la mkopo lililopokelewa nje ya Lendbox lisihitaji kuandikwa mara mbili.

  • Ingiza marejesho kutoka njia nyingine

    Fedha zinapofika mahali ambapo Lendbox haiunganishwi nako, kama akaunti ya benki au malipo ya mishahara, ingiza rejesho kwenye mkopo wake kwa ombi moja kutoka mfumo ulioziona.

  • Lisha ripoti zako mwenyewe

    Soma wakopaji, mikopo na marejesho kwa ratiba kwenda ghala la data au zana ya BI, na utumie webhooks kujua rekodi zipi zilibadilika katikati.

  • Anzisha mitiririko yako mwenyewe ya kazi

    Tumia tukio la kuundwa kwa rejesho kutuma ujumbe wa shukrani kutoka CRM yako, au tukio la kuundwa kwa mkopo kufungua faili kwenye mfumo wako wa nyaraka.

Jinsi funguo za API zinavyofanya kazi

  • Ufunguo mmoja kwa kila eneo la kazi. Unatenda kwa ufikiaji wa mmiliki wa eneo la kazi, hivyo uchukulie kama nenosiri la mmiliki na uuweke kwenye seva yako, kamwe si kwenye kivinjari au programu.
  • Funguo haziishi muda zenyewe. Tengeneza ufunguo upya kutoka kwenye dashibodi ili kuubatilisha.
  • Kuona na kusimamia ukurasa wa API ni ruhusa yake yenyewe ya wafanyakazi, hivyo unaweza kuiwekea mipaka kwa watu wanaojenga miunganisho.
  • Ufikiaji wa API umejumuishwa kwenye mipango ya Business, Growth na Enterprise.

Webhooks: pata habari za mabadiliko yanapotokea

Ongeza webhook chini ya API Integration → Webhooks: weka URL ya endpoint unayoidhibiti na uweke alama kwenye matukio inayopaswa kupokea. Lendbox inatuma JSON POST kwenda URL hiyo kila mara moja ya matukio hayo linapotokea.

Matukio ya webhook ndani ya Lendbox, kwa rekodi na mabadiliko
RekodiImeundwaImesasishwaImefutwa
MkopoNdiyoNdiyoNdiyo
MkopajiNdiyoNdiyoNdiyo
RejeshoNdiyoNdiyoNdiyo
MwekezajiNdiyoNdiyoNdiyo
Bidhaa ya mwekezajiNdiyoNdiyoNdiyo
Akaunti ya mwekezajiNdiyoNdiyoNdiyo
Vichwa kwenye kila uwasilishajihttp
POST /your/webhook/endpoint
Content-Type: application/json
X-LendBox-Event: <event name>
X-LendBox-Webhook-ID: <your webhook's id>
X-LendBox-Event
Tukio lipi limetokea, ili endpoint moja iweze kushughulikia kadhaa.
X-LendBox-Webhook-ID
Ni webhook ipi kati ya zako iliyotuma uwasilishaji huo.

Kujenga kipokezi kinachostahimili

  1. Jibu haraka

    Lendbox inasubiri sekunde kumi endpoint yako ijibu. Kiri kupokea uwasilishaji kwanza na ufanye kazi ya polepole baadaye.

  2. Chukulia uwasilishaji kama ishara

    Kabla ya kuchukua hatua kwa tukio, chukua mkopo, mkopaji au rejesho linalotajwa kutoka kwenye API. Unapata rekodi ya sasa, na unathibitisha kuwa tukio ni la kweli.

  3. Linganisha kwa ratiba

    Kila tukio linawasilishwa mara moja. Usomaji wa kila usiku kupitia API unanasa chochote ambacho endpoint yako ilikosa ilipokuwa haifanyi kazi, na vishughulikiaji visivyoathiriwa na kurudiwa (idempotent) vinafanya marudio yasiwe na madhara.

Kusaini nyaraka za mkopo kidijitali, kumejengwa ndani

Mikataba ya mikopo, taarifa na ratiba za marejesho husainiwa ndani ya Lendbox, hivyo nakala iliyosainiwa inakaa kwenye mkopo badala ya akaunti ya huduma nyingine.

  1. 1Andaa kiolezo

    Chini ya Documents → Loan Templates, andika mkataba kwenye kihariri ukiwa na vishika nafasi vya maelezo ya mkopaji na mkopo, au pakia hati ya Word ambayo tayari ina vishika nafasi.

  2. 2Weka alama mahali watu wanaposaini

    Kwenye violezo vyako mwenyewe, weka sehemu za sahihi na za maandishi mara moja, na kila mkopo unaotumia kiolezo hicho unapata maeneo yaleyale ya kusaini. Loan Statement na Repayment Schedule zilizojengwa ndani zinakuja na sehemu zake za sahihi zikiwa tayari mahali pake.

  3. 3Tuma viungo

    Kutoka kichupo cha Documents cha mkopo, chagua Send for Signature. Saini wewe mwenyewe, mtumie mkopaji kiungo chake kwa barua pepe, ongeza afisa wa mikopo, na ongeza wasainiaji wengine kama ndugu wa karibu.

  4. 4Kusanya sahihi

    Kila msainiaji anachora sahihi yake kwenye skrini na kuhifadhi. Kila sahihi inazalisha toleo jipya la PDF, hivyo kusaini kwa upande wa pili kunawezekana na matoleo ya awali yanabaki kwenye mkopo.

Kidirisha cha Signing Links kwenye mkataba wa mkopo chenye chaguo za mkopaji, afisa wa mikopo na msainiaji wa ziada

Viungo vya kusaini vinaenda kwa mkopaji, afisa wa mikopo na mtu mwingine yeyote unayemwongeza.

Kila kiungo cha kusaini kinafanya kazi mara moja na kinaisha muda baada ya siku saba.

Rekodi ya kusaini inahifadhi nini

Kinachorekodiwa

  • Jina na jukumu la msainiaji: mkopaji, afisa wa mikopo au mwingine
  • Lini alisaini
  • Kila toleo la hati, kabla na baada ya kila sahihi

Kisichorekodiwa

  • Msimbo wa matumizi ya mara moja: hakuna unaotumwa, hivyo kumiliki kiungo kilichotumwa kwa barua pepe ndiko kunakomtambulisha msainiaji
  • Anwani ya IP au kifaa cha msainiaji
  • Cheti tofauti cha ukamilishaji

Wafanyakazi wanaweza kuhifadhi sahihi yao wenyewe chini ya Settings → Admin → My signature, kisha kujaza kila sehemu waliyopangiwa kwa kubofya mara moja.

Maswali yanayoulizwa mara kwa mara

Je, Lendbox ina API ya umma?
Ndiyo. Ni REST API yenye nyaraka za umma katika api.lendbox.io/docs, mazingira tofauti ya majaribio (sandbox) na ya uzalishaji, na uthibitishaji kwa bearer token ukitumia ufunguo unaoutengeneza kwenye dashibodi.
Mipango ipi inajumuisha ufikiaji wa API?
Business, Growth na Enterprise. Kusaini kidijitali kumejumuishwa kwenye kila mpango.
Je, webhook inaweza kuniambia rejesho linapoingizwa?
Ndiyo. Jiandikishe kwa tukio la kuundwa kwa rejesho. Lendbox inatuma ombi kwenye endpoint yako rejesho linapoundwa, na kisha unaweza kulichukua kutoka kwenye API kwa rekodi kamili.
Je, sahihi za kidijitali za Lendbox zinafunga kisheria?
Hilo linategemea sheria ya mahali unapokopesha na hati husika, hivyo wasiliana na mshauri wako wa kisheria. Lendbox inarekodi nani alisaini, kwa jukumu gani na lini, na inahifadhi kila toleo la PDF iliyosainiwa kwenye mkopo.
Je, wakopaji wanaweza kusaini kwenye simu zao?
Ndiyo. Kiungo cha kusaini kinafunguka kwenye kivinjari cha simu na mkopaji anachora sahihi yake kwa kidole. Hakuna cha kusakinisha.
Je, naweza kuunganisha Lendbox na programu ya uhasibu kupitia API?
Unaweza kuujenga. API inasoma wakopaji, mikopo na marejesho na webhooks zinatangaza mabadiliko, hivyo msanidi programu anaweza kuyasukuma kwenda mfumo mwingine. Hakuna kiunganishi kilicho tayari kwa QuickBooks au Xero.

Jenga juu ya Lendbox

Anza jaribio la bure, soma marejeo ya API, na uunganishe mazingira ya uzalishaji ukiwa tayari.

Hakuna kadi inahitajika

Soma nyaraka za API