Hostované ověřování identity, rozhodnutí zůstává na vás

Kontroly a signály

Hostovaný proces poskytuje výsledky kontrol, které slouží jako podklady pro kontrolující osobu. Jde o signály pro posouzení. Samy nerozhodují o výsledku a nezaručují blokování podvodů.

Pro vývojáře

Vše níže využívá běžné HTTPS z vašeho serveru. Úplnou referenci najdete v dokumentaci.

Tři způsoby, jak zahájit ověření

• Hostovaná relace z vašeho serveru. Váš server vytvoří odkaz přes API a stránku hostuje Noxtica.
• Pozvánka z Backoffice. Odkaz vytvoří osoba ve vaší organizaci v Backoffice bez použití kódu.
• Přímé API z vašeho serveru. Komunikace mezi servery bez hostovaného odkazu. Vaše vlastní obrazovky dnes neumožňují pořídit doklad ke kontrole, proto použijte hostovanou relaci, pokud zákazník potřebuje doklad vyfotit.

Vytvoření relace

Autentizujte se klíčem serveru s oprávněním k identitě. Klíč uchovávejte na serveru. Odešlete Idempotency-Key, aby opakovaný požadavek nevytvořil druhou relaci.

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"}'

Odpověď

Odkaz se vrací pouze jednou, v této odpovědi. Považujte ho za tajný údaj a nezaznamenávejte ho do protokolů. Platnost vyprší v čase uvedeném v milisekundách epochy.

{
  "ok": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "url": "https://verify.noxtica.com/s/EXAMPLE_TOKEN",
  "expiresAt": 1790848845000,
  "domainId": null,
  "requestId": "req_example"
}

Načtení stavu

Relace, kterou jste vytvořili, vždy vrací 200, i když její platnost vypršela. Stav načítejte s postupně delším intervalem a skončete při dosažení konečného stavu.

GET https://collect.noxtica.com/v1/kyc/sessions/00000000-0000-4000-8000-000000000001
Authorization: Bearer $NOXTICA_SERVER_KEY

Události webhooků

Události se doručují jako podepsané požadavky HTTPS na koncový bod, který zaregistrujete v Backoffice. Událost je oznámení, nikoli rozhodnutí.

Ukázková událost

Pouze syntetické hodnoty. Události nikdy neobsahují referenci vašeho zákazníka: událost přiřaďte zákazníkovi podle ID relace.

{
  "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"
  }
}

Ověřujte každé doručení

• Každé doručení obsahuje hlavičky X-Noxtica-Signature, X-Noxtica-Timestamp, X-Noxtica-Event a X-Noxtica-Delivery.
• Podpis je HMAC-SHA256 vypočtený z časového razítka, tečky a nezpracovaného těla požadavku. Ověřte ho před zpracováním těla a nastavte vlastní toleranci časového razítka.
• Doručení probíhá alespoň jednou a jeho pořadí není pevně dané. Zamezte duplicitám podle X-Noxtica-Delivery a před akcí načtěte stav relace.

SDK není potřeba. Dokumentace uvádí příklady pro curl, Node.js a Python.

Další informace v dokumentaci

• Integrace ověřování totožnosti
• Události a webhooky
• Reference Server API: KYC
• Pozvánky a nastavení hostované stránky
• Přímé API
• Zásady ověřování živosti a PAD
• Časté dotazy a řešení problémů
• Operace v Backoffice

Časté dotazy

Související stránky

• Prohlédněte si hostované ověření
• Ceny
• Ověřování firem a obchodníků (KYB a KYM)
• Data o ověřování: ukládání, přístup a mazání
• Zásady ochrany osobních údajů
• Zabezpečení