Skip to content
Makala zote

Kiungo cha SDK kilichopachikwa au kilichopangishwa: kuchagua jinsi ya kuunganisha uthibitishaji

Charles Archibong

, Mwanzilishi mwenza

Ingiza SDK wakati uthibitishaji unapotokea ndani ya bidhaa yako; tuma kiungo kinachoshikiliwa na kila mwombaji kinapotokea nje yake. Vyovyote vile, endesha mtiririko wa kazi uliochapishwa ili chaguo liwe kuhusu uwasilishaji, si kuhusu mtiririko.

Kichwa cha habari "SDK embed au hosting link" kando ya mfano wa sehemu moja ya kuanzia ikigawanyika katika njia mbili, kwenye gradient ya kina ya indigo.

Mambo muhimu

  • Chagua sehemu ambapo uthibitishaji hutokea: ndani ya bidhaa yako (iliyopachikwa) au nje yake (kiungo).
  • Kiungo cha kipindi cha kila mwombaji hubeba marejeleo yako ya mtumiaji; kiungo kilichoshirikiwa hakiwezi kukuambia ni nani aliyekifungua.
  • Jenga mtiririko kama mtiririko wa kazi uliochapishwa kwanza, kwa hivyo embed na link zifanye ukaguzi uleule.
  • Viungo vilivyohifadhiwa katika WebView vinaripoti matukio ya maendeleo, lakini usomaji wa chipu za NFC na uhai asilia vinahitaji SDK asilia.

Ingiza SDK Uthibitishaji unapotokea ndani ya bidhaa yako, mara tu mtumiaji wako anapofikia katika kikao chake mwenyewe. Tuma kiungo kilichohifadhiwa wakati uthibitishaji unapotokea nje yake: afisa wa mkopo akifuatilia hati, mfanyabiashara akiingizwa kwa barua pepe, mteja akiombwa kuthibitisha tena miezi kadhaa baada ya kujisajili. Hiyo ndiyo kanuni nzima ya uamuzi, na timu nyingi huishia kuhitaji zote mbili.

Kinachofanya chaguo kuwa nafuu ni kujenga mtiririko mara moja kama mtiririko wa kazi uliochapishwa . Kiambatisho huiweka kwa kitambulisho, kiungo huendesha picha ile ile iliyochapishwa, na ukaguzi, chapa na sheria za uamuzi zinafanana. Unachagua sehemu ya uwasilishaji, sio mtiririko wa pili wa uthibitishaji wa kudumisha.

Ni nini hasa kinachotofautiana kati ya hizo mbili

Njia zote mbili huishia mahali pamoja. Mwombaji hukamilisha hatua za kunasa, mfumo hushughulikia uthibitishaji bila kusawazisha, na sehemu yako ya nyuma hujifunza matokeo kutoka kwa wavuti (hufunguka kwenye kichupo kipya) au kura ya maoni ya hali. Tofauti ziko katika ni nani anayeanzisha mtiririko na kile ambacho msimbo wako unadhibiti.

Swali

SDK kupachika

Kiungo kilichopangishwa

Mwombaji anaanzia wapi?

Ndani ya programu yako ya wavuti au simu

A URL imefunguliwa kutoka kwa barua pepe, SMS , msimbo wa QR au Mwonekano wa Wavuti

Unasakinisha nini?

Mteja SDK na ufunguo unaoweza kuchapishwa

Hakuna chochote kwa mteja; ufunguo wa siri kwenye sehemu yako ya nyuma ili kuunganisha viungo kwa kila mwombaji

Mwombaji ni nani?

Mtumiaji wako aliyeingia, amepitishwa kamauserId

Imepewa jina naexternalUserIdkwenye kipindi cha kila mwombaji, au haijulikani kwenye kiungo kilichoshirikiwa

Unasikia nini kwa wakati halisi?

SDK kurudisha simu kama vileonSubmit,onStepChangenaonError

Matukio ya viungo yanayopangishwa wakati ukurasa unaendeshwa katika WebView au iframe; vinginevyo tu mtandao wako wa wavuti

Uwezo wa kifaa

Kamili, ikiwa ni pamoja na NFC usomaji wa chip na uchangamfu kwenye kifaa kwenye SDK asilia

Uwezo wa kivinjari pekee

Kubadilisha mtiririko

Chapisha upya mtiririko wa kazi

Chapisha upya mtiririko wa kazi

Safu ya mwisho ndiyo ambayo watu hukosea. Kwa mtiririko wa kazi, hakuna njia inayohitaji mabadiliko ya msimbo ili kubadilisha mtiririko. Bila moja, kupachika kunamaanisha kutamka nchi, aina za vitambulisho na mabadiliko ya hatua kama vielelezo, na kila mabadiliko huwa toleo.

Wakati SDK kupachika ni chaguo sahihi

Ingiza wakati uthibitishaji ni hatua katika safari unayodhibiti na mtumiaji tayari ameingia. Programu ya pochi inayomthibitisha mtumiaji kabla ya uhamisho wake wa kwanza, au soko linalowathibitisha wauzaji kabla ya orodha yao ya kwanza, zote zinafaa.

Unapata mambo matatu ambayo kiungo hakiwezi kukupa.

Kurudi nyuma kwa nambari yako mwenyewe.SDK simuonSubmitnaverificationIdwakati uthibitisho unapoundwa, ili uweze kumsogeza mtumiaji kwenye skrini inayosubiri bila kusubiri kwenye mtandao.onErrorinaripoti hitilafu za kiufundi (mtandao, ruhusa ya kamera, aina ya kitambulisho kilichozimwa) na kifaa cha kuhifadhi datacode.

Uwezo wa kifaa asilia. SDK za React Native na Flutter (hufunguka kwenye kichupo kipya) husoma chipu za pasipoti juu NFC na kuendesha uhuishaji kwenye kifaa. Vivinjari haviwezi kuzungumza na chipu ya pasipoti, kwa hivyo wavuti SDK inaonyesha skrini ya chipu kwenye hakikisho la kiundaji cha dashibodi pekee.

Utambulisho wako tayari unao. UnapitauserIdnauserDatakutoka kwa kipindi chako, kwa hivyo uthibitishaji umeunganishwa na akaunti inayojulikana na jina ulilo nalo linalinganishwa na hati.

Upachikaji mdogo wa wavuti, uliochukuliwa kutoka SDK nyaraka:

<MyazaKYC
  apiKey="pk_live_…"
  workflowId="wf_AbC123dEf456"
  userId="user_42"
  metadata={{ requestId: "order_1001" }}
  onSubmit={(s) => console.log(s.verificationId)}
/>

Gharama ni halisi lakini ni ndogo. Unaongeza utegemezi, unauweka katika au juu ya matoleo ya chini kabisa yanayoelewekaworkflowId(wavuti 2.2.0, React Native 2.1.0, Flutter 2.2.0 au baadaye), na kwenye React Native unahitaji muundo maalum wa uundaji kwa sababu SDK hutuma msimbo asilia.

Wakati kiungo kilichopangishwa ni chaguo sahihi

Tuma kiungo wakati mtu unayehitaji kumthibitisha hayupo kwenye programu yako wakati unapomhitaji. Maumbo machache ya kawaida:

  • Mkopeshaji wa biashara anayekusanya KYC kutoka kwa mkurugenzi ambaye hajawahi kuingia kwenye chochote.

  • Timu ya uendeshaji ikimthibitisha tena mteja ambaye hati yake imeisha muda wake.

  • Jukwaa lisilo na programu ya simu, linalothibitisha watumiaji wanaofika kwa barua pepe.

  • Kituo cha washirika ambapo huwezi kutuma msimbo kabisa.

Kuna aina mbili za viungo, na kuchagua kati yao ni muhimu zaidi kuliko kuchagua kiungo dhidi ya kupachika.

Viungo vya kipindi cha kila mwombaji

Ukijua ni nani anayepaswa kuthibitisha, tengeneza kipindi kutoka sehemu ya nyuma yako ukitumiaPOST /api/kyc/sessions (hufunguka kwenye kichupo kipya)na ufunguo wa siri:

curl "https://api.toden.co/api/kyc/sessions" \
  -H "Authorization: Bearer $MYAZA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflowId": "wf_AbC123dEf456",
    "externalUserId": "user_42",
    "userData": { "firstName": "John", "lastName": "Doe" }
  }'

Jibu linaurlambayo ni ya mwombaji huyo mmoja. Ni ya matumizi moja, inayoweza kufuatiliwa kwa yakoexternalUserId, na kutumika mara tu baada ya kuwasilishwa, kwa hivyo kuituma kwa mtu wa pili haifanyi kazi. Unaweza kupitishaemailili kiungo kitumwe kwa niaba yako, au kipeleke mwenyewe.

Wageni wa eneo-kazi kwenye ukurasa unaopangishwa hupewa msimbo wa QR wa "endelea kwenye simu yako" kwa hatua za kamera, kwa hivyo kiungo kinachotumwa kwa barua pepe kwa mtu aliye kwenye kompyuta ya mkononi bado hufikia kamera. (Wavuti SDK ina kifaa sawa cha kuhamisha data kwenye kompyuta ya mezani, kinachodhibitiwa nadeviceHandoffchaguo.)

Maelezo mawili yanayofaa kupangwa. Kiungo kinaacha kukubali mwanzo mpya katikaexpiresAt: Saa 24 kwa mtiririko wa mtu binafsi na siku 7 kwa mtiririko wa biashara, isipokuwa mtiririko wa kazi uweke muda wake wa kipindi. Na usanidi ambao mwombaji hutembea ni picha iliyochapishwa iliyogandishwa ulipounda kiungo, kwa hivyo kuchapisha tena hakubadilishi kiungo ambacho tayari kiko kwenye kikasha cha mtu.

Viungo vilivyoshirikiwa vilivyopangishwa

Kila mtiririko wa kazi uliochapishwa unaweza pia kuwashwa kama moja ya umma URL kwamba watu wengi hufungua, kila ziara ikianza uthibitishaji wake. Inafaa kampeni au msimbo wa QR kwenye kaunta, ambapo hujui ni nani atakayefika. Makubaliano ni sifa: kiungo hakirejelei mtumiaji katika mfumo wako, kwa hivyo lazima upatanishe matokeo kwa njia nyingine. Kurejesha kiungo kutoka kwa ukurasa wa mtiririko wa kazi huua kile cha zamani. URL mara moja, ambayo ni njia yako ikiwa itasambaa zaidi ya ilivyokusudiwa. Ukimjua mtu huyo, tumia kipindi.

Njia ya kati: kiungo kilichopangishwa ndani ya programu yako

Baadhi ya timu zinahitaji ukurasa unaosimamiwa nasi lakini ufunguliwe ndani ya programu yao ya simu, kwa kawaida ili kuepuka utegemezi wa asili. Hilo linafaa. Fungua kipindi.urlkatikareact-native-webview,webview_flutterau iframe, na ukurasa unaripoti maendeleo yake kwa mwenyeji kama matukio ya kiungo kilichopangishwa (hufunguka kwenye kichupo kipya) :ready,started,step,submitted,completed,errornaclosed.

<WebView
  source={{ uri: session.url }}
  onMessage={(event) => {
    const message = JSON.parse(event.nativeEvent.data);
    if (message.source !== 'myaza-kyc') return;
    if (message.type === 'submitted') {
      navigation.replace('VerificationPending', { id: message.verificationId });
    }
  }}
/>

Jua mipaka kabla ya kuichagua. NFC Usomaji wa chip, ukaguzi wa uwepo wa mandharinyuma na uhai asilia haupatikani ndani ya WebView. Matukio hayo yana vitambulisho, majina ya hatua na misimbo ya hitilafu, hakuna chochote ambacho mwombaji alikiandika au kukirekodi, na ni kwa hisani ya kiolesura chako, si rekodi. Uamuzi bado unatoka kwa mtandao wako au kura ya maoni ya hali.

Katika iframe, ongeza asili ya ukurasa wako kamaoriginKigezo cha hoja. Ukurasa huchapisha matukio tu wakati kivinjari kinathibitisha kuwa ukurasa wako ndio kipachikaji, na huchapisha chochote kingine.

Uamuzi uliofanyiwa kazi

Fikiria mkopeshaji wa kimawazo wa watumiaji mwenye programu ya simu na timu ya mauzo ya nje. Wateja wapya huthibitisha ndani ya programu kabla ya mkopo wao wa kwanza, kwa hivyo programu hupachika React Native SDK pamoja na mtiririko wa kazi uliochapishwa unaojumuisha usomaji wa chipu ya pasipoti. Mawakala wa shambani wafanyabiashara katika masoko ambao hawajasakinisha programu bado, kwa hivyo sehemu ya nyuma huweka kipindi kwa kila mfanyabiashara na kitambulisho cha kiongozi cha mfanyabiashara kamaexternalUserId, na wakala hutuma kiungo kupitia SMS Wateja ambao kitambulisho chao kitaisha muda wake baadaye hupata kiungo kipya cha kipindi kutoka kwa shughuli.

Mtiririko mmoja wa kazi unaweza kuhudumia zote tatu, au mkopeshaji anaweza kuweka mtiririko mwepesi wa kazi kwa viungo vya sehemu. Vyovyote vile, kila matokeo yanatua kwenye kidhibiti kimoja cha wavuti, kikiwa kimeunganishwa naverificationIdna kubeba ya mkopeshaji mwenyeweexternalUserId.

Kanuni ya uamuzi

  1. Jenga mtiririko kama mtiririko wa kazi uliochapishwa kabla ya kuchagua uso.

  2. Ikiwa mtumiaji ameingia kwenye bidhaa yako wakati wa uthibitishaji, pachika SDK Tumia asili SDK ikiwa unahitaji NFC usomaji wa chipsi.

  3. Ikiwa uthibitishaji utatokea nje ya bidhaa yako na unamjua mtu huyo, tengeneza kipindi cha kila mwombaji kutoka sehemu yako ya nyuma.

  4. Tumia kiungo kilichoshirikiwa pekee wakati huwezi kujua ni nani atakayekifungua, na upange jinsi utakavyoainisha matokeo.

  5. Ikiwa unataka ukurasa uliopangishwa ndani ya programu yako, fungua kipindi URL katika WebView na usikilize matukio ya viungo vilivyoandaliwa, ukikubali kupotea kwa usomaji wa chip na uhai asilia.

  6. Chochote utakachochagua, chukulia mtandao kama chanzo cha ukweli na ishara ya upande wa mteja kama kidokezo.

Vyanzo

Charles Archibong

Kuhusu mwandishi

Charles Archibong

Mwanzilishi mwenza

Charles Archibong ndiye mwanzilishi mwenza wa Toden. Anaandika kuhusu uthibitishaji wa utambulisho, teknolojia ya kifedha, na kazi ya vitendo ya kujenga huduma za kidijitali zinazoaminika.

Jenga bidhaa yako.Tutashughulikia yaliyobaki.

Utambulisho na uzingatiaji tangu mwanzo hadi mwisho, kwa viwango vya kimataifa na bei zinazowafaa waanzilishi.