Saltar al contenido principal
GET
curl

Autorizaciones

X-Transaction-Token
string
header
requerido

Token de corta duración y alcance limitado que tu backend genera mediante POST /v3/transactions/sdk-token/. Lo usan los SDK de Didit en los endpoints /v1/transactions/ orientados al dispositivo.

Parámetros de ruta

transaction_id
string<uuid>
requerido

UUID estable de Didit de la transacción (el uuid de la respuesta del envío, no tu txnId).

Respuesta

El detalle completo de la transacción, incluido action_required (null una vez resuelta la acción pendiente).

Registro de monitorización completo de una transacción, tal como lo devuelven GET /v3/transactions/{transaction_id}/ y POST /v3/transactions/.

uuid
string<uuid>

Identificador estable de Didit de la transacción. Úsalo como {transaction_id} en las llamadas posteriores.

environment
enum<string>

Entorno de la aplicación a la que pertenece la transacción. Una transacción de sandbox se almacena, pero nunca se evalúa, analiza, notifica ni factura, por lo que un rule_runs vacío significa "no evaluada".

Opciones disponibles:
live,
sandbox
transaction_number
integer

Número secuencial de transacción dentro de la aplicación que se muestra en la consola (p. ej., 4123).

txn_id
string

El transaction_id que proporcionaste al crearla (máx. 128 caracteres). Único por aplicación.

txn_date
string<date-time>

Cuándo se produjo la transacción (a partir de transaction_at; por defecto, el momento del envío).

zone_id
string | null

Identificador de zona horaria IANA proporcionado al crear.

transaction_type
string

Categoría de nivel superior tal como se almacena: finance, kyc, travelRule, userPlatformEvent, gamblingBet, gamblingLimitChange, gamblingBonusChange, auditTrailEvent. Ten en cuenta que los valores de varias palabras se devuelven en camelCase aunque se envíen en snake_case.

action_type
string

Subtipo dentro de la categoría (p. ej., deposit, withdrawal, transfer). Si no se indica, toma por defecto el valor de la categoría.

direction
enum<string>

Sentido respecto al sujeto. Se almacena en mayúsculas independientemente de cómo se envíe (en la entrada se aceptan in/out/inbound/outbound).

Opciones disponibles:
INBOUND,
OUTBOUND
status
enum<string>

Veredicto de monitorización actual. Las transacciones se crean como APPROVED; las reglas pueden cambiarlas a IN_REVIEW/DECLINED de forma síncrona.

Opciones disponibles:
APPROVED,
IN_REVIEW,
DECLINED,
AWAITING_USER
source
enum<string>

Cómo se originó el registro: LIVE para las transacciones enviadas mediante la API o el SDK, IMPORTED para las transacciones cargadas mediante la importación de la consola.

Opciones disponibles:
LIVE,
IMPORTED
amount
string

Importe de la transacción como cadena decimal sin ceros finales (p. ej., "1500", "0.5", "0.123456789012345678"). Hasta 18 decimales.

currency
string

Código de moneda de amount. Se acepta cualquier código alfabético ISO 4217 (p. ej. EUR, USD, NGN), así como el símbolo de un criptoactivo (p. ej. BTC). Es preferible un código actualmente en circulación. No todos los códigos aceptados tienen tipo de cambio. Cuando no hay ninguno disponible para el código, la conversión automática falla. Es el caso, por ejemplo, de la unidad contable ISO XSU o de un símbolo cripto al que Didit no asigna precio. Entonces preferred_currency_amount se devuelve como null, salvo que la solicitud haya incluido un amount_in_default_currency ya convertido.

currency_type
string | null

fiat o crypto, tal como se envió en currency_kind.

amount_in_default_currency
string | null

Importe ya convertido que proporcionaste, como cadena decimal sin ceros finales.

default_currency_code
string | null
preferred_currency_amount
string | null

amount convertido a la moneda preferida de la aplicación, cuando está disponible.

preferred_currency_code
string | null
payment_details
string | null

Referencia o concepto de pago en texto libre del envío.

payment_txn_id
string | null

Referencia del sistema de pago externo (p. ej., el hash de la transacción en blockchain) procedente de payment_reference_id.

score
integer

Puntuación de riesgo acumulada por las reglas (normalmente de 0 a 100). Cuanto más alta, mayor riesgo.

severity
enum<string> | null

Gravedad categórica del riesgo establecida por reglas o proveedores (UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL). null hasta que algo la establezca.

Opciones disponibles:
UNKNOWN,
LOW,
MEDIUM,
HIGH,
CRITICAL
decision_reason_code
string | null

Motivo legible por máquina del status actual.

decision_reason_label
string | null

Etiqueta legible de decision_reason_code.

vendor_data
string | null

Copia de conveniencia del vendor_data del solicitante.

metadata
object

Instantánea de los payloads subject y counterparty tal como se enviaron en el momento de la creación.

props
object

Las custom_properties que proporcionaste al crearlo. En las condiciones de las reglas, cada clave se referencia como custom_values.<key>.

tags
object[]

Etiquetas asociadas a la transacción (manualmente o mediante reglas).

parties
object[]

Partes de la transacción (solicitante, contraparte).

payment_methods
object[]

Métodos de pago vinculados a la transacción.

documents
object[]

Archivos adjuntados a la transacción desde la consola. [] cuando no hay ninguno.

activities
object[]

Entradas del registro de actividad (creación, notas, revisiones manuales, cambios de estado).

alerts
object[]

Actualmente siempre vacío. Una alerta abierta es una transacción con estado IN_REVIEW o AWAITING_USER.

rule_runs
object[]

Resultados de ejecución por regla: qué regla se activó y con qué impacto en la puntuación.

provider_results
object[]

Payloads sin procesar de los proveedores (análisis AML, analítica de blockchain, etc.).

travel_rule
object | null

Transferencia o comprobación de Travel Rule. Se rellena cuando se envió travel_rule_details, y también cuando Travel Rule está habilitada y la transacción se creó con transaction_category: travelRule (Didit inicia el intercambio por sí mismo, incluso sin travel_rule_details). null cuando no existe ninguna transferencia ni comprobación. En una transferencia entrante, los originator_data y beneficiary_data de la contraparte permanecen enmascarados (data_masked: true) hasta que se confirma la propiedad de la wallet.

network_snapshot
object | null

Instantánea del grafo de transacciones/partes relacionadas que usa el motor de reglas. Es el network_snapshot enviado con la transacción o el grafo que Didit construye a partir de un análisis AML de wallet exitoso (que reemplaza al enviado). null cuando no existe ninguno.

remediation
object | null

Sesión de corrección que se ofrece al usuario cuando se requiere una reverificación. Ha sido reemplazada por action_required, que es el bloque canónico; se mantiene por compatibilidad con versiones anteriores.

action_required
Verification session · object

Acción pendiente del usuario final necesaria para completar esta transacción, o null cuando no hay ninguna. Los SDK de Didit abren la acción automáticamente de forma predeterminada y actualizan la transacción cuando termina. Hay dos variantes, que se distinguen por type: verification_session (una sesión de verificación alojada creada por la acción de una regla) y wallet_ownership (una sesión del widget de propiedad de la wallet generada automáticamente para una transferencia de la Travel Rule que requiere probar el control de la wallet, sujeta a la configuración auto_wallet_verification de la Travel Rule). Cuando ambas podrían aplicarse, wallet_ownership tiene prioridad porque bloquea el intercambio de la Travel Rule.

cost_breakdown
object | null

Coste de esta transacción: total_price e items, uno por cargo, cada uno con usage_type, price, details y created_at. Un nuevo análisis de la misma transacción es un ítem nuevo.

Última modificación el 1 de noviembre de 2026