Trust Center
Verifieer je eigen gebruikers: identiteitsdocumenten, gezichtsvergelijking en bedrijfscontroles.
Drie methoden doen vanuit code wat het venster Iemand verifiëren doet: een sessie openen, een sessie lezen en sessies tonen. Elke methode werkt op het Trust Center van het account waarvan je de API-sleutel gebruikt.
Open een sessie
Roep verify_session_create aan. Stuur level (1 tot 4, standaard 2) en, als je wilt, je eigen external_ref (maximaal 200 tekens). Het antwoord bevat een session_id, een hosted_url om naar de persoon te sturen en expires_at, 24 uur later.
Stuur de link
Stuur je gebruiker door naar hosted_url, of stuur hem de link.
Lees het resultaat
Roep verify_session_result aan met het session_id. Het geeft de status, je external_ref, de tijden en het result zodra de sessie klaar is.
Wat de sessie bepaalt
- De modus. Een sessie is een test als de dienst in de testmodus draait en live als hij in Live draait. Testsessies zijn gratis, worden nooit geteld en kunnen vanuit het dashboard worden afgerond. Live-links kunnen nog niet worden voltooid.
- Het niveau. Een niveau boven wat je abonnement toestaat wordt geweigerd, met de vermelding welk abonnement het heeft. Het verzoek wordt nooit stilletjes verlaagd.
- Boven de bundel. Een live sessie boven de maandelijkse bundel van je abonnement wordt op Gratis geweigerd, en op een betaald abonnement wordt hij gemaakt en gemarkeerd als overschrijding.
Sleutels maak je in Developers, en een sleutel maken vereist je eigen Niveau 2.
Webhooks
Vanaf Starter stel je in de instellingen van Trust Center een adres in en wordt er een ondertekend verzoek verstuurd zodra een verificatie is beslist, zodat je niet hoeft te pollen. Elk verzoek bevat een Xuda-Event-header en een Xuda-Signature-header, opgebouwd uit een tijdstempel en een HMAC van de tijdstempel en de body, ondertekend met het geheim dat eenmalig in de instellingen wordt getoond. Een levering die mislukt wordt opnieuw geprobeerd, tot vijf pogingen.