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

La dirección de la wallet de destino. El Didit Test VASP envía a ella, y se compara con tu libreta de direcciones de wallets en la cadena del activo. Una wallet sin entrada coincidente se acepta y la transacción entrante se registra como ON_HOLD.

scenario
enum<string>
predeterminado:accept

Lo que el Didit Test VASP declara como beneficiario. accept declara el nombre del propio titular; name_mismatch declara un nombre que no coincide con ningún titular. La decisión siempre es tuya.

Opciones disponibles:
accept,
name_mismatch
chain
string
predeterminado:ETH

Cadena del activo.

amount
string
predeterminado:1

Importe como cadena decimal.

currency
string
predeterminado:ETH

Código del activo.

reference
string

Clave de idempotencia opcional. Una repetición con el mismo valor devuelve la transferencia que registró la primera llamada.

Respuesta

La transferencia entrante se registró y se decidió. Una repetición con la misma reference devuelve el mismo cuerpo.

transaction_id
string<uuid>

UUID de transacción de Didit de la transferencia entrante.

txn_id
string

txn_id generado por Didit.

scenario
string

El escenario que se ejecutó.

travel_rule_status
string

El estado en el que se resolvió la decisión propia de tu aplicación.

detail
string

Por qué la transferencia se resolvió con ese estado.

test_vasp
boolean

Siempre true: el remitente fue el Didit Test VASP.

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