Zum Hauptinhalt springen
Die offizielle Didit-Bibliothek für PHP. Sie erfordert PHP 8.1 oder neuer und funktioniert mit jedem PSR-18-HTTP-Client; Guzzle ist die übliche Wahl. In der Übersicht der Server-SDKs erfahren Sie, was alle SDKs gemeinsam haben.

Installation

Das Paket ist 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.
Übergeben Sie in Laravel und Symfony $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.

Fehler

Listen und Dateien

Die Server-Endpoint-Seiten der API-Referenz enthalten ein PHP-Beispiel für ihre jeweilige Operation, mit Ausnahme der Endpoints und Felder, die in keinem 1.0.1-Release enthalten sind und in der Übersicht genannt werden.
Zuletzt geändert am 7. November 2026