Installation
didit-protocol/sdk-php auf Packagist. Quellcode und Changelog befinden sich unter didit-protocol/sdk-php auf GitHub.
Die Token-Verifizierung für Authentication erfordert zudem die Erweiterung openssl.
Client konfigurieren
new DiditClient() liest DIDIT_API_KEY aus der Umgebung aus. Übergeben Sie benannte Argumente, um diesen Wert zu überschreiben oder um die Organisations- und Anwendungs-IDs festzulegen, die Aufrufe auf Anwendungsebene (Fälle, Netzwerke, regulatorische Berichte) benötigen. Anfragefelder sind ein Array mit den eigenen Feldnamen der API; Antworten sind schreibgeschützte Objekte mit Eigenschaften in camelCase und toArray().
Sitzung erstellen
Erstellen Sie eine Verifizierungssitzung für einen Workflow und leiten Sie Ihren Benutzer zu dessen URL weiter.Entscheidung abrufen
Wenn der Benutzer den Vorgang abschließt (oder wenn der Webhook eingeht), rufen Sie die Entscheidung ab. Jedes Funktionsergebnis ist eine Liste mit einem Eintrag für jeden Workflow-Knoten.Webhook verifizieren
Übergeben Sie den rohen Body exakt so, wie er empfangen wurde, sowie die Anfrage-Header.verify wirft eine WebhookVerificationException bei allem, was keine gültige, kürzlich erfolgte Zustellung ist, und gibt andernfalls ein typisiertes Ereignis zurück.
$request->getContent() und $request->headers->all(); bei einer PSR-7-Anfrage übergeben Sie die Anfrage selbst anstelle der Header. Wenn Sie das Secret rotieren, übergeben Sie beide: [$newSecret, $oldSecret]. Unter Webhooks finden Sie die Ereignisse und das Signaturschema.
Transaktion screenen
Übermitteln Sie eine Zahlung, Abhebung oder Krypto-Transaktion an die Transaktionsüberwachung; die Antwort enthält den Status und Risiko-Score der Transaktion.Authentication-Tokens verifizieren
Authentication prüft die Zugriffstoken, die Ihr Authentication-Issuer signiert, in Ihrem Backend, ohne für jede Anfrage Didit aufzurufen. Übergeben Sie einen PSR-16-Cache, damit die Schlüssel des Issuers nur einmal und nicht bei jeder Anfrage abgerufen werden. Es tauscht außerdem Codes aus, aktualisiert Token, prüft und widerruft Sitzungen und führt Step-up-Prüfungen durch.
Die Token-Verifizierung führt die in Token auf Ihrem Server verifizieren beschriebenen Prüfungen anhand des Ausstellers und der Signaturschlüssel Ihrer Anwendung durch.