IDENTITY VERIFICATION
Naka-host na beripikasyon ng pagkakakilanlan, ikaw pa rin ang nagpapasya
Ipadala ang mga customer sa naka-host na daloy ng beripikasyon. Basahin ang katayuan ng kaso sa sarili mong backend at idaan sa pagsusuri ng tao ang mga eksepsiyon.
Pinamamahalaang daloy, hindi awtomatikong hatol
Nagbabalik ang identity verification ng katayuan ng kaso at opsiyon para sa pagsusuri. Tinutulungan ka nitong magpasya; hindi ito ang nagpapasya para sa iyo.
Daloy ng session
Nagawa na ang session
Link na minsan lang magagamit at petsa ng pag-expire.
Binuksan ang link
Babasahin ng customer ang abiso sa privacy. May takdang panahon para tapusin ito.
Katayuan ng kaso
Pagbasa ng katayuan o event
Tapos na, hindi beripikado o nangangailangan ng pagsusuri. Gamitin ang bawat katayuan bilang input sa sarili mong pasya.
Mga fallback na dapat pagplanuhan
Nag-expire
Walang inilalabas na event. Basahin ang katayuan para makita ito.
Kinansela
Basahin ang katayuan mula sa backend mo.
Nagtapos sa error
Maaaring magtapos sa error ang mga session. Magplano ng fallback.
Naka-host na link para sa beripikasyon
Katayuan ng kaso para sa pasya mo
Opsiyon para sa pagsusuri ng tao
Mga abiso ng event
Mula session hanggang katayuan ng kaso
Server
Gumawa ng session
Gagamitin ang sarili mong sanggunian para sa subject. Makakatanggap ka ng link na minsan lang magagamit at petsa ng pag-expire.
Noxtica
Gagamit ang customer ng naka-host na page
Link na minsan lang magagamit
Babasahin ng customer ang abiso sa privacy, saka ibibigay ang hinihinging ebidensiya sa loob ng takdang panahon.
Server
Pagbasa ng katayuan o event
Katayuan ng kaso
Basahin ang katayuan mula sa backend mo, o tumanggap ng event sa endpoint mo.
Console
Pagsusuri ng tao
Mga eksepsiyon
Idinadaan sa pagsusuri ng operator ang mga kasong kailangang tingnan muli. Itinatala sa audit trail ang aktibidad ng pagsusuri.
Team mo
Pasya mo
Ang team mo ang nagpapasya.
Gumawa ng session
Gagamitin ng customer ang naka-host na page
Basahin ang katayuan at magpasya
Ano ito at para kanino
Ang identity verification (KYC) ng Noxtica ay hosted na proseso. Gumagawa ang server mo ng session, kinukumpleto ng customer mo ang mga hakbang sa page na hosted ng Noxtica gamit ang sarili nilang browser, at kinukuha ng server mo ang resulta sa pamamagitan ng pagbasa sa status o isang pirmadong event. Hindi kailanman natatanggap ng server mo nang direkta ang mga sagot o kuha ng customer.
Mga awtomatikong signal ang mga resulta. Ikaw ang nagpapasya kung ano ang kahulugan ng bawat resulta para sa customer mo. Ibinibigay sa iyo ng Noxtica ang ebidensya at audit trail.
Para kanino ito
- Mga backend engineer na gumagawa ng mga session at kumukuha ng mga resulta.
- Mga operations at compliance team na nagse-set up ng hosted page at humahawak sa review queue sa Backoffice.
- Mga team na nangangailangan ng ebidensya ng pagkakakilanlan ayon sa kanilang patakaran at may taong responsable sa pagsusuri.
Pag-verify ng negosyo at merchant
Saklaw ng parehong hosted na paraan ang mga negosyo at merchant. Ang KYB (know your business) ay hosted onboarding para sa negosyo: inilalagay ng kinatawan ng negosyo ang impormasyon nito, nag-a-upload ng mga dokumento, nagdedeklara ng mga may-ari, nagsusuri at nagsusumite; ipinapadala ang isinumiteng kaso para sa pagsusuri ng tao sa Backoffice, kung saan nakikita ng mga operator ang grap ng pagmamay-ari, mga dokumento at screening. Ang KYM (know your merchant) ay hosted onboarding para sa merchant kasama ang transaction monitoring na nag-aabiso lang: abiso para sa taong magsuri ang alert at hindi ito nagsisimula ng aksyon sa pagbabayad. Walang inilalarawang awtomatikong pagsusuri sa rehistro ng negosyo. Mga signal ang mga resulta at ang mga operator mo ang nagpapasya. Available. Pinapagana para sa account mo kapag hiniling.
Availability
Kontrolado ang availability. Ibinibigay ang identity verification sa bawat tenant sa pamamagitan ng account team mo, at hindi mo ito mae-enable nang mag-isa. Nalalapat lang ang mga hakbang na inilalarawang opsyonal kapag naka-enable ang mga ito para sa organisasyon mo.
Ang hosted flow mula simula hanggang wakas
Ito ang mga nangyayari mula sa unang API call hanggang sa resulta. Para lang sa organisasyon mo ang mga hakbang na may markang optional kapag naka-enable ang mga ito.
Gumagawa ng session ang server mo
Gumagawa ang server call ng session gamit ang sarili mong opaque na reference ng customer. Kasama sa tugon ang session id at link na minsan lang magagamit.
Natanggap ng customer ang link
Ipadala sa customer ang link sa pamamagitan ng redirect, bagong tab, email o mensahe, o QR code. Nag-aalok din ang hosted page ng QR code at opsiyong kopyahin ang link, kaya maaaring magpatuloy sa telepono ang customer na nagsimula sa computer.
Abiso sa privacy at pahintulot
Bago kumuha ng anumang datos, makikita ng customer ang pangalan ng negosyo mo, layunin ng beripikasyon at link sa abiso mo sa privacy, at sasang-ayon siyang magpatuloy.
Pumili ng dokumento at kunan ang harap at likod
Pumipili ang customer ng isa sa mga uri ng dokumentong tinatanggap mo, saka kinukunan ang harap nito. Kailangan ang likod para sa mga kard ng pagkakakilanlan, lisensiya sa pagmamaneho at permit sa paninirahan. Walang hakbang para sa likod ang pasaporte.
Selfie
Kumukuha ng selfie ang customer. Inihahambing ito sa larawan sa dokumento at sinusuri ang kalidad nito.
Liveness
Tinatapos ng customer sa camera ang maikling liveness challenge: paglingon ng ulo at pagkurap.
Pagsusuri
Naghihintay sa review queue sa Backoffice mo ang kumpletong kuha hanggang magtala ng pasya ang isang tao sa organisasyon mo. Review pending ang status ng session at hindi ito nag-e-expire habang naghihintay.
Resulta: binasang status at mga pirmadong event
Binabasa ng server mo ang status ng session at maaari itong mag-subscribe sa mga pirmadong webhook event. Basahin ang status bago kumilos batay sa event: ang status ang awtoritatibong sanggunian.
Tagal ng bisa ng link
Mananatiling valid ang link na hindi pa nabubuksan hanggang sa sarili nitong oras ng pag-expire, na isang araw bilang default. Mula sa unang pagbukas ng customer sa link, may 30 minuto siya para tapusin, o hanggang sa orihinal na oras ng pag-expire kung mas maaga iyon.
Mga hindi ginagawa ng hosted page
- Hindi ito maaaring i-embed sa iframe. Buksan ito bilang buong page o sa bagong tab.
- Sinusunod nito ang wika ng browser ng customer. Hindi mo ito maitatakda.
- May ilang in-app browser na hindi ito mapagana. Sasabihin ng page sa customer kung paano magpatuloy sa regular na browser.
Mga sinusuportahang dokumento at binabasang impormasyon
Ikaw ang pipili kung aling mga dokumento ang maaaring gamitin ng mga customer mo at kung aling mga bansang nag-isyu ng mga ito, sa mga setting ng hosted page sa Backoffice. Pumipili ang customer mula sa mga iyon. Kinikilala ng hosted flow ang apat na uri ng dokumento:
| Uri ng dokumento | Kunan ng larawan ang likod |
|---|---|
| Pambansang kard ng pagkakakilanlan | Oo |
| Lisensiya sa pagmamaneho | Oo |
| Permit sa paninirahan | Oo |
| Pasaporte | Hindi |
Binabasa ang tekstong nakalimbag mula sa dokumento. Binabasa ang machine-readable zone kung mayroon nito ang dokumento, bineberipika ang mga check digit nito, at inihahambing ang resulta sa tekstong nakalimbag. Walang machine-readable zone ang lisensiya sa pagmamaneho, at hindi ibinabawas ang kawalan nito sa pagsusuri.
Espesyal na pinangangasiwaan ang mga pambansang kard ng pagkakakilanlan at lisensiya sa pagmamaneho ng Türkiye: binabasa ang personal number ng Türkiye (T.C. Kimlik No), at bilang default, kinakailangang field ito para sa dalawang dokumentong iyon. Kapag pumasa sa check digit nito ang numero, hindi na kailangan ang document number.
Ang sonang hindi mahanap o maihambing sa tekstong nakalimbag ay puwang sa pagsukat. Review ang resulta nito, hindi fail. Walang inilalathalang listahan ng mga bansa ang Noxtica lampas sa mga kino-configure mo, at hindi nito sinasabing pare-pareho ang resulta para sa lahat ng dokumento mula sa bawat bansa.
Mga pagsusuri at signal
Naglalabas ang hosted flow ng mga resulta ng pagsusuri para sa isang tagasuri. Mga signal ang mga ito na ginagamit sa pagsusuri. Hindi sila nagpapasya sa kalalabasan at hindi garantisadong nakapipigil ng pandaraya.
| Pagsusuri | Sinusuri nito |
|---|---|
| Pagiging tunay ng dokumento | Ayos ng layout, istruktura ng machine-readable zone, pagkakapare-pareho ng pagkakaprint, mga palatandaan ng pag-edit o pagkopya ng mga bahagi, pagkakaroon ng hologram, mga palatandaan ng muling pagkuha mula sa screen, at hugis ng card. Iniuulat ng bawat pagsusuri ang sarili nitong resulta. |
| Pagtutugma ng mukha | Inihahambing ang larawan sa dokumento sa selfie. Ang mababang score ay ebidensiya para sa tagasuri. |
| Kalidad ng selfie | Talas, exposure, laki at posisyon ng mukha sa selfie. |
| Liveness | Hamong binubuo ng paglingon ng ulo at pagkurap. Ipinapakita ng mga gesture check na naganap ang hinihinging galaw. Hindi ito pagsusuri para sa presentation attack. |
| Pagtukoy sa pagtatangkang dayain ang presentasyon (PAD) | Sinusuri ang mga frame mula sa liveness challenge at ang selfie, at gumagawa ng score. Payo lamang ang resulta. |
Mga resulta at pagsusuri
| Status | Kahulugan |
|---|---|
pending | Nagawa na. Hindi pa binubuksan ng customer ang link. |
opened | Binuksan na ng customer ang link at ginagawa ang mga hakbang. |
verifying | Nagpadala na ang customer at isinasagawa na ang pagproseso. |
review_pending | Tapos na ang pagproseso at kailangan ng desisyon sa review queue ng Backoffice mo. Hindi ito pagtanggi o pag-apruba. |
completed | Inaprubahan ng isang desisyon ang session. |
unverified | Natapos ang pagproseso na may negatibong resulta. |
error | Hindi natapos ang pagproseso dahil sa aberya o pagtanggi. |
expired | Nag-expire ang link o panahon ng pagkuha bago magkaroon ng desisyon. |
cancelled_by_user | Kinansela ng customer sa hosted page. Nalalapat ito kapag naka-enable ang pagkansela para sa organisasyon mo. |
Dapat suriin ng kwalipikadong miyembro ng team mo ang mga negatibong desisyon bago makaapekto ang mga ito sa customer. Probabilistiko ang mga resulta at maaaring magkaroon ng mga maling positibo at maling negatibo. Hindi legal na patunay ng pagkakakilanlan ang mga ito.
Para sa mga developer
Plain HTTPS mula sa server mo ang lahat ng nasa ibaba. Nasa dokumentasyon ang buong sanggunian.
Tatlong paraan para simulan ang beripikasyon
- Hosted session mula sa server mo. Ginagawa ng server mo ang link sa pamamagitan ng API at ang Noxtica ang nagho-host ng page.
- Imbitasyon mula sa Backoffice. Gumagawa ng link ang isang tao sa organisasyon mo sa Backoffice, nang walang code.
- Direktang API mula sa server mo. Mga server-to-server route na walang hosted link. Hindi nito nabibigyan ng paraan ang sarili mong screen para kumuha ng dokumentong susuriin sa ngayon, kaya gumamit ng hosted session kapag kailangang kumuha ng dokumento ang customer.
Gumawa ng session
Mag-authenticate gamit ang server key na may pahintulot para sa identity. Panatilihin ang key sa server mo. Magpadala ng Idempotency-Key para hindi makagawa ng ikalawang session ang muling pagsubok.
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"}'Ang tugon
Isang beses lang ibinabalik ang link sa tugon na ito. Ituring itong lihim at huwag i-log. Nasa epoch milliseconds ang oras ng pag-expire.
{
"ok": true,
"sessionId": "00000000-0000-4000-8000-000000000001",
"url": "https://verify.noxtica.com/s/EXAMPLE_TOKEN",
"expiresAt": 1790848845000,
"domainId": null,
"requestId": "req_example"
}Basahin ang status
Palaging nagbabalik ng 200 ang session na ginawa mo, kahit nag-expire na ito. Mag-poll nang unti-unting humahaba ang pagitan at huminto kapag pinal na ang status.
GET https://collect.noxtica.com/v1/kyc/sessions/00000000-0000-4000-8000-000000000001
Authorization: Bearer $NOXTICA_SERVER_KEYMga webhook event
Mga pirmadong HTTPS delivery ang mga event papunta sa endpoint na irerehistro mo sa Backoffice. Abiso ang isang event, hindi pasya.
| Event | Nagaganap kapag |
|---|---|
kyc.session.completed | Kapag naging completed, unverified o error ang hosted session. Kung nakabinbing pagsusuri ang session, ipapadala ang event sa ibang pagkakataon kapag nagpasya na ang tagasuri. |
kyc.session.cancelled | Kinansela ng customer sa hosted page. Tahasang mag-subscribe. Kapag naka-enable para sa organisasyon mo. |
kyc.verification.completed | Kapag umabot sa pinal na estado ang beripikasyon. |
kyc.erasure.completed | Kapag nakumpleto ang kahilingan sa pagbura. Kapag naka-enable ang pagbura para sa organisasyon mo. |
kyc.document.expiry_warning | Kapag malapit nang mag-expire o nag-expire na ang beripikadong dokumento. Kapag naka-enable para sa organisasyon mo. |
kyc.reverification.due | Kapag sumapit na ang nakatakdang muling beripikasyon. Kapag naka-enable para sa organisasyon mo. |
Halimbawang event
Mga synthetic na value lamang. Hindi kailanman kasama sa mga event ang reference ng customer mo: itugma ang event sa customer gamit ang session id.
{
"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"
}
}Beripikahin ang bawat delivery
- Kasama sa bawat delivery ang mga header na X-Noxtica-Signature, X-Noxtica-Timestamp, X-Noxtica-Event at X-Noxtica-Delivery.
- HMAC-SHA256 ang lagda sa timestamp, tuldok at hilaw na request body. Beripikahin ito bago i-parse ang body, at magtakda ng sarili mong palugit sa timestamp.
- Naihahatid ito nang kahit isang beses at walang takdang pagkakasunod-sunod. Alisin ang mga duplicate gamit ang X-Noxtica-Delivery, saka basahin ang status ng session bago kumilos.
Hindi kailangan ng SDK. May mga halimbawang curl, Node.js at Python sa dokumentasyon.
Magbasa pa sa dokumentasyon
Proteksiyon ng data
Inilalarawan sa seksiyong ito ang sinasabi ng dokumentasyon. Hindi ito legal na payo. Inilalarawan sa Privacy Policy at pahina ng Security kung paano pinangangasiwaan ng Noxtica ang personal na data.
Pagpapanatili
Hindi awtomatikong binubura ng Noxtica ang mga detalye o ebidensiya ng beripikasyon, at hindi ito nagtatakda ng petsa ng pagpapanatili. Mananatili ang mga ito sa tenant mo hanggang burahin ng isang tenant administrator.
Pagbura
Binubura ng tenant administrator ang mga beripikasyon sa Backoffice sa pamamagitan ng pagbibigay ng dahilan, pag-type ng kumpirmasyon at pagsasagawa ng panibagong step-up check. Inaalis ng pagbura ang beripikasyon, mga file at rekord ng ebidensiya nito, habang pinananatili ang mga rekord ng paggamit para sa billing, mga resibo ng legal na batayan at audit trail. Hindi na ito maibabalik.
Mga karapatan ng data subject
Pinoproseso ang mga kahilingan sa karapatang magpabura sa pahina ng KYC Erasure. Inaaprubahan ng ikalawang administrator ang kahilingan, maaaring ipatigil ito pansamantala ng legal hold, at may resibo ng pagbura ang bawat nakaimbak na item. Tanungin ang account team kung ano ang saklaw ng naaprubahang kahilingan para sa tenant mo bago mangako sa customer ng takdang panahon.
Pag-access sa ebidensiya
Mas mataas at hiwalay na pahintulot ang kailangan para buksan ang mga orihinal na kuha kaysa sa pagsusuri ng kaso. Limitado ito sa mga administrator, nangangailangan ng panibagong step-up check, at nire-record sa audit ang bawat pagtingin. Mga natuklasan at sukat lang ang nakikita ng ibang role, hindi ang mga orihinal.
Encryption at paghihiwalay
Naka-encrypt habang nakaimbak ang hilaw na ebidensiya ng pagkakakilanlan, at kung naka-enable lang ang pag-iimbak ng hilaw na ebidensiya para sa tenant mo. Lalabas na hindi nahanap ang session na pag-aari ng ibang organisasyon.
Residency
May setting ng residency na TR, EU o US ang imbakan ng ebidensiya para sa bawat tenant. Tanungin ang account team kung ano ang saklaw nito para sa tenant mo. Walang sinasabi ang pahinang ito na mananatili ang data sa isang partikular na bansa.
Pahintulot at legal na batayan
Ipinapakita ng hosted page sa customer ang layunin mo at abiso sa privacy bago kumuha ng anumang datos. Itinatala ng awtorisadong tao sa organisasyon mo ang legal na batayan, at hindi ito pinipili ng Noxtica para sa iyo. Responsibilidad mo ang mga abiso, pahintulot at legal na batayan sa bawat hurisdiksiyong pinaglilingkuran mo.
Mga karaniwang tanong
Maaari ko bang i-on nang mag-isa ang beripikasyon ng pagkakakilanlan?
Hindi. Ibinibigay ito bawat tenant sa ilalim ng kontroladong availability. Makipag-ugnayan sa team para talakayin ang use case at hurisdiksiyon mo.
Awtomatiko ba nitong inaaprubahan ang mga customer?
Hindi. Walang resulta ng pagsusuri na kusang nagtatakda sa hosted verification bilang beripikado. Naghihintay ang bawat hosted verification na magtala ng pasya ang isang tao, at completed lang ang katumbas ng pag-apruba.
Nakakaharang ba ng pandaraya ang presentation-attack detection?
Hindi. Payo lamang ang PAD. Iniuulat ng Noxtica ang resulta nito at hindi ito kailanman hinahayaang magpasya. Ituring ito, gaya ng bawat pagsusuri, bilang signal para sa tagasuri.
Legal bang patunay ng pagkakakilanlan ang resulta?
Hindi. Walang resultang katumbas ng legal na patunay ng pagkakakilanlan sa labas ng saklaw ng naka-configure na provider at kontrata. Hindi consumer reporting agency ang Noxtica, at hindi dapat gamitin ang output para malaman ang pagiging kuwalipikado sa credit, insurance, trabaho o pabahay.
Gaano katagal valid ang link ng beripikasyon?
Isang araw bilang default, at maaari mo itong itakda kapag ginawa mo ang session. Pagkabukas ng customer sa link, may 30 minuto siya para tapusin.
Maaari ko bang i-embed ang hosted page o itakda ang wika nito?
Hindi. Hindi pumapayag ang page na mag-load ito sa iframe, at sinusunod ng wika nito ang browser ng customer.
Anong mga event ang maaari kong matanggap?
Anim na identity event: kyc.session.completed, kyc.session.cancelled, kyc.verification.completed, kyc.erasure.completed, kyc.document.expiry_warning at kyc.reverification.due. Nakadepende ang ilan sa mga setting para sa organisasyon mo.
Gaano katagal ninyo itinatago ang ebidensiya?
Hindi nagtatakda ng petsa ng pagpapanatili ang Noxtica at hindi nito awtomatikong binubura ang mga detalye o ebidensiya ng beripikasyon. Tenant administrator ang nagbubura sa mga ito.
Available ba ang beripikasyon ng negosyo at merchant?
Oo. Available ang beripikasyon ng negosyo (KYB) at beripikasyon ng merchant (KYM). Gumagawa ng link ang server mo, kinukumpleto ng negosyo o merchant ang onboarding sa page na hosted ng Noxtica, at sinusuri ng mga operator mo ang kaso sa Backoffice. I-enable para sa account mo kapag hiniling.
Mga kaugnay na page
Hindi ginagawa ng identity verification
- May kontroladong availability. Inilalaan ang identity verification kada tenant.
- Hindi ito legal na patunay ng pagkakakilanlan. Walang resultang maituturing na legal na patunay sa labas ng saklaw ng naka-configure na provider at kontrata. Batay sa posibilidad ang mga resulta at maaaring magkaroon ng maling positibo o maling negatibo.
- Ikaw ang nagpapasya. Dapat suriin ng kwalipikadong miyembro ng team mo ang mga pasyang makasasama. Hindi consumer reporting agency ang Noxtica. Huwag gamitin ang output sa pagiging kwalipikado sa credit, insurance, trabaho o pabahay.
- Mga responsibilidad mo. Responsibilidad mo ang mga abiso, pahintulot at legal na batayan sa pagkolekta ng ebidensiya ng pagkakakilanlan mula sa mga customer mo sa bawat hurisdiksiyong pinaglilingkuran mo.
Mga pagtatantya batay sa posibilidad ang mga score, dahilan at hatol, hindi pahayag ng katotohanan. Ang inyong team ang nagpapasya sa lahat ng pagkakataon.Basahin ang disclaimer