Passer au contenu principal
POST
curl

Autorisations

x-api-key
string
header
requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Corps

application/json
wallet_address
string

L'adresse du portefeuille à vérifier. Optionnelle ; si elle n'est pas renseignée, l'adresse doit être fournie lorsqu'une preuve est démarrée.

Maximum string length: 128
chain
string

Token de la blockchain pour l'adresse, par exemple ETH, BTC ou SOL. Utilisez le même token que dans votre carnet d'adresses de portefeuilles. La signature de message et le test Satoshi ne sont proposés que pour une blockchain prise en charge. L'entrée du carnet d'adresses vérifiée par la preuve la stocke sous son identifiant canonique (ETH, BTC, SOL, TRX).

Maximum string length: 32
holder_name
string

Nom du titulaire du portefeuille, utilisé pour la correspondance du nom du bénéficiaire.

Maximum string length: 255
vendor_data
string

Votre identifiant interne pour le titulaire, reporté sur l'entrée créée dans le carnet d'adresses.

Maximum string length: 255
transaction_id
string<uuid> | null

Optionnel. UUID de transaction Didit d'un transfert Travel Rule à faire avancer lorsque la preuve est vérifiée.

satoshi_deposit_address
string

Optionnel. Une adresse de dépôt que vous contrôlez ; la fournir active la méthode de preuve SATOSHI_TEST.

Maximum string length: 128
callback_url
string

Optionnel. URL http(s) absolue vers laquelle le widget renvoie le client une fois terminé.

Maximum string length: 512
expires_in_minutes
integer
défaut:60

Optionnel. Durée de validité du lien généré, en minutes. Automatiquement prolongée pour couvrir la fenêtre du test Satoshi lorsque SATOSHI_TEST est proposé.

Plage requise: 5 <= x <= 10080

Réponse

La session de widget générée.

widget_session_id
string<uuid>
token
string

Token de session opaque intégré dans l'URL du widget.

url
string

L'URL du widget hébergé de propriété du portefeuille. Ouvrez-la telle quelle dans le navigateur du système (jamais à l'intérieur d'une webview de SDK mobile).

expires_at
string<date-time>
Dernière modification le 7 novembre 2026