Ontwikkelaarsdocumentatie | API & Integratiegids - Overzicht

Overzicht

Welkom bij de Go.cam ontwikkelaarsdocumentatie.

Deze sectie biedt een volledig overzicht van de Go.cam-service, inclusief details over hoe deze werkt en een stapsgewijze handleiding voor integratie in uw platform.

Aan de slag

Voordat u begint met het implementatieproces, moet u een Go.cam-account aanmaken. Een actief account geeft u toegang als partner en stelt u in staat de vereiste instellingen voor integratie te configureren. De activering van het account duurt doorgaans minder dan 24 uur.

Verificatiemethoden

Go.cam biedt vier verificatiemethoden om ervoor te zorgen dat gebruikers geen minderjarigen zijn:

• Creditcardvalidatie
• Leeftijdsdetectie via selfie
• Leeftijdsextractie via identiteitsdocument
• E-mailverificatie

Eindgebruikers kunnen de verificatie voltooien met een van de beschikbare methoden.

Verificatieproces

Het verificatieproces van Go.cam kan vanuit twee perspectieven worden bekeken: gebruikerservaring en integratielogica van de partner.

1. Gebruikersflow

Fig: Diagram van de gebruikersverificatieflow

Stappen van de gebruikersverificatie (zie diagram):

• 1. De gebruiker bezoekt een partnersite die wordt beschermd door het Go.cam leeftijdsverificatiesysteem.
• 2. De gebruiker start de verificatie door op de knop "Leeftijd verifiëren" te klikken.
• 3. Afhankelijk van de integratie van de partner zal de gebruiker:
• Worden doorgestuurd naar een door Go.cam gehoste verificatiepagina, of
• Interageren met een iframe-overlay die de Go.cam verificatiestroom laadt.
• 4. De gebruiker kiest een van de beschikbare verificatiemethoden:
• Creditcardvalidatie
• Leeftijdsdetectie via selfie
• Leeftijdsextractie via identiteitsdocument
• E-mailverificatie
• 5. De gebruiker verstrekt de vereiste informatie (bijv. creditcardgegevens, webcamtoegang, documentafbeelding of e-mailadres).
• 6. Na voltooiing toont Go.cam het resultaat:
• Succespagina: bevat een knop om terug te keren naar de partnersite.
• Foutpagina: bevat een optie "Opnieuw proberen" en een QR-code om de verificatie voort te zetten op een mobiel apparaat. Bij succes wordt de oorspronkelijke sessie gevalideerd.
• 7. Na een succesvolle verificatie wordt de gebruiker doorgestuurd naar de geconfigureerde terugkeer-URL, waardoor de partnersite wordt ontgrendeld.

2. Partnerintegratie met redirect-logica

Fig: Diagram van de redirect-logica

Redirect-flow (zie diagram):

• 1. De gebruiker opent de partnersite en start de leeftijdsverificatie.
• 2. De partner genereert een Go.cam-verificatie-URL met behulp van de SDK, waarbij wordt meegegeven:
• Cipher key en HMAC key
• Gebruikersmetadata (bijv. userId)
• 3. De gebruiker wordt doorgestuurd naar Go.cam om het verificatieproces te voltooien.
• 4. De gebruiker kiest en voltooit een verificatiemethode.
• 5. Go.cam toont een succes- of foutpagina.
• 6. Resultaten worden als volgt verwerkt:
• Verificatieresultaten worden opgeslagen in Go.cam.
• Go.cam stuurt de resultaten naar de geconfigureerde callback-URL, samen met de opgegeven gebruikersgegevens (bijv. userId).
• Er wordt een cookie aangemaakt op Go.cam met een versleutelde versie van de verificatiegegevens, die later kan worden ontsleuteld met de sleutels van de partner.
• 7. Bij succes wordt de gebruiker doorgestuurd naar de terugkeer-URL en krijgt toegang tot de partnersite.

3. Partnerintegratie met iframe-logica

Fig: Diagram van de iframe-logica

Iframe-flow (zie diagram):

• 1. De gebruiker opent de partnersite en start de leeftijdsverificatie.
• 2. De partner genereert een Go.cam-verificatie-URL met behulp van de SDK, waarbij wordt meegegeven:
• Cipher key en HMAC key
• Gebruikersmetadata (bijv. userId)
• 3. Met behulp van de frontend SDK activeert de partner de iframe-overlay om de Go.cam verificatie-instantie te laden.
• 4. Zodra de iframe is geladen:
• Bevestigt een event de initialisatie.
• Als er al een Go.cam-verificatiecookie bestaat, wordt de partner via een apart event geïnformeerd (de integriteit van de cookie moet worden gecontroleerd).
• 5. De gebruiker kiest en voltooit een verificatiemethode.
• 6. Go.cam toont een succes- of foutpagina:
• Succespagina: sluit de iframe-overlay.
• Foutpagina: laat opnieuw proberen toe.
• 7. Resultaten worden als volgt verwerkt:
• Verificatieresultaten worden opgeslagen in Go.cam.
• Go.cam stuurt de resultaten naar de geconfigureerde callback-URL, samen met de opgegeven gebruikersgegevens (bijv. userId).
• Er wordt een cookie aangemaakt met versleutelde verificatiegegevens, die kunnen worden ontsleuteld met de sleutels van de partner.
• Een JavaScript-event meldt een succesvolle verificatie, zodat de partner de opgeslagen cookie kan valideren.
• 8. Bij succes wordt de iframe verwijderd en wordt de partnersite ontgrendeld.

---

Terminologie

• Partner: U, de integrator die Go.cam op uw platform implementeert.
• Cipher key / HMAC key: Sleutels beschikbaar in uw Go.cam-account, gebruikt om verificatiegegevens te versleutelen en te valideren.
• Verification result callback URL: Endpoint gedefinieerd in uw Go.cam-account waar verificatieresultaten naartoe worden gestuurd.
• Link back URL: URL gedefinieerd via de Go.cam SDK om gebruikers na succesvolle verificatie terug te sturen.

---

Verificatietypen

Go.cam biedt meerdere verificatiemethoden om ervoor te zorgen dat gebruikers aan de leeftijdsvereisten voldoen. Elke methode is ontworpen met privacy, veiligheid en naleving in gedachten.

1. Creditcardverificatie

• De gebruiker wordt tijdelijk doorgestuurd naar een veilige omgeving, waar hij zijn creditcardnummer en vervaldatum moet invoeren.
• Er worden geen kosten in rekening gebracht. Alleen de geldigheid en integriteit van de kaart worden gecontroleerd.
• Dit is de enige verificatiemethode die gegevens naar de backend verzendt. De verwerking gebeurt in een PCI DSS-conforme omgeving.
• Go.cam slaat geen kaartgegevens op en deelt deze niet met derden.

2. Leeftijdsverificatie via selfie

• Vereist toegang tot de webcam om het gezicht van de gebruiker in realtime vast te leggen.
• Een machine learning-model draait lokaal op het apparaat; er worden geen beelden geüpload of opgeslagen.
• Het proces:
• 1. De gebruiker positioneert zijn gezicht in het midden van het scherm.
• 2. Er worden meerdere opnames gemaakt. Uitschieters worden verwijderd en een gemiddelde geschatte leeftijd wordt berekend.
• 3. Gezichtsconsistentiecontroles zorgen ervoor dat dezelfde persoon voor de camera blijft.
• 4. Er is ook een liveness-check die de gebruiker vraagt specifieke acties uit te voeren.
• Als de gebruiker als minderjarig wordt gedetecteerd, wordt automatisch overgeschakeld naar documentverificatie:
• Gezichtsbeelden worden vergeleken met de foto op het document.
• Bij een succesvolle match wordt de geboortedatum geëxtraheerd om de leeftijd te bevestigen.
• Als de gebruiker als volwassene wordt geverifieerd, wordt het proces succesvol afgerond. Anders kan de gebruiker opnieuw proberen binnen een sessievenster van 10 minuten voordat dit verloopt.

Certificering

• Go.cam is Challenge 25 gecertificeerd: personen ouder dan 18 die jonger dan 25 lijken, kunnen worden gevraagd zich te identificeren.
• Gecertificeerd door:
• Association of Sites Advocating Child Protection
• The leading global provider of high-performance web hosting solutions in Cloud, VPS, and Dedicated hosting infrastructures.
• Central Authority for the Supervision and Protection of Minors on the Internet in Germany
• Age Check Certification Scheme
• Leeftijdsverificatie wordt aangedreven door een open-source gezichtsherkenningsmodel. [Meer informatie].

3. Verificatie via identiteitsdocument

• De gebruiker selecteert een land en documenttype (identiteitskaart, paspoort of rijbewijs).
• Ondersteunde regio’s: alle Europese landen en de Verenigde Staten.
• Verificatie kan worden uitgevoerd via:
• Een webcamfoto, of
• Een lokaal geüploade afbeelding.
• Afbeeldingen worden lokaal op het apparaat verwerkt; er wordt niets geüpload naar Go.cam-servers.
• Als er geen selfie-verificatie is uitgevoerd, wordt alleen de geboortedatum geëxtraheerd. De huidige leeftijd wordt berekend en vergeleken met de wettelijke meerderjarigheid.
• Tekstextractie uit documenten gebeurt via een open-source OCR-model. [Meer informatie].

4. Verificatie via e-mail

• Verifieert de leeftijd van de gebruiker op basis van historische e-mailactiviteit.
• Het systeem controleert of het opgegeven e-mailadres voorkomt in een datalek van minstens 13 jaar geleden.
• Aanname: als de e-mail 13 jaar geleden bestond, is de gebruiker minstens 20 jaar oud (minimumleeftijd 7 jaar + 13 jaar).
• Om eigendom te bevestigen, wordt een verificatiecode naar het e-mailadres gestuurd, die de gebruiker moet invoeren.