Saltar al contenido principal
POST
curl

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Cuerpo

application/json
address
string
requerido

La dirección de la wallet. Una X-address de XRP se almacena como su dirección clásica y su tag, por lo que coincide con las transferencias que indiquen cualquiera de las dos formas.

Maximum string length: 128
chain
string

Token de cadena de la dirección, por ejemplo ETH o BTC. Cuando Didit enruta o registra una transferencia, busca coincidencias en las entradas de la libreta de direcciones por la dirección de la wallet y, cuando la transferencia incluye una cadena, también por este valor, sin distinguir mayúsculas de minúsculas. La cadena de una transferencia es beneficiary_data.chain, que se rellena a partir de la cadena cripto o del símbolo de la moneda de la transacción (por ejemplo ETH) cuando no la envías, o el chain de un registro posterior al depósito, así que usa el mismo token en todas partes. Una entrada con la cadena vacía coincide con cualquier cadena. Las cadenas conocidas se almacenan con un único identificador canónico, sea cual sea la grafía que envíes: "ethereum", "Ethereum" y "ERC20" se almacenan como ETH, "BNB Smart Chain" y "BEP20" como BNB, y "tron" como TRX. Un nombre de cadena desconocido se conserva tal como se envía.

Maximum string length: 32
holder_vendor_data
string
Maximum string length: 255
holder_name
string
Maximum string length: 255
entity_type
string
predeterminado:individual
Maximum string length: 16
self_declared
boolean
predeterminado:false

Solo escritura. Si es true, la entrada se crea con la propiedad ya verificada mediante una prueba SELF_DECLARATION. Devuelve 400 cuando allow_self_declaration está desactivado en tu configuración de Travel Rule.

travel_address
string

Opcional. La travel address del VASP de la contraparte para esta wallet, que habilita el enrutamiento TRP para los activos que admite TRP (BTC, ETH y USDC en una red concreta). Una travel address no válida devuelve 400.

Maximum string length: 512
memo
string

Opcional. La etiqueta de destino o memo que forma parte de la wallet. XRP: una etiqueta de destino, un número entero de 0 a 4294967295 (se acepta un número JSON). XLM: un memo de texto de hasta 28 bytes, un id de 64 bits o un hash de 32 bytes en hexadecimal. EOS: hasta 256 bytes. ATOM: hasta 256 caracteres. HBAR: hasta 100 bytes. Las wallets de Bitcoin, EVM, Solana, Tron, Litecoin, Bitcoin Cash, Dogecoin y Lightning no admiten memo: si se envía uno, la respuesta es 400. Alias: destinationTag o destination_tag.

Maximum string length: 256

Respuesta

La entrada creada.

uuid
string<uuid>
address
string

La dirección de la wallet; "" para una entrada importada solo por su hash. Única por aplicación, cadena y memo, comparando la dirección sin distinguir mayúsculas de minúsculas. Después de eliminar una entrada, puedes registrar de nuevo la misma dirección.

chain
string

Token de cadena de la dirección, por ejemplo ETH o BTC. Cuando Didit enruta o registra una transferencia, busca coincidencias en las entradas de la libreta de direcciones por la dirección de la wallet y, cuando la transferencia incluye una cadena, también por este valor, sin distinguir mayúsculas y minúsculas. La cadena de una transferencia es beneficiary_data.chain, que se rellena a partir de la cadena cripto o del símbolo de la moneda de la transacción (por ejemplo ETH) cuando no la envías, o la chain de un registro posterior al depósito, así que usa el mismo token en todas partes. Una entrada con la cadena vacía coincide con cualquier cadena. Un beneficiario de Lightning (un id de nodo o una Lightning Address) registrado en bitcoin se almacena en minúsculas en LIGHTNING, donde se buscan coincidencias para las transferencias de Lightning. Las cadenas conocidas se almacenan con un único identificador canónico, sea cual sea la grafía que envíes: "ethereum", "Ethereum" y "ERC20" se almacenan como ETH, "BNB Smart Chain" y "BEP20" como BNB, y "tron" como TRX. Un nombre de cadena desconocido se conserva tal como se envió.

holder_vendor_data
string

Tu identificador interno del titular.

holder_name
string

Nombre del titular de la wallet, que se usa para la coincidencia del nombre del beneficiario.

entity_type
string

Texto libre; por defecto, "individual".

is_ownership_verified
boolean

Solo lectura. Indica si se ha demostrado la propiedad de esta dirección.

created_at
string<date-time>
travel_address
string

La dirección de viaje (travel address) del VASP de la contraparte para esta wallet, si se conoce. Permite a Didit enrutar las transferencias de este beneficiario por el canal TRP, para los activos que admite TRP (BTC, ETH y USDC en una red concreta).

address_hash
string

Solo lectura. SHA-256 de la dirección en minúsculas, en hexadecimal en minúsculas. Una entrada importada solo por su hash se compara con este valor.

memo
string

La etiqueta de destino o memo que forma parte de la wallet en una red con memo (XRP, XLM, EOS, ATOM, HBAR); "" para la dirección completa. Una entrada con memo solo coincide con transferencias que indican ese memo; una sin memo coincide con toda la dirección.

receiving_travel_address
string
read-only

Tu dirección de viaje específica para esta wallet: dásela al VASP emisor para que su consulta TRP identifique esta wallet. Vacía para una wallet registrada como de otro VASP, mientras Travel Rule está desactivada y antes de que se guarde tu perfil de VASP.

Última modificación el 1 de noviembre de 2026