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
chain
string
requis

Blockchain sur laquelle le dépôt a été réglé, par exemple ETH. Stocké en minuscules et comparé sans distinction de casse avec les entrées de votre carnet d'adresses de portefeuilles, utilisez donc le même token de blockchain ici.

Maximum string length: 32
txid
string
requis

Hash de transaction on-chain. Dédupliqué avec wallet_address.

Maximum string length: 128
wallet_address
string
requis

Le portefeuille de destination sur lequel vous avez reçu le dépôt. Une adresse X XRP est séparée en son adresse classique et son tag.

Maximum string length: 128
amount
string
requis

Montant du dépôt sous forme de chaîne décimale, supérieur ou égal à zéro, avec jusqu'à 18 décimales.

currency
string
requis

Actif de dépôt, par ex. « USDC ».

Maximum string length: 16
originator_data
object

Informations sur le donneur d'ordre transmises par le VASP émetteur, si elles sont connues, sous forme d'objet plat tel que {"name": "..."}. Didit y lit name (ou full_name), first_name, last_name et vendor_data.

beneficiary_data
object

Détails du bénéficiaire (votre client), sous la forme d'un objet plat tel que {"name": "..."}. Didit compare le nom avec le holder_name de l'entrée correspondante du carnet d'adresses, et définit wallet_address et chain à partir de la requête.

originating_vasp
object

Description optionnelle du VASP expéditeur. Elle reste uniquement associée à ce transfert (metadata.originating_vasp, ainsi que le VASP donneur d'ordre du transfert dans GET /v3/travel-rule/transfers/) ; elle ne crée, ne modifie ni ne lie jamais une entrée de l'annuaire partagé des VASP.

memo
string

Optionnel. Le tag de destination ou memo du dépôt sur un réseau à memo : sur une adresse de dépôt partagée, c'est ce qui distingue vos clients, et l'entrée du carnet d'adresses correspondant à ce memo est mise en correspondance. XRP : un tag de destination, un nombre entier de 0 à 4294967295 (un nombre JSON est accepté). XLM : un memo textuel jusqu'à 28 octets, un identifiant 64 bits ou un hachage de 32 octets en hexadécimal. EOS : jusqu'à 256 octets. ATOM : jusqu'à 256 caractères. HBAR : jusqu'à 100 octets. Les portefeuilles Bitcoin, EVM, Solana, Tron, Litecoin, Bitcoin Cash, Dogecoin et Lightning n'acceptent aucun memo : en indiquer un renvoie un 400. Alias : destinationTag ou destination_tag.

Maximum string length: 256
utxo
object

Optionnel, blockchains UTXO uniquement. Les entrées et sorties de la transaction de dépôt : le portefeuille de l'expéditeur est le originator_data.wallet_address déclaré, sinon l'entrée la plus importante.

Réponse

Un transfert pour ce txid et cette adresse était déjà enregistré ; l'existant est renvoyé inchangé (created vaut false).

transaction_id
string<uuid>

UUID de transaction Didit pour le dépôt entrant.

txn_id
string

txn_id de la transaction entrante : généré par Didit lorsque Didit a créé la transaction, ou le vôtre lorsqu'un dépôt non réclamé a été réutilisé.

created
boolean

true lorsque cet appel a enregistré le transfert (HTTP 201) ; false lorsqu'un transfert pour le même txid et la même wallet_address existait déjà (HTTP 200).

travel_rule
object

Objet de transfert complet renvoyé par les endpoints de confirmation d'actionnariat et de finalisation/annulation. Tant que l'actionnariat du portefeuille d'un transfert entrant n'est pas confirmé, les champs originator_data et beneficiary_data de la contrepartie sont renvoyés masqués (la première lettre de chaque mot est conservée ; le portefeuille, la blockchain et le routage VASP restent lisibles) et data_masked est à true.

Dernière modification le 7 novembre 2026