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

Cadena en la que se liquidó el depósito, por ejemplo ETH. Se almacena en minúsculas y se compara sin distinguir mayúsculas y minúsculas con las entradas de tu libreta de direcciones de wallets, así que usa allí el mismo token de cadena.

Maximum string length: 32
txid
string
requerido

Hash de la transacción on-chain. Se deduplica junto con wallet_address.

Maximum string length: 128
wallet_address
string
requerido

La wallet de destino en la que recibiste el depósito. Una X-address de XRP se divide en su dirección clásica y su etiqueta.

Maximum string length: 128
amount
string
requerido

Importe del depósito como cadena decimal, igual o mayor que cero, con hasta 18 decimales.

currency
string
requerido

Activo del depósito, p. ej., "USDC".

Maximum string length: 16
originator_data
object

Datos del ordenante proporcionados por el VASP emisor, si se conocen, como un objeto plano, por ejemplo {"name": "..."}. Didit lee de él name (o full_name), first_name, last_name y vendor_data.

beneficiary_data
object

Datos del beneficiario (tu cliente), como un objeto plano, por ejemplo {"name": "..."}. Didit compara name con el holder_name de la entrada coincidente de la libreta de direcciones y establece wallet_address y chain a partir de la solicitud.

originating_vasp
object

Descripción opcional del VASP emisor. Solo se conserva en esta transferencia (metadata.originating_vasp y el VASP ordenante de la transferencia en GET /v3/travel-rule/transfers/); nunca crea, edita ni vincula una entrada del directorio compartido de VASP.

memo
string

Opcional. La etiqueta de destino o memo del depósito en una red con memo: en una dirección de depósito compartida, es lo que distingue a tus clientes, y se busca la coincidencia con la entrada de la libreta de direcciones para ese memo. 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 incluye uno, se devuelve un 400. Alias: destinationTag o destination_tag.

Maximum string length: 256
utxo
object

Opcional, solo para cadenas UTXO. Las entradas y salidas de la transacción de depósito: la wallet del remitente es la declarada en originator_data.wallet_address o, si no, la entrada de mayor importe.

Respuesta

Ya se había registrado una transferencia para este txid y wallet_address; se devuelve la existente sin cambios (created es false).

transaction_id
string<uuid>

UUID de transacción de Didit del depósito entrante.

txn_id
string

txn_id de la transacción entrante: generado por Didit cuando Didit creó la transacción, o el tuyo propio cuando se reutilizó un depósito no reclamado.

created
boolean

true cuando esta llamada registró la transferencia (HTTP 201); false cuando ya existía una transferencia con el mismo txid y wallet_address (HTTP 200).

travel_rule
object

Objeto de transferencia completo que devuelven los endpoints de confirmación de propiedad y de finalizar/cancelar. Mientras la propiedad de la wallet de una transferencia entrante no esté confirmada, los originator_data y beneficiary_data de la contraparte se devuelven enmascarados (se conserva la primera letra de cada palabra; la wallet, la cadena y el enrutamiento del VASP siguen siendo legibles) y data_masked es true.

Última modificación el 1 de noviembre de 2026