Saltar al contenido principal
PUT
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

Todos los campos son opcionales; PUT aplica una actualización parcial.

is_enabled
boolean
Maximum string length: 255
lei
string
Maximum string length: 20
jurisdiction
string
Maximum string length: 8
name_matching_strictness
enum<string>

CONTAINS acepta un nombre cuyas palabras aparecen todas en el otro.

Opciones disponibles:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer
Rango requerido: x >= 1
timeout_outcome
enum<string>
Opciones disponibles:
HOLD,
REJECT,
PROCEED
compliance_email
string<email>

Correo electrónico de contacto de cumplimiento de tu perfil de VASP. La red de Didit solo publica tu perfil cuando se confirma esta dirección mediante un enlace enviado por correo electrónico (POST /v3/travel-rule/settings/compliance-email/confirmation/). Si la cambias, necesitas una nueva confirmación.

is_discoverable
boolean

Indica si tu perfil de VASP puede figurar en la red de Didit: otros clientes de Didit lo encuentran en GET /v3/travel-rule/vasps/ y pueden contactarlo por la vía INTERNAL. Para figurar también se necesita una aplicación en producción, Travel Rule activado, una razón social y un correo electrónico de cumplimiento confirmado; didit_network indica cuáles faltan. Valor predeterminado: true.

threshold_amount
string

Cadena decimal, cero o mayor, en la moneda predeterminada de tu aplicación. Importe mínimo de transferencia que dispara un intercambio gestionado.

ownership_validation_mode
enum<string>

Consulta el campo de la respuesta con el mismo nombre.

Opciones disponibles:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

Cadena decimal, 0 o mayor.

data_sharing_fields
object

Se combina por tipo de entidad: un tipo de entidad que omitas conserva su elección actual. Una elección que no pueda cumplir las obligaciones del ordenante del régimen de tu jurisdiction (TFR de la UE o Recomendación 16 del GAFI), incluida una lista vacía, se rechaza con 400.

matching_rules
object

Se combina por tipo de entidad y, dentro de cada uno, por campo. Un campo que ese tipo de entidad no compara (por ejemplo, date_of_birth para company) se rechaza con 400.

inbound_auto_accept
boolean
allow_self_declaration
boolean
allow_screenshot_proof
boolean

Si es true, el widget de propiedad de wallet ofrece la carga de capturas de pantalla como método de evidencia de propiedad. Valor predeterminado: true.

auto_wallet_verification
boolean
vasp_attribution_enabled
boolean
counterparty_screening_enabled
boolean

Análisis opcional de sanciones y medios adversos de los VASP contraparte, facturado por análisis al precio del Análisis AML de empresas. Cuando está activado, Didit analiza la contraparte a la que llega un intercambio saliente (reutilizando un análisis de menos de 30 días) y puedes analizar una con POST /v3/travel-rule/vasps/{vasp_id}/screening/. Valor predeterminado false: no se analiza ni se factura nada.

sunrise_policy
enum<string>

HOLD, REJECT, PROCEED o vacío para seguir timeout_outcome. Consulta el campo de respuesta con el mismo nombre.

Opciones disponibles:
,
HOLD,
REJECT,
PROCEED
non_responsive_policy
enum<string>

HOLD, REJECT, PROCEED o vacío para seguir timeout_outcome. Consulta el campo de respuesta con el mismo nombre.

Opciones disponibles:
,
HOLD,
REJECT,
PROCEED
disabled_networks
enum<string>[]

Redes excluidas de la membresía de la plataforma. No desactiva tus propias membresías conectadas ni habilita redes no disponibles.

Opciones disponibles:
GTR,
TRUST,
VERIFYVASP,
SYGNA

Respuesta

Configuración y perfil actualizados, con la misma estructura que GET.

is_enabled
boolean

Si el flujo gestionado de negociación de Travel Rule está activo para las transacciones travelRule salientes de esta aplicación.

jurisdiction
string

Código de la jurisdicción en la que opera tu VASP. Valor predeterminado: "EU". Didit lo asigna al régimen que registra en tus transacciones de Travel Rule como travel_rule_regime (por ejemplo, EU o el código de un Estado miembro de la UE se convierte en eu), en el que pueden basarse las reglas de transacción. Los demás clientes de Didit lo ven como tu jurisdicción en el directorio de VASP una vez que la red de Didit incluye tu perfil.

Maximum string length: 8
name_matching_strictness
enum<string>

Con qué rigor deben coincidir los nombres de los beneficiarios antes de que una transferencia pueda llegar a COMPLETED. CONTAINS acepta un nombre cuyas palabras aparezcan todas en el otro.

Opciones disponibles:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer

Horas que una transferencia AWAITING_COUNTERPARTY puede permanecer sin confirmar antes de que el proceso de limpieza periódico la expire. Valor predeterminado: 48.

Rango requerido: x >= 1
timeout_outcome
enum<string>

Qué ocurre con la transacción subyacente cuando una transferencia expira. Valor predeterminado: HOLD. sunrise_policy y non_responsive_policy tienen prioridad cuando son aplicables y están configuradas.

Opciones disponibles:
HOLD,
REJECT,
PROCEED
threshold_amount
string

Cadena decimal, en la moneda predeterminada de tu aplicación. Importe mínimo de transferencia que dispara un intercambio gestionado; las transferencias inferiores se resuelven directamente como NOT_APPLICABLE. Didit compara el importe de la transacción convertido a tu moneda predeterminada, o el amount_in_default_currency que envíes; cuando no hay un importe convertido disponible, el umbral no se aplica. Valor predeterminado: "0.00" (el TFR de la UE no aplica ningún importe mínimo).

ownership_validation_mode
enum<string>

Cuánta prueba requiere la propiedad de una wallet. FULL siempre necesita una prueba (mensaje firmado, depósito de prueba o captura de pantalla revisada), nunca la palabra del usuario final. SIMPLIFIED acepta una autodeclaración por debajo de simplified_validation_threshold y una prueba por encima. AUTOMATED permite que la libreta de direcciones y las pruebas anteriores respondan por sí solas, incluidas las autodeclaraciones mientras allow_self_declaration sea true. Valor predeterminado: AUTOMATED.

Opciones disponibles:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

Cadena decimal, valor predeterminado "0.00". En el modo SIMPLIFIED, una transferencia inferior a este importe (en la moneda del umbral) acepta una autodeclaración. Una transferencia sin importe en esa moneda se considera superior a él.

data_sharing_fields
object

Los campos que Didit envía a la VASP contraparte sobre tus propios usuarios, por tipo de entidad. El name y la wallet_address se envían siempre, diga lo que diga la lista. Un tipo de entidad que nunca elegiste comparte todos los campos. Una lista vacía también es una elección: solo comparte el nombre y la wallet.

matching_rules
object

Con qué rigor se compara cada campo de los datos de la contraparte con los que tienes, por tipo de entidad. Un campo que omitas conserva su valor predeterminado. NONE omite la comparación, STRICT exige exactamente las mismas palabras, CONTAINS acepta un valor cuyas palabras aparezcan todas en el otro, DEFAULT es la coincidencia estándar por subconjunto y FUZZY acepta grafías parecidas (y, en las fechas de nacimiento, el día y el mes intercambiados).

Nombre legal de tu VASP. Es obligatorio (no puede estar vacío) para establecer is_enabled en true.

lei
string

Tu identificador de entidad jurídica (LEI), que se muestra en el directorio de VASP.

compliance_email
string<email>

Correo electrónico de contacto de cumplimiento de tu perfil de VASP. La red de Didit solo publica tu perfil cuando se confirma esta dirección mediante un enlace enviado por correo electrónico (POST /v3/travel-rule/settings/compliance-email/confirmation/). Si la cambias, necesitas una nueva confirmación.

is_discoverable
boolean

Indica si tu perfil de VASP puede figurar en la red de Didit: otros clientes de Didit lo encuentran en GET /v3/travel-rule/vasps/ y pueden contactarlo por la vía INTERNAL. Para figurar también se necesita una aplicación en producción, Travel Rule activado, una razón social y un correo electrónico de cumplimiento confirmado; didit_network indica cuáles faltan. Valor predeterminado: true.

inbound_auto_accept
boolean

Si es true, una consulta TRP entrante cuya wallet beneficiaria es una entrada verificada de la libreta de direcciones con un nombre coincidente se aprueba automáticamente. Si es false, esa consulta espera en ON_HOLD hasta que la apruebes o la deniegues con el endpoint de propiedad. Las transferencias por el rail INTERNAL y las posteriores al depósito no se ven afectadas. Valor predeterminado: true.

allow_self_declaration
boolean

Si es true, el widget de propiedad de wallet ofrece la autodeclaración como método de prueba alternativo. Valor predeterminado: true.

allow_screenshot_proof
boolean

Si es true, el widget de propiedad de wallet ofrece la carga de capturas de pantalla como método de evidencia de propiedad. Valor predeterminado: true.

auto_wallet_verification
boolean

Si es true, al enviar una transferencia saliente de Travel Rule que requiere que el usuario final demuestre el control de la wallet, se crea automáticamente una sesión del widget de propiedad de wallet vinculada a la transacción y se expone en el bloque action_required de la transacción. Valor predeterminado: true.

vasp_attribution_enabled
boolean

Si es true, una transferencia saliente de Travel Rule que ningún rail puede enrutar se atribuye mediante análisis de blockchain: la wallet de destino se asocia al VASP que la posee, la entidad se registra en la transferencia y en el directorio de VASP, y los rails se vuelven a ejecutar una vez con el nombre atribuido. Valor predeterminado: true.

counterparty_screening_enabled
boolean

Análisis opcional de sanciones y medios adversos de los VASP contraparte, facturado por análisis al precio del Análisis AML de empresas. Cuando está activado, Didit analiza la contraparte a la que llega un intercambio saliente (reutilizando un análisis de menos de 30 días) y puedes analizar una con POST /v3/travel-rule/vasps/{vasp_id}/screening/. Valor predeterminado false: no se analiza ni se factura nada.

sunrise_policy
enum<string>

Qué efecto tiene una transferencia expirada en su transacción cuando la contraparte es una entrada del directorio en una jurisdicción incluida en sunrise_jurisdictions, que aún no aplica la Travel Rule: HOLD la envía a revisión, REJECT la rechaza y PROCEED deja su estado sin cambios. Vacío (el valor por defecto) sigue timeout_outcome. Se aplica antes que non_responsive_policy.

Opciones disponibles:
,
HOLD,
REJECT,
PROCEED
sunrise_jurisdictions
string[]
read-only

Solo lectura. Los países (ISO 3166 alfa-2) que Didit considera en periodo de transición (sunrise) de la Travel Rule, donde se aplica sunrise_policy. Actualmente, CO, KH y VN. Cualquier otra jurisdicción, así como una vacía o desconocida, sigue timeout_outcome.

non_responsive_policy
enum<string>

Qué efecto tiene una transferencia expirada en su transacción cuando la contraparte es una entrada del directorio cuya capacidad de respuesta es UNRESPONSIVE: HOLD, REJECT o PROCEED, igual que en timeout_outcome. Vacío (el valor por defecto) sigue timeout_outcome. sunrise_policy se aplica primero cuando ambas corresponden.

Opciones disponibles:
,
HOLD,
REJECT,
PROCEED
travel_address
string

Solo lectura. La travel address propia de tu VASP: el endpoint codificado de consultas TRP entrantes que otros VASP usan para contactarte. Está vacía mientras is_enabled sea false.

disabled_networks
enum<string>[]

Redes excluidas de la membresía de la plataforma. No desactiva tus propias membresías conectadas ni habilita redes no disponibles.

Opciones disponibles:
GTR,
TRUST,
VERIFYVASP,
SYGNA
networks
object
read-only

Por cada red, cómo enviaría esta aplicación y por qué no puede hacerlo. Ninguna red, incluida GTR, se incluye de forma predeterminada: una red es accesible a través de tu propia membresía conectada, o a través de la membresía de Didit una vez que la membresía de Didit en esa red esté activa y tu propio participante en ella esté activo. No es una comprobación en tiempo real del estado ni de la entrega.

didit_network
object
read-only

Si la red de Didit incluye tu perfil de VASP, de modo que otros clientes de Didit lo encuentren en el directorio y lo contacten por la vía INTERNAL, y cada condición que aún no cumple.

Última modificación el 1 de noviembre de 2026