Přejít na hlavní obsah

Hostované ověření KYC

Ověření totožnosti prostřednictvím Noxtica

Firmy používají Noxtica k ověření totožnosti svých zákazníků přímo v prohlížeči — bez nutnosti instalovat aplikaci.

O rozhodnutí rozhodujete vy. My vám předáme důkazy.

  • Bez instalace aplikace
  • Podepsané webhooky a API pro stav
  • Možnost kontroly člověkem
  • Rozhodnutí je na vašem týmu
Telefon s úvodní obrazovkou hostovaného ověřovacího procesu, názvem firmy a důvodem kontroly.

Ověření totožnosti, které zákazníci dokončí v prohlížeči

Noxtica zajišťuje celou zákaznickou cestu: pokyny ke kameře, pořízení dokladu a selfie, kontrolu živosti i obrazovku s výsledkem. Váš server vytvoří relaci a přečte její výsledek. Zákazník zůstává v prohlížeči.

  • Bez aplikace a zbytečných překážek

    Zákazník otevře odkaz v telefonu nebo počítači. Není třeba nic instalovat a uživatel počítače může pomocí QR kódu pokračovat na telefonu.

  • Rozhoduje váš tým

    Kontroly dokladu, obličeje a živosti poskytují automatizované signály včetně důvodů. Posoudí je člověk ve vaší organizaci. Noxtica nikoho automaticky neschvaluje.

  • Záznamy z pořízení se nedostanou na vaše servery

    Hostovaná stránka shromáždí podklady a odešle je v zapečetěné podobě. Váš server nikdy nedostane odpovědi zákazníka ani pořízené záznamy přímo.

  • Každý případ lze auditovat

    U každého ověření se uchovávají důvody, verzovaný záznam posouzení a auditní záznam každého rozhodnutí v Backoffice.

  • Jedna integrace, dva způsoby zahájení

    Vytvářejte relace přes API ze svého backendu, nebo posílejte jednorázové pozvánky z Backoffice bez psaní kódu.

  • Zpřístupněno pro vás

    Ověření totožnosti se zpřístupňuje jednotlivým tenantům v rámci řízené dostupnosti. Váš tým pro správu účtu potvrdí, co platí pro vaši organizaci a jurisdikci.

Od volání API k výsledku

Celý proces má osm kroků. Zahájí ho a dokončí váš server. Zákaznické kroky probíhají na stránce hostované službou Noxtica.

Váš serverZákazník v prohlížečiNoxticaVáš týmHostovaná stránka, zapečetěné nahrávání a kontroly1Vytvoření relace2Odeslání odkazu3Pokračování natelefonu podlepotřeby4Pořízení dokladu5Pořízení selfie6Dokončeníkontroly živosti7Posouzení8Načtení výsledku
  1. Vytvoření relace

    Váš server zavolá API relací s vlastním neprůhledným odkazem na zákazníka. Odpověď obsahuje ID relace a jednorázový odkaz.

  2. Odeslání odkazu

    Přesměrujte zákazníka, otevřete novou kartu, pošlete mu odkaz e-mailem nebo zprávou, případně ho zobrazte jako QR kód.

  3. Pokračování na telefonu podle potřeby

    Na počítači hostovaná stránka nabídne QR kód a možnost zkopírovat odkaz, aby zákazník mohl pokračovat kamerou telefonu.

  4. Pořízení dokladu

    Pokyny při živém náhledu kamery pomáhají omezit odlesky, rozmazání, náklon a přílišnou vzdálenost. Pořídí se přední strana, a pokud ji daný typ dokladu má, také zadní strana.

  5. Pořízení selfie

    Řízené pořízení selfie slouží k porovnání obličeje s fotografií na dokladu.

  6. Dokončení kontroly živosti

    Krátká řízená sekvence pohybů hlavou a mrknutí. Snímky se znovu kontrolují na serveru.

  7. Posouzení

    Noxtica zpracuje odeslané podklady. Dokončené pořízení čeká ve frontě k posouzení v Backoffice, dokud někdo z vaší organizace nezaznamená rozhodnutí.

  8. Načtení výsledku

    Váš server načte stav relace, nebo obdrží podepsanou událost a poté načte stav. Postupujte podle stavu vráceného při načtení.

Kam putují data

Dvě oddělené cesty: váš server komunikuje s API Noxtica pomocí serverového klíče a zákazník s hostovanou stránkou pomocí jednorázového odkazu. Podklady putují z prohlížeče zákazníka do Noxtica. Přes vaše servery neprocházejí.

noxticaVáš backendAPI NoxticaAPI pro stav a podepsaný webhookProhlížeč zákazníkaHostovaná stránkaKontrolyPosouzení vBackofficevytvoří relacijednorázový odkazotevře odkazzapečetěné nahránísignályrozhodnutívýsledekData z pořízení neprocházejí přes vaše servery

Co vidí váš zákazník

Tyto obrazovky pocházejí z hostovaného procesu se syntetickým ukázkovým dokladem a syntetickým obličejem. Na této stránce není zobrazen žádný skutečný člověk ani doklad totožnosti.

  • Úvodní obrazovka hostovaného procesu s názvem žádající firmy, účelem kontroly a tlačítkem pro zahájení.
    Firma, účel a jednoduché tlačítko pro zahájení.
  • Obrazovka s informacemi o ochraně soukromí v hostovaném procesu před použitím kamery.
    Informace o ochraně soukromí před pořízením záznamů.
  • Obrazovka výběru dokladu v hostovaném procesu s typem dokladu a zemí vydání.
    Zákazník vybere typ dokladu a zemi vydání.
  • Náhled kamery na syntetický ukázkový doklad totožnosti s pokyny k pořízení na obrazovce.
    Pokyny při živém náhledu na syntetické ukázkové kartě.
  • Obrazovka pořízení selfie se syntetickým počítačem vytvořeným obličejem uvnitř obrysu hlavy.
    Řízené pořízení selfie se syntetickým obličejem.
  • Probíhající krok kontroly živosti s pokynem k pohybu na obrazovce a syntetickým obličejem.
    Krátká řízená sekvence pro kontrolu živosti.
  • Obrazovka s výsledkem hostovaného procesu informující zákazníka, že ověření čeká na posouzení.
    Obrazovka s výsledkem: čeká na posouzení, nejde o schválení.
Zobrazení hostovaného procesu na počítači s QR kódem a možností zkopírovat odkaz a pokračovat na telefonu.
Na počítači QR kód a možnost zkopírovat odkaz pomohou zákazníkovi pokračovat na telefonu.

Přístupné v 36 jazycích

Stránka se otevře v jazyce zařízení dané osoby a podporuje rozvržení zprava doleva pro arabštinu, perštinu a hebrejštinu. Nabízí světlý, tmavý a vysoce kontrastní motiv, popisky pro čtečky obrazovky, ovládání klávesnicí a omezení pohybu.

Podporované doklady a země

  • Cestovní pas
  • Občanský průkaz
  • Řidičský průkaz
  • Povolení k pobytu

Pro každé ověření vyberete, které z těchto čtyř typů dokladů přijímá. U pasu se pořizuje datová stránka. U ostatních tří se pořizuje přední i zadní strana.

Země vydání se nastavují pro každý účet zvlášť, nejsou pevně dané veřejným seznamem, a zákazník vidí názvy zemí ve svém jazyce. Než zákazníkům slíbíte pokrytí, zeptejte se nás na trhy, na kterých působíte.

Volitelné další kroky se použijí pouze tehdy, když jsou pro vaši organizaci povoleny.

Na co se kontroly zaměřují

Každá z níže uvedených kontrol poskytuje podklady pro kontrolujícího i vaše vlastní pravidla řízení rizik. Žádná z nich nepředstavuje rozhodnutí.

  • Kontroly dokladu

    Doklad se načte, určí se jeho typ a tam, kde ji doklad obsahuje, se ověří strojově čitelná zóna. Hledají se známky opětovného fotografování obrazovky nebo tištěné kopie a fotografie, na které není doklad totožnosti, se označí k opětovnému pořízení.

  • Porovnání obličeje

    Portrét na dokladu se porovná se selfie. Slabá shoda je podkladem pro kontrolujícího. Neznamená automatické zamítnutí osoby.

  • Kontrola živosti

    Řízená sekvence pohybů hlavou a mrknutí ukazuje, že k požadovanému pohybu došlo. Snímky se znovu kontrolují na serveru a prohlížeč může výsledek pouze zhoršit, nikdy napravit neúspěšnou kontrolu.

  • Signály útoku pomocí prezentačního média

    Detekce útoků pomocí prezentačního média je pouze poradní. Noxtica oznámí její výsledek, ale nikdy jej nepoužije k rozhodnutí. Skóre je informace, nikoli verdikt o živé osobě či podvodu, a případ zůstává k posouzení.

Žádné plně automatizované schválení

Noxtica nikdy nepřevádí soubor výsledků kontrol na schválení. Automatizované zpracování končí tím, že případ čeká na posouzení člověkem ve vaší organizaci.

pendingopenedverifyingreview_pendingcompletedexpiredunverifiederrorSchválit nebo změnit rozhodnutíJediný stav znamenající schváleníČeká na člena vašeho týmuNení schválenoZaznamenání eskalace stav relace nemění
  • Schválení znamená pouze stav completed. Každý jiný stav považujte za neschválený, dokud nenačtete novější.
  • Žádný výsledek kontroly, jakkoli dobrý, sám o sobě neznamená, že je hostované ověření úspěšné.
  • Případ čekající na posouzení automaticky nezamítejte. Znamená to, že není k dispozici spolehlivá odpověď a měl by se na něj podívat člověk.

Stavy, které může váš server načíst

pending
Relace existuje a odkaz ještě nebyl otevřen.
opened
Zákazník otevřel odkaz.
verifying
Odeslané podklady se zpracovávají.
review_pending
Zpracování skončilo a ve frontě k posouzení v Backoffice je třeba rozhodnout. Nejde o zamítnutí ani schválení.
completed
Rozhodnutí relaci schválilo.
unverified
Zpracování skončilo negativním výsledkem.
error
Zpracování se nepodařilo dokončit kvůli chybě nebo odmítnutí.
expired
Platnost odkazu nebo čas na dokončení vypršel.

Vaši kontrolující

Dokončené pořízení čeká ve frontě KYC ke kontrole v Backoffice. Správce vybere možnost Schválit nebo změnit rozhodnutí; obě možnosti dokončí relaci. Zaznamenání eskalace ponechá její stav beze změny. Rozhodnutí vyžadují roli správce a dodatečné ověření. Každé z nich vytvoří verzovaný záznam posouzení a auditní záznam.

Pro vývojáře

Dvě volání a jedna událost. Vše níže je syntetické: klíč, ID i odkaz na zákazníka jsou pouze příklady.

Vytvoření relace z vašeho serveru
curl -X POST https://collect.noxtica.com/v1/kyc/sessions \
  -H "Authorization: Bearer sk_prod_EXAMPLE_NOT_A_REAL_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7d9e2c64-example-0001" \
  -d '{
    "subjectRef": "cust_4821",
    "purpose": "Open your account",
    "returnUrl": "https://merchant.example.com/kyc/return"
  }'
Odpověď jednou obsahuje jednorázový odkaz
{
  "ok": true,
  "sessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "url": "https://verify.noxtica.com/s/<one-time-token>",
  "expiresAt": 1790762445000,
  "requestId": "req-example"
}
Načtení stavu
curl https://collect.noxtica.com/v1/kyc/sessions/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
  -H "Authorization: Bearer sk_prod_EXAMPLE_NOT_A_REAL_KEY"

# { "ok": true, "session": { "status": "review_pending", ... } }
Podepsaná událost a následné načtení stavu
POST /your/webhook  (headers: X-Noxtica-Signature, X-Noxtica-Timestamp,
                    X-Noxtica-Event, X-Noxtica-Delivery)
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6:wh_example",
  "type": "kyc.session.completed",
  "created_at": 1790762445000,
  "tenant_id": "t_example",
  "data": {
    "schemaVersion": "1",
    "sessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "completed",
    "verificationId": "9b1c4e52-example-verification",
    "reasonCodes": [],
    "occurredAt": 1790762445000,
    "deliveryId": "3fa85f64-5717-4562-b3fc-2c963f66afa6:wh_example"
  }
}
Ověření podpisu původního těla požadavku
import { createHmac, timingSafeEqual } from 'node:crypto';

// HMAC-SHA256 over `${timestamp}.${rawBody}`, sent as "sha256=<hex>".
export function isValid(secret, timestamp, rawBody, header) {
  const expected = 'sha256=' + createHmac('sha256', secret)
    .update(`${timestamp}.${rawBody}`).digest('hex');
  const a = Buffer.from(expected);
  const b = Buffer.from(header);
  return a.length === b.length && timingSafeEqual(a, b);
}

Užitečné informace

  • Odešlete hlavičku Idempotency-Key; při opakování požadavku se vrátí stejná relace, aniž by se znovu zpřístupnil odkaz.
  • Podepsaná událost je oznámení, nikoli autoritativní zdroj. Ověřte ji, zaznamenejte ID doručení, načtěte stav relace a řiďte se jím.
  • Události nikdy neobsahují odkaz na vašeho zákazníka, jeho jméno ani údaje z dokladu.
  • Návratový odkaz musí používat doménu registrovanou pro vaši organizaci. Stav načítejte s postupně se prodlužujícími prodlevami, protože platí limity požadavků.

Ochrana údajů

Následující popis zachycuje současné chování produktu podle veřejné dokumentace. Právní podmínky najdete v zásadách ochrany soukromí, dodatku o zpracování údajů a seznamu dílčích zpracovatelů.

  • Nejprve souhlas

    Před spuštěním kamery hostovaná stránka zobrazí informace o ochraně soukromí s názvem vaší firmy, účelem a odkazem na vaše zásady ochrany soukromí. Oprávněná osoba ve vaší organizaci nejprve zaznamená právní základ; do té doby se vytváření relací odmítá.

  • Zapečetěné už v prohlížeči

    Fotografie a video snímky se před nahráním šifrují v prohlížeči zákazníka a používají se pouze pro dané ověření. Původní média zůstávají v Backoffice zapečetěná.

  • Oddělení podle tenantů

    Každá relace i každé načtení patří jedné organizaci. Načtení stavu relace patřící jiné organizaci vrátí informaci, že nebyla nalezena, stejně jako u neznámého ID.

  • Řízený přístup k podkladům

    Původní podklady mohou otevřít pouze správci. Každé otevření vyžaduje dodatečné ověření a zaznamená se do auditu; zobrazení se zablokuje, pokud nelze zapsat auditní záznam. Ostatní role vidí zjištění a měření, nikoli originály.

  • Žádné osobní údaje v událostech

    Události webhooků obsahují ID, stavy a kódy důvodů. Neobsahují jména, údaje z dokladů ani odkaz na vašeho zákazníka.

  • Odkazy s omezenou platností

    Odkaz, který nikdo neotevře, vyprší spolu s relací. Po prvním otevření zákazníkem je čas na dokončení omezený. Relace čekající na posouzení během čekání nevyprší.

Uchovávání a mazání

Noxtica automaticky nemaže podrobnosti o ověření KYC ani podklady a nestanovuje pro ně datum uchovávání. Zůstávají ve vašem tenantu, dokud je správce tenantu nesmaže.

Správce smaže ověření v Backoffice uvedením důvodu, zadáním potvrzovacího textu a dodatečným ověřením. Smazání odstraní ověření, jeho relace, soubory s podklady, záznamy i rozhodnutí o posouzení. Tuto akci nelze vrátit zpět. Záznamy o využití pro fakturaci, potvrzení právního základu, neprůhledný odkaz na zákazníka a auditní stopa zůstávají. Ověření nelze smazat pomocí serverového klíče API.

Výmaz údajů subjektu probíhá jako žádost v Backoffice: schvaluje ji jiný správce, právní blokace výmazu zabrání, každá položka zanechá potvrzení a podepsaná událost oznámí výsledek bez ID subjektu.

Za oznámení, souhlasy a právní základ pro shromažďování dokladů totožnosti zákazníků v každé jurisdikci, kde působíte, odpovídáte vy. Noxtica není agenturou pro spotřebitelské úvěrové informace. Výsledek nepoužívejte k posuzování způsobilosti pro úvěr, pojištění, zaměstnání ani bydlení.

Ověření firem a obchodníků

Ověření firmy (KYB) a nástup obchodníků (KYM). Dostupné. Na vyžádání povolíme pro váš účet. Veřejné API KYB se povoluje pro každý účet zvlášť.

Dokumentace k ověření firem

Začínáme

Ověření totožnosti se zpřístupňuje jednotlivým tenantům. Obraťte se na tým, potvrďte svůj případ použití a jurisdikci a váš tým pro správu účtu vám modul zpřístupní.

  1. Proberte s týmem svůj případ použití a trhy, na kterých působíte.
  2. Váš tým pro správu účtu zpřístupní modul a oprávněná osoba ve vaší organizaci zaznamená právní základ a nastavení hostované stránky v Backoffice.
  3. Vytvořte relaci přes API nebo odešlete jednorázovou pozvánku z Backoffice.

Časté dotazy

Schvaluje nebo zamítá Noxtica mé zákazníky?

Ne. Noxtica vrací automatizované signály s uvedením důvodů a dokončené pořízení čeká ve vaší frontě k posouzení. Schválení znamená pouze stav completed, který se zobrazí až poté, co správce ve vaší organizaci ověření schválí nebo změní rozhodnutí.

Musí si zákazník nainstalovat aplikaci?

Ne. Proces probíhá v aktuálním mobilním nebo počítačovém prohlížeči. Na počítači může zákazník naskenovat QR kód a pokračovat na telefonu. Některé prohlížeče v aplikacích nejsou podporovány; stránka pak zákazníka požádá, aby odkaz otevřel ve vlastním prohlížeči.

Které doklady jsou podporovány?

Cestovní pasy, občanské průkazy, řidičské průkazy a povolení k pobytu. Vyberete typy přijímané pro jednotlivá ověření a země vydání se nastavují pro každý účet zvlášť.

Jak zjistím výsledek?

Načtěte stav relace ze svého serveru, nebo přijměte podepsanou událost a potom načtěte stav. Řiďte se stavem vráceným při načtení, nikoli tělem události.

Je kontrola živosti důkazem, že jde o skutečnou osobu?

Ne. Výsledky kontroly živosti a útoků pomocí prezentačního média jsou podklady pro kontrolujícího. Detekce útoků pomocí prezentačního média je pouze poradní: skóre je informace, nikoli verdikt o živé osobě či podvodu, a případ zůstává k posouzení.

Jak dlouho se uchovávají snímky a výsledky?

Noxtica automaticky nemaže podrobnosti o ověření ani podklady a nestanovuje datum jejich uchovávání. Zůstávají ve vašem tenantu, dokud je správce tenantu nesmaže v Backoffice.

Mohu hostovanou stránku vložit na svůj web?

Výchozí možností je přesměrování na celou stránku nebo otevření nové karty. Hostovaná stránka odmítá vložení do rámce iframe, pokud tato možnost není pro vaši organizaci zpřístupněna.

Mohu si ověření totožnosti zapnout sám?

Zatím ne. Zpřístupňuje se jednotlivým tenantům v rámci řízené dostupnosti. Obraťte se na tým a proberte svůj případ použití a jurisdikci.

Jsou výsledky právním důkazem totožnosti?

Ne. Výsledky jsou pravděpodobnostní, mohou být chybné oběma směry a nejsou právním důkazem totožnosti. Každé nepříznivé rozhodnutí by měl před tím, než ovlivní zákazníka, posoudit člověk ve vaší organizaci.

Nabízíte ověření firem?

Ano. Ověření firem (KYB) a nástup obchodníků (KYM): dostupné, na vyžádání povolíme pro váš účet.