Wechseln Sie unter dem Anwendungsnamen zu Sandbox, erstellen Sie einen API-Schlüssel und verwenden Sie ihn. Prüfungen werden simuliert, nicht berechnet.
Wechseln Sie mit dem Schalter unter dem Anwendungsnamen zu Sandbox, erstellen Sie dort einen API-Schlüssel und verwenden Sie ihn. Prüfungen werden simuliert, nicht berechnet, und Sie können das Ergebnis wählen.
Didits Sandbox ist das Äquivalent zu den Testkarten eines Zahlungsanbieters: Sie können damit jedes Verifizierungsergebnis auf Abruf reproduzieren, ohne echte Anbieter aufzurufen, ohne echte personenbezogene Daten zu verarbeiten und ohne Ihr Guthaben zu berühren.
#Eine getrennte Testumgebung
Sandbox ist die gemeinsame Testanwendung Ihrer Organisation. Daten, Schlüssel, Webhooks und Listen bleiben von Live getrennt. Ein Streifen oben auf jeder Seite kennzeichnet Sandbox.
- Zu Sandbox wechseln
Klicken Sie unter dem Anwendungsnamen auf Sandbox. Vor der Rückkehr zu Live prüfen Sie die Checkliste für veröffentlichten Workflow, Live-Schlüssel oder Link, Webhook, Zahlung und Aufbewahrung. Bestätigen Sie den Wechsel oder bleiben Sie in Sandbox.
- Sandbox-Schlüssel erstellen
Öffnen Sie Entwickler → API-Schlüssel und wählen Sie beim Erstellen Sandbox. Der Schlüssel bestimmt die Umgebung; ein Live-Schlüssel erstellt keine Sandbox-Sitzung.
- Workflow erstellen oder kopieren
Sandbox hat eigene Workflows. Erstellen Sie Ihren Testablauf oder kopieren Sie ihn aus Live.
- Sessions wie gewohnt erstellen
Derselbe Endpunkt, derselbe Codepfad. Der einzige Unterschied ist, welchen Schlüssel Sie senden.
Ist Sandbox ausgegraut, fehlt Ihrer Organisation noch die Testanwendung. Bitten Sie den Support um Aktivierung; dies ist eine Kontoeinstellung.
#Was Sandbox ändert, und was nicht
| Sandbox | Live | |
|---|---|---|
| Externe Anbieter | Alle simuliert - kein Drittanbieter wird jemals aufgerufen | Echt |
| Abrechnung | Nie abgerechnet; die Guthabenprüfung wird übersprungen | Pro abgeschlossener Funktion abgerechnet |
| Limit für das Erstellen von Sessions | 500 pro 24 Stunden, pro Anwendung | Ihr Guthaben |
| Webhook-Payload | "environment": "sandbox" | "environment": "live" |
| Extrahierte Daten und Status | Vom gewählten Szenario simuliert | Aus der echten Erfassung abgeleitet |
| Erfasste Medien | Werden tatsächlich gespeichert, genau wie bei einer Live-Session | Werden gespeichert |
Sandbox speichert die erfassten Medien - Dokumente, Selfie, Liveness-Video, Dateien zum Adressnachweis - genau wie es eine Live-Session tun würde. Das Ergebnis ist simuliert, aber der Upload ist echt, verwenden Sie also die Beispieldokumente und Testdaten, die der Ablauf anbietet, statt ein echtes Ausweisdokument oder echte persönliche Daten.
Weil Ergebnisse nie von den Pixeln abhängen, erzeugt ein absichtlich schlechtes Foto in der Sandbox keine Ablehnung. Das Szenario entscheidet.
#Das Ergebnis wählen
Geben Sie beim Erstellen der Session einen Szenario-Slug als sandbox_scenario an, oder lassen Sie den Tester wählen: Sandbox-Sessions im gehosteten Ablauf zeigen vor Beginn der Erfassung einen Szenario-Wähler in der Karte, dazu eine Reihe von Beispieldokumenten unter der Upload-Komponente und ein dauerhaftes Banner "nur Testdaten".
Die Szenarien decken die Ergebnisse ab, gegen die Sie tatsächlich bauen müssen:
| Testen möchten | Szenario |
|---|---|
| Alles wird genehmigt | approve |
| Abgelaufenes Dokument | decline_document_expired |
| Unlesbares Dokument | decline_could_not_recognize_document |
| MRZ-Prüfsummenfehler | decline_mrz_validation |
| Unter dem Mindestalter | decline_minimum_age |
| Gesichtsabgleich zu niedrig | decline_face_match_low_similarity |
| Präsentationsangriff bei der Liveness-Prüfung | decline_liveness_attack |
| AML-Sanktions-/PEP-Treffer | decline_aml_hit |
| Gesperrte IP-Adresse | decline_ip_blocklist |
| Adressabweichung beim Adressnachweis | decline_poa_address_mismatch |
| Integritätsprüfung des NFC-Chips fehlgeschlagen | decline_nfc_chip_not_verified |
| Datenbankvalidierung findet nichts | decline_database_no_match |
| Erfordert manuelle Prüfung (AML) | review_aml_possible_match |
| Erfordert manuelle Prüfung (grenzwertiger Gesichtsabgleich) | review_face_match_borderline |
| Erfordert manuelle Prüfung (teilweise Adressübereinstimmung) | review_poa_partial_match |
| KYB-Registerabweichung | decline_kyb_registry_mismatch |
Die review_*-Szenarien gibt es, damit Sie den gesamten manuellen Prüfpfad durchspielen können - die Prüfwarteschlange in der Konsole, den In Review-Webhook, einen Prüfer, der genehmigt oder eine erneute Einreichung anfordert - ohne eine Eingabe zu brauchen, die eine Ablehnung auslöst.
Der aktuelle Katalog der Szenarien und magischen Werte wird von der API selbst
unter GET /v1/sandbox/scenarios/ bereitgestellt. Wenn ein Slug hier jemals
veraltet wirkt, vertrauen Sie dem Endpunkt. Vollständige Referenz:
Sandbox-Testing.
#Die beiden Umgebungen in Ihrem eigenen Code unterscheiden
Jeder Webhook trägt ein Feld environment - "sandbox" oder "live". Verzweigen Sie danach, statt zu versuchen, die Umgebung aus dem Schlüssel abzuleiten, und Sie verwechseln nie eine Test-Session mit einem echten Kunden.
#Was Sandbox nicht tun wird
- Sie liefert keine echten Registerdaten für ein echtes Unternehmen zurück. Sandbox-KYB nutzt simulierte Registerantworten.
- Sie sendet keine echte SMS oder E-Mail. Telefon- und E-Mail-Verifizierung sind simuliert, sodass Sie die Sandbox nicht nutzen können, um die echte Zustellbarkeit von Nachrichten zu prüfen.
- Sie verbraucht Ihr monatliches Tarifguthaben nicht - was auch bedeutet, dass ein Sandbox-Durchlauf Ihnen nichts über Ihr verbleibendes Guthaben sagt.
#Wenn Sie echte Testverifizierungen brauchen
Manche Dinge erfordern wirklich einen Live-Aufruf - zu prüfen, ob der Datenbankdienst eines bestimmten Landes für Sie bereitgestellt ist, oder die SMS-Zustellung an einen bestimmten Netzbetreiber zu bestätigen. Dafür brauchen Sie eine kleine Aufladung auf einer Live-Anwendung statt der Sandbox. Fragen Sie den Support, bevor Sie dafür ausgeben, damit dort zunächst bestätigt werden kann, dass der Dienst für Ihr Konto tatsächlich aktiviert ist.
Kommen Sie nicht weiter? Sprechen Sie mit einem Menschen.
Geben Sie Ihre Organisations-ID und die Session-ID an, um die es geht.