Saltar al contingut principal
POST
curl

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Cos

application/json
chain
string
requerit

Cadena en què s'ha liquidat el dipòsit, per exemple ETH. S'emmagatzema en minúscules i es compara sense distingir majúscules de minúscules amb les entrades de la llibreta d'adreces de carteres, així que fes servir el mateix token de cadena allà.

Maximum string length: 32
txid
string
requerit

Hash de la transacció on-chain. Desduplicat juntament amb wallet_address.

Maximum string length: 128
wallet_address
string
requerit

La cartera de destinació on has rebut el dipòsit. Una X-address d'XRP es divideix en la seva adreça clàssica i l'etiqueta.

Maximum string length: 128
amount
string
requerit

Import del dipòsit com a cadena decimal, zero o superior, amb fins a 18 xifres decimals.

currency
string
requerit

Actiu del dipòsit, p. ex. "USDC".

Maximum string length: 16
originator_data
object

Detalls de l'ordenant proporcionats pel VASP emissor, si es coneixen, com a objecte pla com ara {"name": "..."}. Didit en llegeix name (o full_name), first_name, last_name i vendor_data.

beneficiary_data
object

Detalls del beneficiari (el teu client), com a objecte pla com ara {"name": "..."}. Didit compara el nom amb el holder_name de l'entrada coincident de la llibreta d'adreces, i estableix wallet_address i chain a partir de la sol·licitud.

originating_vasp
object

Descripció opcional del VASP emissor. Es manté només en aquesta transferència (metadata.originating_vasp, i el VASP ordenant de la transferència a GET /v3/travel-rule/transfers/); mai crea, edita ni enllaça una entrada compartida del directori de VASP.

memo
string

Opcional. L'etiqueta de destinació o memo del dipòsit en una xarxa basada en memos: en una adreça de dipòsit compartida és el que permet distingir els teus clients, i es fa coincidir l'entrada de la llibreta d'adreces corresponent a aquest memo. XRP: una etiqueta de destinació, un nombre enter de 0 a 4294967295 (s'accepta un número JSON). XLM: un memo de text de fins a 28 bytes, un ID de 64 bits o un hash de 32 bytes en hex. EOS: fins a 256 bytes. ATOM: fins a 256 caràcters. HBAR: fins a 100 bytes. Les carteres de Bitcoin, EVM, Solana, Tron, Litecoin, Bitcoin Cash, Dogecoin i Lightning no admeten memo: incloure'n un retorna un 400. Àlies: destinationTag o destination_tag.

Maximum string length: 256
utxo
object

Opcional, només per a cadenes UTXO. Les entrades i sortides de la transacció de dipòsit: la cartera del remitent és la declarada a originator_data.wallet_address; en cas contrari, l'entrada més gran.

Resposta

Ja s'havia registrat una transferència per a aquest txid i wallet_address; es retorna l'existent sense canvis (created és false).

transaction_id
string<uuid>

UUID de transacció de Didit per al dipòsit entrant.

txn_id
string

txn_id de la transacció entrant: generat per Didit quan Didit ha creat la transacció, o el teu propi quan s'ha reutilitzat un dipòsit no reclamat.

created
boolean

true quan aquesta crida ha registrat la transferència (HTTP 201); false quan ja existia una transferència per al mateix txid i wallet_address (HTTP 200).

travel_rule
object

Objecte de transferència complet retornat pels endpoints de confirmació de titularitat i de finalització/cancel·lació. Mentre la titularitat de la cartera d'una transferència entrant no estigui confirmada, els camps originator_data i beneficiary_data de la contrapart es retornen emmascarats (es manté la primera lletra de cada paraula; la cartera, la cadena i l'encaminament del VASP continuen sent llegibles) i data_masked és true.

Darrera modificació el 7 de novembre del 2026