Hostad identitetsverifiering där beslutet ligger hos er

Kontroller och signaler

Det värdbaserade flödet ger kontrollresultat som en granskare kan bedöma. De är signaler som används i granskningen. De avgör inte utfallet och garanterar inte att bedrägerier stoppas.

För utvecklare

Allt nedan är vanlig HTTPS-trafik från din server. Den fullständiga referensen finns i dokumentationen.

Tre sätt att starta en verifiering

• Värdbaserad session från din server. Din server skapar länken via API och Noxtica står värd för sidan.
• Inbjudan från Backoffice. En person i din organisation skapar länken i Backoffice, utan kod.
• Direkt API från din server. Server-till-server-rutter utan värdbaserad länk. De gör det inte möjligt för dina egna skärmar att samla in ett dokument för kontroll i dagsläget, så använd en värdbaserad session när kunden behöver samla in ett dokument.

Skapa en session

Autentisera med en servernyckel som har identitetsbehörighet. Förvara nyckeln på din server. Skicka en Idempotency-Key så att ett nytt försök inte skapar en andra session.

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

Svaret

Länken returneras en gång, i det här svaret. Behandla den som en hemlighet och logga den inte. Förfallotiden anges i epokmillisekunder.

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

Läs statusen

En session som du har skapat returnerar alltid 200, även om den har gått ut. Gör avläsningar med allt längre intervall och sluta när statusen är slutgiltig.

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

Webhook-händelser

Händelser levereras signerade via HTTPS till en slutpunkt som du registrerar i Backoffice. En händelse är en avisering, inte ett beslut.

Exempel på händelse

Endast syntetiska värden. Händelser innehåller aldrig din kundreferens: matcha en händelse med din kund via sessions-id:t.

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

Verifiera varje leverans

• Varje leverans innehåller rubrikerna X-Noxtica-Signature, X-Noxtica-Timestamp, X-Noxtica-Event och X-Noxtica-Delivery.
• Signaturen är en HMAC-SHA256 över tidsstämpeln, en punkt och den råa begärandekroppen. Verifiera den innan du tolkar begärandekroppen och tillämpa din egen tolerans för tidsstämpeln.
• Leverans sker minst en gång och ordningen är inte fast. Deduplikera med X-Noxtica-Delivery och läs sedan sessionsstatusen innan du agerar.

Ingen SDK krävs. Dokumentationen innehåller exempel i curl, Node.js och Python.

Läs mer i dokumentationen

• Integrering av identitetsverifiering
• Händelser och webhooks
• Referens för server-API: KYC
• Inbjudningar och inställningar för den värdbaserade sidan
• Direkt API
• Policy för liveteckenkontroll och PAD
• Vanliga frågor och felsökning
• Arbetsflöden i Backoffice

Vanliga frågor

Relaterade sidor

• Se den hostade verifieringsupplevelsen
• Priser
• Verifiering av företag och handlare (KYB och KYM)
• Verifieringsdata: lagring, åtkomst och radering
• Integritetspolicy
• Säkerhet