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
beneficiary_wallet_address
string
requerit

L'adreça de destinació. El Didit Test VASP hi fa l'enviament, contrastada amb la teva llibreta d'adreces a la blockchain de l'actiu. Una cartera sense cap entrada coincident s'accepta i la transacció entrant es registra com a ON_HOLD.

scenario
enum<string>
predeterminat:accept

Què declara el Didit Test VASP que és el beneficiari. accept declara el nom del mateix titular; name_mismatch declara un nom amb el qual cap titular està d'acord. La decisió en si sempre és teva.

Opcions disponibles:
accept,
name_mismatch
chain
string
predeterminat:ETH

Cadena de l'actiu.

amount
string
predeterminat:1

Import com a cadena decimal.

currency
string
predeterminat:ETH

Codi de l'actiu.

reference
string

Clau d'idempotència opcional. Si es repeteix amb el mateix valor, retorna la transferència que la primera crida va registrar.

Resposta

La transferència entrant s'ha registrat i s'ha pres una decisió. Si es repeteix amb la mateixa reference, es retorna el mateix cos.

transaction_id
string<uuid>

UUID de transacció de Didit de la transferència entrant.

txn_id
string

txn_id generat per Didit.

scenario
string

L'escenari que s'ha executat.

travel_rule_status
string

L'estat en què s'ha resolt la decisió de la teva aplicació.

detail
string

Per què la transferència s'ha resolt amb aquest estat.

test_vasp
boolean

Sempre true: el remitent ha estat el VASP de proves de Didit.

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