IDENTITEITSVERIFIKASIE
Gehuisveste identiteitsverifikasie, met die besluit in jou hande
Stuur kliënte na ’n gehuisveste verifikasievloei. Lees die saakstatus in jou eie backend en verwys uitsonderings vir menslike hersiening.
’n Beheerde werkvloei, nie ’n outomatiese uitspraak nie
Identiteitsverifikasie lewer ’n saakstatus en ’n pad vir hersiening. Dit ondersteun jou besluit, maar neem dit nie.
Sessieverloop
Sessie geskep
’n Eenmalige skakel en ’n vervaltyd.
Skakel oopgemaak
Die kliënt lees ’n privaatheidskennisgewing. Die tyd om die proses te voltooi is beperk.
Saakstatus
Statusnavraag of gebeurtenis
Voltooi, ongeverifieer of hersiening benodig. Behandel elke status as inset vir jou eie besluit.
Terugvalopsies om voor te beplan
Verval
Stuur geen gebeurtenis nie. Lees die status om dit te sien.
Gekanselleer
Lees die status vanaf jou backend.
Eindig met ’n fout
Sessies kan op ’n fout eindig. Beplan ’n terugvalopsie.
Gehuisveste verifikasieskakel
Saakstatus vir jou besluit
Pad vir menslike hersiening
Gebeurteniskennisgewings
Van sessie tot saakstatus
Bediener
Skep ’n sessie
Gebruik jou eie verwysing vir die betrokke persoon. Jy ontvang ’n eenmalige skakel en ’n vervaltyd.
Noxtica
Kliënt voltooi die proses op die gehuisveste bladsy
Eenmalige skakel
Die kliënt lees ’n privaatheidskennisgewing en verskaf dan die gevraagde bewyse binne ’n tydsbeperkte venster.
Bediener
Statusnavraag of gebeurtenis
Saakstatus
Lees die status vanaf jou backend, of ontvang ’n gebeurtenis by jou eindpunt.
Konsole
Menslike hersiening
Uitsonderings
Sake wat verdere aandag verg, gaan vir operateurhersiening. Hersieningsaktiwiteit word in ’n ouditspoor aangeteken.
Jou span
Jou besluit
Jou span neem die besluit.
Skep ’n sessie
Die kliënt voltooi die proses op die gehuisveste bladsy
Lees die status en besluit
Wat dit is en vir wie dit bedoel is
Noxtica-identiteitsverifikasie (KYC) is ’n gehoste proses. Jou bediener skep ’n sessie, jou kliënt voltooi die stappe op ’n bladsy wat deur Noxtica in hul eie blaaier gehost word, en jou bediener lees die uitslag deur ’n statusnavraag of ’n ondertekende gebeurtenis. Jou bediener ontvang nooit die kliënt se antwoorde of vaslegging direk nie.
Resultate is outomatiese seine. Jy besluit wat elke uitslag vir jou kliënt beteken. Noxtica verskaf die bewyse en ’n ouditspoor.
Vir wie dit bedoel is
- Agtergrondingenieurs wat sessies skep en uitslae lees.
- Bedryfs- en voldoeningspanne wat die gehoste bladsy opstel en die hersieningsry in Backoffice hanteer.
- Spanne wie se beleid identiteitsbewyse vereis en wat ’n persoon het wat vir die hersiening verantwoordelik is.
Besigheids- en handelaarverifikasie
Dieselfde gehoste benadering dek besighede en handelaars. KYB (ken jou besigheid) is gehoste besigheidsinskakeling: die besigheidsverteenwoordiger voer besigheidsinligting in, laai dokumente op, verklaar eienaars, hersien en dien in. Die ingediende saak gaan na menslike hersiening in Backoffice, waar operateurs die eienaarskapgrafiek, dokumente en sifting kan sien. KYM (ken jou handelaar) is gehoste handelaarsinskakeling plus transaksienasporing wat slegs kennisgewings stuur: ’n waarskuwing stel ’n persoon in kennis om dit te hersien en begin nooit ’n betalingshandeling nie. Geen outomatiese besigheidsregisterkontrole word beskryf nie. Resultate is seine en jou operateurs neem die besluit. Beskikbaar. Op versoek vir jou rekening geaktiveer.
Beskikbaarheid
Beheerde beskikbaarheid. Jou rekeningspan voorsien identiteitsverifikasie per huurder; jy kan dit nie self aanskakel nie. Stappe wat as opsioneel beskryf word, geld slegs wanneer dit vir jou organisasie geaktiveer is.
Die volledige gehuisveste proses
Dit wys wat gebeur van die eerste API-oproep tot die uitslag. Stappe gemerk as opsioneel geld slegs wanneer dit vir jou organisasie geaktiveer is.
Jou bediener skep ’n sessie
’n Bedieneroproep skep ’n sessie met jou eie ondeursigtige kliëntverwysing. Die antwoord bevat ’n sessie-ID en ’n eenmalige skakel.
Die kliënt ontvang die skakel
Stuur die kliënt na die skakel deur ’n herleiding, ’n nuwe oortjie, ’n e-pos of boodskap, of ’n QR-kode. Die gehuisveste bladsy bied ook ’n QR-kode en ’n opsie om die skakel te kopieer, sodat ’n kliënt wat op ’n rekenaar begin op ’n foon kan voortgaan.
Privaatheidskennisgewing en toestemming
Voordat enigiets vasgelê word, sien die kliënt jou besigheidsnaam, die doel van die verifikasie en ’n skakel na jou privaatheidskennisgewing, en stem in om voort te gaan.
Kies ’n dokument en neem die voor- en agterkant af
Die kliënt kies een van die dokumenttipes wat jy aanvaar en neem dan die voorkant af. Die agterkant is nodig vir identiteitskaarte, bestuurslisensies en verblyfpermitte. ’n Paspoort het nie ’n agterkantstap nie.
Selfie
Die kliënt neem ’n selfie. Dit word met die portret op die dokument vergelyk en op gehalte nagegaan.
Lewendigheid
Die kliënt voltooi ’n kort lewendigheidsuitdaging voor die kamera: kopdraaie en ’n oogknip.
Hersiening
’n Voltooide vaslegging wag in die hersieningsry in jou Backoffice totdat iemand in jou organisasie ’n besluit aanteken. Die sessie se status is review pending en dit verval nie terwyl dit wag nie.
Uitslag: statuslesing en ondertekende gebeurtenisse
Jou bediener lees die sessiestatus en kan op ondertekende webhook-gebeurtenisse inteken. Lees die status voordat jy op ’n gebeurtenis optree: die status is die gesaghebbende bron.
Skakel se geldigheidstydperk
’n Skakel wat nie oopgemaak is nie, bly geldig tot sy eie vervaltyd, by verstek een dag. Nadat die kliënt die skakel die eerste keer oopgemaak het, het die kliënt 30 minute om klaar te maak, of tot die oorspronklike vervaltyd as dit vroeër aanbreek.
Wat die gehuisveste bladsy nie doen nie
- Dit kan nie in ’n iframe ingesluit word nie. Maak dit as ’n volledige bladsy of in ’n nuwe oortjie oop.
- Dit volg die taal van die kliënt se blaaier. Jy kan dit nie instel nie.
- Sommige inprogram-blaaiers kan dit nie laat loop nie. Die bladsy verduidelik aan die kliënt hoe om in ’n gewone blaaier voort te gaan.
Ondersteunde dokumente en wat gelees word
Jy kies in die instellings vir die gehuisveste bladsy in Backoffice watter dokumente jou kliënte mag gebruik en uit watter uitreikende lande. Die kliënt kies uit dié opsies. Die gehuisveste proses herken vier dokumenttipes:
| Dokumenttipe | Agterkant vasgelê |
|---|---|
| Nasionale identiteitskaart | Ja |
| Bestuurslisensie | Ja |
| Verblyfpermit | Ja |
| Paspoort | Nee |
Die gedrukte teks word uit die dokument gelees. Waar die dokument ’n masjienleesbare sone het, word dit gelees, die kontrolesyfers daarvan geverifieer en die uitslag met die gedrukte teks gekruiskontroleer. ’n Bestuurslisensie het nie ’n masjienleesbare sone nie, en die afwesigheid daarvan tel nie daarteen nie.
Turkse nasionale identiteitskaarte en bestuurslisensies word uitdruklik hanteer: die Turkse persoonlike nommer (T.C. Kimlik No) word gelees en is by verstek ’n vereiste veld vir dié twee dokumente. As ’n nommer se kontrolesyfers geldig is, is die dokumentnommer nie ook nodig nie.
’n Sone wat nie gevind of met die gedrukte teks vergelyk kan word nie, is ’n meetgaping. Dit word as hersiening aangedui, nooit as mislukking nie. Noxtica publiseer geen landelys buiten wat jy instel nie en maak geen aanspraak dat elke dokument in elke land ewe goed gelees word nie.
Kontroles en aanwysers
Die gehuisveste proses lewer kontrole-uitslae vir ’n beoordelaar. Dit is aanwysers wat by die hersiening help. Dit bepaal nie ’n uitslag nie en waarborg nie dat bedrog geblokkeer word nie.
| Kontrole | Waarna dit kyk |
|---|---|
| Dokumentegtheid | Uitleg, masjienleesbare-sone-struktuur, drukwerk-konsekwentheid, tekens van redigering of gekopieerde areas, teenwoordigheid van ’n hologram, tekens van ’n skermheropname en kaartgeometrie. Elke kontrole rapporteer sy eie uitslag. |
| Gesigpassing | Vergelyk die portret op die dokument met die selfie. ’n Lae telling is bewyse vir die beoordelaar. |
| Selfiegehalte | Skerpte, beligting en die grootte en houding van die gesig in die selfie. |
| Lewendigheid | ’n Uitdaging wat kopdraaie en ’n oogknip behels. Die gebaar-kontroles wys dat die gevraagde beweging plaasgevind het. Dit is nie ’n aanbiedingsaanvaltoets nie. |
| Aanbiedingsaanvalopsporing (PAD) | Ontleed rame van die lewendigheidsuitdaging en die selfie en lewer ’n telling. Die uitslag is raadgewend. |
Uitslae en hersiening
| Status | Betekenis |
|---|---|
pending | Geskep. Die kliënt het nog nie die skakel oopgemaak nie. |
opened | Die kliënt het die skakel oopgemaak en werk deur die stappe. |
verifying | Die kliënt het ingedien en verwerking is aan die gang. |
review_pending | Verwerking is klaar en ’n besluit is nodig in jou Backoffice-hersieningsry. Dit is nie ’n afkeuring of ’n goedkeuring nie. |
completed | ’n Besluit het die sessie goedgekeur. |
unverified | Verwerking is met ’n negatiewe uitslag afgehandel. |
error | Verwerking kon weens ’n fout of weiering nie afgehandel word nie. |
expired | Die skakel of die vasleggingsvenster het verstryk voordat ’n besluit geneem is. |
cancelled_by_user | Die kliënt het op die gehoste bladsy gekanselleer. Geld wanneer kansellering vir jou organisasie geaktiveer is. |
’n Bevoegde persoon in jou span behoort nadelige besluite te hersien voordat dit ’n kliënt raak. Resultate is waarskynlikheidsgebaseer en kan vals positiewe en vals negatiewe insluit. Dit is nie regsbewys van identiteit nie.
Vir ontwikkelaars
Alles hieronder is gewone HTTPS vanaf jou bediener. Die volledige verwysing is in die dokumentasie.
Drie maniere om ’n verifikasie te begin
- Gehuveste sessie vanaf jou bediener. Jou bediener skep die skakel via API en Noxtica huisves die bladsy.
- Uitnodiging vanuit Backoffice. ’n Persoon in jou organisasie skep die skakel in Backoffice, sonder kode.
- Direkte API vanaf jou bediener. Bediener-na-bediener-roetes sonder ’n gehuisveste skakel. Jou eie skerms kan vandag nie daarmee ’n dokument vir kontrole vaslê nie; gebruik dus ’n gehuisveste sessie wanneer die kliënt ’n dokument moet vaslê.
Skep ’n sessie
Magtig met ’n bedienersleutel wat die identiteitsregte het. Hou die sleutel op jou bediener. Stuur ’n Idempotency-Key sodat ’n herhaling nie ’n tweede sessie skep nie.
curl -sS https://collect.noxtica.com/v1/kyc/sessions \
-H "Authorization: Bearer $NOXTICA_SERVER_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"subjectRef":"cust_example","returnUrl":"https://merchant.example.com/verification/return"}'Die antwoord
Die skakel word een keer in hierdie antwoord teruggestuur. Behandel dit as ’n geheim en moenie dit aanteken nie. Die vervaltyd is in epogmillisekondes.
{
"ok": true,
"sessionId": "00000000-0000-4000-8000-000000000001",
"url": "https://verify.noxtica.com/s/EXAMPLE_TOKEN",
"expiresAt": 1790848845000,
"domainId": null,
"requestId": "req_example"
}Lees die status
’n Sessie wat jy geskep het, lewer altyd 200 terug, ook wanneer dit verval het. Vra met ’n toenemende wagtyd vir die status en hou op sodra dit finaal is.
GET https://collect.noxtica.com/v1/kyc/sessions/00000000-0000-4000-8000-000000000001
Authorization: Bearer $NOXTICA_SERVER_KEYWebhook-gebeurtenisse
Gebeurtenisse is ondertekende HTTPS-aflewerings na ’n eindpunt wat jy in Backoffice registreer. ’n Gebeurtenis is ’n kennisgewing, nie ’n besluit nie.
| Gebeurtenis | Word gestuur wanneer |
|---|---|
kyc.session.completed | ’n Gehuisveste sessie bereik completed, unverified of error. ’n Sessie wat op review pending staan, stuur die gebeurtenis later wanneer ’n beoordelaar ’n besluit neem. |
kyc.session.cancelled | Die kliënt kanselleer op die gehuisveste bladsy. Teken uitdruklik daarop in. Wanneer dit vir jou organisasie geaktiveer is. |
kyc.verification.completed | ’n Verifikasie bereik ’n finale status. |
kyc.erasure.completed | ’n Uitwissingsversoek word voltooi. Wanneer uitwissing vir jou organisasie geaktiveer is. |
kyc.document.expiry_warning | ’n Geverifieerde dokument se vervaldatum is naby of het reeds verstryk. Wanneer dit vir jou organisasie geaktiveer is. |
kyc.reverification.due | ’n Geskeduleerde herverifikasie word vereis. Wanneer dit vir jou organisasie geaktiveer is. |
Voorbeeldgebeurtenis
Slegs sintetiese waardes. Gebeurtenisse bevat nooit jou kliëntverwysing nie: pas ’n gebeurtenis met jou kliënt deur die sessie-ID te gebruik.
{
"id": "00000000-0000-4000-8000-000000000001:endpoint_example",
"type": "kyc.session.completed",
"created_at": 1790762445000,
"tenant_id": "tenant_example",
"data": {
"schemaVersion": "1",
"sessionId": "00000000-0000-4000-8000-000000000001",
"status": "completed",
"verificationId": "verification_example",
"reasonCodes": ["provider_manual_review"],
"occurredAt": 1790762445000,
"deliveryId": "00000000-0000-4000-8000-000000000001:endpoint_example"
}
}Verifieer elke aflewering
- Elke aflewering bevat die opskrifte X-Noxtica-Signature, X-Noxtica-Timestamp, X-Noxtica-Event en X-Noxtica-Delivery.
- Die handtekening is ’n HMAC-SHA256 oor die tydstempel, ’n punt en die rou versoekliggaam. Verifieer dit voordat jy die liggaam ontleed, en dwing jou eie tydstempeltoleransie af.
- Aflewering vind minstens een keer plaas en die volgorde is nie vas nie. Verwyder duplikate op grond van X-Noxtica-Delivery, en lees dan die sessiestatus voordat jy optree.
Geen SDK word vereis nie. Die dokumentasie wys voorbeelde in curl, Node.js en Python.
Lees meer in die dokumentasie
Databeskerming
Hierdie afdeling beskryf wat die dokumentasie sê. Dit is nie regsadvies nie; die Privaatheidsbeleid en die Sekuriteit-bladsy beskryf hoe Noxtica persoonlike data hanteer.
Bewaring
Noxtica verwyder nie verifikasiebesonderhede of bewyse outomaties nie en stel geen bewaringstydperk daarvoor vas nie. Dit bly in jou huurder totdat ’n huurderadministrateur dit verwyder.
Verwydering
’n Huurderadministrateur verwyder verifikasies in Backoffice met ’n rede, ’n getikte bevestiging en ’n nuwe stap-op-verifikasie. ’n Verwydering skrap die verifikasie, sy bewyslêers en rekords, maar behou faktureringsgebruikrekords, regsgrondslagbewyse en die ouditspoor. Dit kan nie ongedaan gemaak word nie.
Regte van datasubjekte
Versoeke om data uit te wis, word op die KYC-uitwissingsbladsy hanteer. ’n Tweede administrateur keur ’n versoek goed, ’n wetlike bewaringsbevel kan dit onderbreek, en elke gestoorde item het ’n verwyderingsbewys. Vra jou rekeningspan wat ’n goedgekeurde versoek vir jou huurder dek voordat jy ’n tydlyn aan ’n kliënt belowe.
Toegang tot bewyse
Toegang tot die oorspronklike vasleggings vereis ’n afsonderlike, hoër toestemmingsvlak as saakhersiening. Dit is beperk tot administrateurs, vereis ’n nuwe stap-op-verifikasie, en elke aansig word geouditeer. Ander rolle sien bevindings en metings, nie die oorspronklikes nie.
Enkripsie en isolasie
Rou identiteitsbewyse word geënkripteer terwyl dit gestoor word, en slegs wanneer rou-bewysberging vir jou huurder geaktiveer is. ’n Sessie wat aan ’n ander organisasie behoort, word as nie gevind nie aangedui.
Datasetelskap
Bewysberging het ’n per-huurder-instelling vir datasetelskap: TR, EU of US. Vra jou rekeningspan wat dit vir jou huurder dek. Hierdie bladsy maak geen aanspraak dat data in ’n bepaalde land bly nie.
Toestemming en regsgrondslag
Die gehuisveste bladsy wys die kliënt jou doel en privaatheidskennisgewing voordat enigiets vasgelê word. ’n Gemagtigde persoon in jou organisasie teken die regsgrondslag aan, en Noxtica kies dit nie namens jou nie. Jy is verantwoordelik vir die kennisgewings, toestemmings en regsgrondslag in elke jurisdiksie waar jy diens lewer.
Algemene vrae
Kan ek identiteitsverifikasie self aanskakel?
Nee. Dit word per huurder onder beheerde beskikbaarheid voorsien. Kontak die span om jou gebruiksgeval en jurisdiksie te bespreek.
Keur dit kliënte outomaties goed?
Nee. Geen kontrole-uitslag merk ’n gehuisveste verifikasie vanself as geverifieer nie. Elke gehuisveste verifikasie wag totdat ’n persoon ’n besluit aanteken, en slegs completed is ’n goedkeuring.
Blokkeer aanbiedingsaanvalopsporing bedrog?
Nee. PAD is raadgewend. Noxtica rapporteer die uitslag en laat dit nooit ’n besluit bepaal nie. Behandel dit, soos elke kontrole, as ’n aanduiding vir ’n beoordelaar.
Is ’n uitslag regsbevestiging van identiteit?
Nee. Geen uitslag is regsbevestiging van identiteit buite die omvang van die ingestelde verskaffer en kontrak nie. Noxtica is nie ’n verbruikersverslagdoeningsagentskap nie, en die uitset mag nie vir krediet-, versekerings-, indiensnemings- of behuisingsgeskiktheid gebruik word nie.
Hoe lank is ’n verifikasieskakel geldig?
By verstek een dag; jy kan dit instel wanneer jy die sessie skep. Nadat die kliënt dit oopgemaak het, het die kliënt 30 minute om klaar te maak.
Kan ek die gehuisveste bladsy insluit of die taal daarvan instel?
Nee. Die bladsy weier om in ’n iframe te laai, en die taal daarvan volg die kliënt se blaaier.
Watter gebeurtenisse kan ek ontvang?
Ses identiteitsgebeurtenisse: kyc.session.completed, kyc.session.cancelled, kyc.verification.completed, kyc.erasure.completed, kyc.document.expiry_warning en kyc.reverification.due. Sommige hang af van jou organisasie se instellings.
Hoe lank hou julle die bewyse?
Noxtica stel geen bewaringstydperk vas nie en verwyder nie verifikasiebesonderhede of bewyse outomaties nie. ’n Huurderadministrateur verwyder dit.
Is besigheids- en handelaarsverifikasie beskikbaar?
Ja. Besigheidsverifikasie (KYB) en handelaarsverifikasie (KYM) is beskikbaar. Jou bediener skep ’n skakel, die besigheid of handelaar voltooi registrasie op ’n Noxtica-gehoste bladsy, en jou operateurs hersien die saak in Backoffice. Word op versoek vir jou rekening geaktiveer.
Verwante bladsye
Wat identiteitsverifikasie nie doen nie
- Beheerde beskikbaarheid. Identiteitsverifikasie word per tenant ingerig.
- Nie wettige identiteitsbewys nie. Geen resultaat is wettige identiteitsbewys buite die omvang van die opgestelde verskaffer en kontrak nie. Resultate is waarskynlikheidsgebaseer en kan vals positiewe en vals negatiewe insluit.
- Jy besluit. ’n Gekwalifiseerde persoon in jou span behoort nadelige besluite te hersien. Noxtica is nie ’n verbruikersverslagdoeningsagentskap nie. Moenie die uitset vir krediet-, versekerings-, indiensnemings- of behuisingsgeskiktheid gebruik nie.
- Jou verantwoordelikhede. Jy is verantwoordelik vir kennisgewings, toestemmings en die regsgrondslag vir die insameling van identiteitsbewyse van jou kliënte in elke jurisdiksie waar jy dienste lewer.
Tellings, redes en uitsprake is waarskynlikheidsgebaseerde skattings, nie feite nie. Jou span neem elke besluit.Lees die vrywaring