Saltar al contenido principal
GET
curl

​
Disponibilidad de redes

GTR, TRUST, VerifyVASP y Sygna requieren una membresía activa. Hoy Didit no tiene membresía de plataforma en ninguna de estas redes; Didit está en proceso de onboarding como proveedor. Hasta entonces, un canal de red solo enruta a través de tu propia membresía, conectada en Marketplace. Consulta networks para la aplicación que estás configurando:
  • own - Tu membresía conectada tiene prioridad, incluso si la red está en disabled_networks. Los intercambios usan tu identidad en la red.
  • didit - La membresía de Didit incorpora tu aplicación como participante activo propio en esta red, con el código que la red te asignó. No se necesitan credenciales de membresía del cliente para esta red. Para llegar a este modo se requieren el cuestionario de red de Didit y una solicitud a la red: consulta Obtener redes de Travel Rule. El entorno de producción aún no informa sobre este modo, porque la membresía propia de Didit aún no está activa.
  • off - Desactivaste el enrutamiento de plataforma y no tienes una membresía propia conectada. Quita la red de disabled_networks para permitir el enrutamiento de plataforma cuando esté disponible, o conecta tu propia membresía.
  • unavailable - Todavía no se puede enviar nada por esta red para tu aplicación. state y reason indican el motivo: por ejemplo, didit_onboarding mientras la membresía propia de Didit en la red no está activa, o questionnaire_needed antes de que se apruebe tu cuestionario. Hoy todas las redes informan este modo, salvo que hayas conectado tu propia membresía o desactivado la red. Conecta tu propia membresía en Marketplace, o usa una contraparte INTERNAL, TRP o EMAIL accesible.
disabled_networks solo afecta a la membresía de plataforma de Didit, que aún no está disponible, por lo que hoy no tiene ningún efecto en el enrutamiento. Se elige un canal de red cuando el beneficiary_data de la transferencia incluye el identificador de la contraparte en esa red (por ejemplo, counterparty_gtr_vasp_code o counterparty_trust_membership_id), o cuando la entrada del directorio de la contraparte la incluye con un código en esa red. En GTR, VerifyVASP y Sygna, Didit lee la respuesta de la contraparte a partir de la respuesta de la red o consultando la red cada 5 minutos, y la transferencia pasa a COMPLETED, COUNTERPARTY_MISMATCHED_DATA o COUNTERPARTY_VASP_GENERAL_DECLINE. TRUST solo envía: una transferencia enviada por esta red permanece en AWAITING_COUNTERPARTY hasta que transcurre confirmation_timeout_hours y pasa a EXPIRED; entonces se aplica timeout_outcome. Si el mensaje no se puede entregar, la transferencia pasa en su lugar a COUNTERPARTY_VASP_NOT_REACHABLE. Consulta Redes de Travel Rule para ver qué permite alcanzar cada red hoy. platform_available es un estado de configuración, no una comprobación en tiempo real del estado de la red. connected indica una membresía guardada que superó la validación local de credenciales, no un intercambio correcto con el proveedor. Activar is_enabled o vaciar disabled_networks no puede aprovisionar una membresía que falta. Para las comprobaciones que puedes ejecutar sin credenciales de red, consulta Pruebas sin credenciales de red.

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.

Respuesta

200 - application/json

Configuración actual de Travel Rule y perfil de VASP.

​
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).

​
legal_name
string

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