> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# PHP-SDK für KYC, AML und Transaktionen

> Schnelleinstieg in das Didit PHP-SDK: typisierte API-Aufrufe via PSR-18, Webhook-Signaturprüfung und Prüfung von Authentifizierungs-Tokens.

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](https://docs.didit.me/de/integration/server-sdks/overview.md) erfahren Sie, was alle SDKs gemeinsam haben.

## Installation

```bash theme={null}
composer require didit-protocol/sdk-php guzzlehttp/guzzle
```

Das Paket ist [`didit-protocol/sdk-php` auf Packagist](https://packagist.org/packages/didit-protocol/sdk-php). Quellcode und Changelog befinden sich unter [didit-protocol/sdk-php](https://github.com/didit-protocol/sdk-php) auf GitHub.

Die Token-Verifizierung für [Authentication](#authentication-tokens-verifizieren) 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()`.

```php theme={null}
<?php

require 'vendor/autoload.php';

use Didit\DiditClient;
use Didit\RequestOptions;

$didit = new DiditClient(
    apiKey: getenv('DIDIT_API_KEY') ?: null,
    organizationId: getenv('DIDIT_ORGANIZATION_ID') ?: null,
    applicationId: getenv('DIDIT_APPLICATION_ID') ?: null,
    timeout: 30.0,
    maxRetries: 2,
);

// Options for a single call.
$decision = $didit->sessions->retrieveDecision(
    '11111111-2222-3333-4444-555555555555',
    [],
    new RequestOptions(timeout: 5.0, maxRetries: 0),
);
echo $decision->status, "\n";
```

## Sitzung erstellen

Erstellen Sie eine [Verifizierungssitzung](https://docs.didit.me/de/sessions-api/create-session.md) für einen Workflow und leiten Sie Ihren Benutzer zu dessen URL weiter.

```php theme={null}
<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

$didit = new DiditClient();

$session = $didit->sessions->create([
    'workflow_id' => '11111111-2222-3333-4444-555555555555',
    'vendor_data' => 'user-123',
    'callback' => 'https://example.com/verification/done',
]);
echo $session->url, "\n";
```

## Entscheidung abrufen

Wenn der Benutzer den Vorgang abschließt (oder wenn der Webhook eingeht), [rufen Sie die Entscheidung ab](https://docs.didit.me/de/sessions-api/retrieve-session.md). Jedes Funktionsergebnis ist eine Liste mit einem Eintrag für jeden Workflow-Knoten.

```php theme={null}
<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

$didit = new DiditClient();

$decision = $didit->sessions->retrieveDecision('11111111-2222-3333-4444-555555555555');
echo $decision->status, "\n";
foreach ($decision->idVerifications ?? [] as $verification) {
    echo $verification->status, "\n";
}
```

## 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.

```php theme={null}
<?php

require 'vendor/autoload.php';

use Didit\DiditClient;
use Didit\Exception\WebhookVerificationException;
use Didit\Webhooks\Events\StatusUpdatedEvent;
use Psr\Http\Message\MessageInterface;

$didit = new DiditClient();

/** @param array<string, string|list<string>>|MessageInterface $headers */
function handleWebhook(DiditClient $didit, string $rawBody, array|MessageInterface $headers, string $secret): int
{
    try {
        $event = $didit->webhooks->verify($rawBody, $headers, $secret);
    } catch (WebhookVerificationException $e) {
        error_log('rejected: ' . $e->reason);
        return 400;
    }
    if ($event instanceof StatusUpdatedEvent) {
        error_log($event->sessionId . ' ' . $event->status);
    }
    return 200;
}

http_response_code(handleWebhook(
    $didit,
    (string) file_get_contents('php://input'),
    getallheaders(),
    (string) getenv('DIDIT_WEBHOOK_SECRET'),
));
```

Ü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](https://docs.didit.me/de/integration/webhooks.md) finden Sie die Ereignisse und das Signaturschema.

## Transaktion screenen

Übermitteln Sie eine Zahlung, Abhebung oder Krypto-Transaktion an die [Transaktionsüberwachung](https://docs.didit.me/de/transaction-monitoring/overview.md); die Antwort enthält den Status und Risiko-Score der Transaktion.

```php theme={null}
<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

$didit = new DiditClient();

$transaction = $didit->transactions->create([
    'transaction_id' => 'txn-1001',
    'transaction_category' => 'finance',
    'transaction_details' => ['direction' => 'outbound', 'amount' => 1500.0, 'currency' => 'EUR'],
    'subject' => ['entity_type' => 'individual', 'vendor_data' => 'user-123', 'full_name' => 'Maria Garcia'],
]);
echo $transaction->status, ' ', $transaction->score, "\n";
```

## Authentication-Tokens verifizieren

`Authentication` prüft die Zugriffstoken, die Ihr [Authentication](https://docs.didit.me/de/authentication/overview.md)-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.

> [!NOTE]
>
> Die Token-Verifizierung führt die in [Token auf Ihrem Server verifizieren](https://docs.didit.me/de/authentication/tokens-and-jwks.md#token-auf-ihrem-server-prüfen) beschriebenen Prüfungen anhand des Ausstellers und der Signaturschlüssel Ihrer Anwendung durch.

```php theme={null}
<?php

require 'vendor/autoload.php';

use Didit\Authentication\Authentication;
use Didit\Authentication\TokenVerificationException;

// The publishable key (pk_live_... or pk_test_...) carries your issuer URL.
$auth = Authentication::fromPublishableKey('pk_live_...');

function currentUser(Authentication $auth, string $accessToken): ?string
{
    try {
        $claims = $auth->verifyAccessToken($accessToken, audience: 'your-application-id');
    } catch (TokenVerificationException $e) {
        error_log('rejected: ' . $e->reason);
        return null;
    }
    return $claims->sub;
}
```

## Fehler

```php theme={null}
<?php

require 'vendor/autoload.php';

use Didit\DiditClient;
use Didit\Exception\ApiStatusException;
use Didit\Exception\NotFoundException;

$didit = new DiditClient();

try {
    $didit->sessions->retrieveDecision('11111111-2222-3333-4444-555555555555');
} catch (NotFoundException $e) {
    echo "no such session\n";
} catch (ApiStatusException $e) {
    echo $e->status, ' ', $e->requestId, "\n";
}
```

## Listen und Dateien

```php theme={null}
<?php

require 'vendor/autoload.php';

use Didit\DiditClient;
use Didit\File;

$didit = new DiditClient();

// Lists page through every result.
foreach ($didit->sessions->list(['status' => 'Approved']) as $session) {
    echo $session->sessionId, "\n";
}

// Uploads take File::fromPath, File::fromBytes or File::fromStream.
$result = $didit->idVerification->verify([
    'front_image' => File::fromPath('id-front.jpg'),
    'back_image' => File::fromPath('id-back.jpg'),
]);
print_r($result->toArray());
```

Die Server-Endpoint-Seiten der [API-Referenz](https://docs.didit.me/de/api-reference/overview.md) 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](https://docs.didit.me/de/integration/server-sdks/overview.md) genannt werden.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.