SDK PHP de Didit per a KYC, AML i transaccions

El SDK oficial de Didit per a PHP. Requereix PHP 8.1 o posterior i funciona amb qualsevol client HTTP compatible amb PSR-18; Guzzle és l’opció habitual. Consulta la visió general dels SDK de servidor per saber què comparteixen tots els SDK.

Instal·lar

composer require didit-protocol/sdk-php guzzlehttp/guzzle

El paquet és didit-protocol/sdk-php a Packagist. El seu codi font i el seu registre de canvis són a didit-protocol/sdk-php a GitHub. La verificació de tokens d’Authentication també necessita l’extensió openssl.

Configurar el client

new DiditClient() llegeix DIDIT_API_KEY de l’entorn. Passa arguments amb nom per substituir-lo o per definir els identificadors de l’organització i de l’aplicació que necessiten les crides amb àmbit d’aplicació (casos, xarxes i informes reguladors). Els camps de la sol·licitud són una única matriu amb els noms de camp propis de l’API; les respostes són objectes de només lectura amb propietats en camelCase i toArray().

<?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";

Crear una sessió

Crea una sessió de verificació per a un flux de treball i envia el teu usuari a la seva URL.

<?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";

Llegir la decisió

Quan l’usuari acabi (o quan arribi el webhook), llegeix la decisió. Cada resultat de funcionalitat és una llista amb una entrada per cada node del flux de treball.

<?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";
}

Verificar un webhook

Passa el cos sense processar, exactament tal com s’ha rebut, i les capçaleres de la sol·licitud. verify llança WebhookVerificationException per a qualsevol lliurament que no sigui vàlid o recent, i altrament retorna un esdeveniment amb tipus.

<?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'),
));

A Laravel i Symfony, passa $request->getContent() i $request->headers->all(); amb una sol·licitud PSR-7, passa la mateixa sol·licitud com a capçaleres. Mentre rotis el secret, passa tots dos: [$newSecret, $oldSecret]. Consulta Webhooks per veure els esdeveniments i l’esquema de signatura.

Cribrar una transacció

Envia un pagament, una retirada o una transferència de criptomonedes al monitoratge de transaccions; la resposta n’inclou l’estat i la puntuació de risc.

<?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";

Verificar els tokens d’Authentication

Authentication comprova els tokens d’accés que signa l’emissor d’Authentication, al teu backend, sense cridar Didit a cada sol·licitud. Passa una memòria cau PSR-16 perquè les claus de l’emissor es recuperin una sola vegada i no a cada sol·licitud. També intercanvia codis, actualitza els tokens, comprova i revoca sessions i executa processos d’autenticació reforçada.

La verificació de tokens fa les comprovacions de Verificar un token al teu servidor, amb l’emissor i les claus de signatura de la teva aplicació.

<?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;
}

Errors

<?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";
}

Llistes i fitxers

<?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());

Les pàgines d’endpoint de servidor de la referència de l’API inclouen un exemple en PHP per a la seva operació, excepte els endpoints i els camps que encara no inclou cap versió 1.0.1, que s’indiquen a la visió general.

Guies

Autenticació

Model Context Protocol (MCP)

SDK web

SDK natius

SDK de servidor

Integracions

SDK PHP de Didit per a KYC, AML i transaccions

Instal·lar

Configurar el client

Crear una sessió

Llegir la decisió

Verificar un webhook

Cribrar una transacció

Verificar els tokens d’Authentication

Errors

Llistes i fitxers

​Instal·lar

​Configurar el client

​Crear una sessió

​Llegir la decisió

​Verificar un webhook

​Cribrar una transacció

​Verificar els tokens d’Authentication

​Errors

​Llistes i fitxers

Instal·lar

Configurar el client

Crear una sessió

Llegir la decisió

Verificar un webhook

Cribrar una transacció

Verificar els tokens d’Authentication

Errors

Llistes i fitxers