Passer au contenu principal
POST
curl

Paramètres de chemin

token
string
requis

Token de session opaque renvoyé lors de la création de la session du widget.

Corps

application/json
method
enum<string>
requis

La méthode de preuve choisie par l'utilisateur final. Elle doit faire partie des allowed_methods du contexte.

Options disponibles:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
wallet_address
string

Prend par défaut le wallet_address de la session. Doit correspondre au portefeuille du transfert lorsque la session est liée à un transfert.

Maximum string length: 128
chain
string

Prend par défaut la blockchain de la session.

Maximum string length: 32

Réponse

La preuve déjà ouverte pour cette méthode, reprise.

proof_id
string<uuid>
method
enum<string>
Options disponibles:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
status
enum<string>

PENDING : l'utilisateur final a choisi cette méthode et la preuve n'est pas encore tranchée. Une signature échouée ou un dépôt test non lisible ou non encore confirmé maintient la preuve PENDING avec un failure_reason, afin que l'utilisateur final puisse réessayer ; un dépôt SATOSHI_TEST soumis est revérifié automatiquement jusqu'à la clôture de sa fenêtre, et une SCREENSHOT soumise attend votre examen. VERIFIED : la propriété est prouvée. REJECTED : le dépôt test est véritablement incorrect (autre expéditeur, montant vers l'adresse de dépôt différent de celui attendu, antérieur au défi, ou transaction ayant déjà prouvé un autre portefeuille) ou votre réviseur a refusé la capture d'écran ; failure_reason indique la cause. Une preuve rejetée est définitive et consomme l'une des tentatives de la session. EXPIRED : la preuve ne peut plus être tranchée (sa fenêtre s'est fermée, l'utilisateur final a changé de méthode, la session du widget a expiré ou le titulaire du portefeuille a changé) ; failure_reason indique la cause.

Options disponibles:
PENDING,
VERIFIED,
REJECTED,
EXPIRED
wallet_address
string
chain
string

Identifiant canonique de la blockchain de l'entrée du carnet d'adresses à laquelle la preuve se rapporte, par ex. ETH, BTC, SOL, TRX.

deposit_address
string | null

Adresse de dépôt à laquelle le client doit envoyer le montant du test Satoshi. Présent uniquement sur une preuve SATOSHI_TEST.

expected_amount
string | null

Montant on-chain exact, dans la devise native du dépôt, auquel le dépôt de test Satoshi doit correspondre. Présent uniquement sur une preuve SATOSHI_TEST.

expires_at
string<date-time> | null

Date limite pour la fenêtre du test Satoshi propre à cette preuve. Présent uniquement sur une preuve SATOSHI_TEST ; l'expires_at propre à la session de widget est prolongé pour la couvrir lorsque SATOSHI_TEST est proposé.

challenge
string | null

Message émis par Didit que le client signe avec son portefeuille. Présent uniquement sur une preuve MESSAGE_SIGNING.

rejection_reason
string

Raison pour laquelle la preuve a été refusée, sous forme de phrase en anglais pour l'utilisateur final. Présente uniquement lorsque status est REJECTED ; vide lorsque votre réviseur a refusé une capture d'écran (votre note reste chez vous).

created_at
string<date-time>
attempts
integer

Nombre de fois où des éléments probants ont été soumis pour ce justificatif (signatures, identifiants de transaction, téléversements).

failure_reason
enum<string>

Raison pour laquelle la dernière tentative a échoué, ou raison pour laquelle la preuve a été clôturée. Vide lorsque rien n'a échoué.

Options disponibles:
,
SIGNATURE_INVALID,
SIGNATURE_UNSUPPORTED_SCHEME,
DEPOSIT_NOT_FOUND,
DEPOSIT_UNCONFIRMED,
DEPOSIT_LOOKUP_FAILED,
DEPOSIT_MISMATCH,
DEPOSIT_STALE,
TXID_REUSED,
CHAIN_UNSUPPORTED,
WINDOW_EXPIRED,
OWNERSHIP_CHANGED,
METHOD_SWITCHED,
REVIEW_REJECTED,
ABANDONED
Dernière modification le 7 novembre 2026