Verificar transacciones de Midaz con Tracer (API)

Deja que Midaz consulte a Tracer sobre una transacción antes de que se mueva cualquier saldo.

Participantes

Tu institución. Tu sistema crea, confirma y cancela las transacciones en Midaz.
Midaz. El ledger. Consulta a Tracer antes de mover cualquier saldo y confirma o libera la capacidad que Tracer reserva.
Tracer. Evalúa tus reglas activas, reserva capacidad en tus límites de gasto y devuelve la decisión a Midaz.

Antes de empezar

Midaz está conectado a Tracer en tu entorno.
El modo de Tracer en la configuración de tu ledger es advisory o enforce. El valor predeterminado es off. Cámbialo con PATCH /v2/organizations/{organization_id}/ledgers/{ledger_id}/settings. Consulta la configuración del ledger.
Tus reglas y tus límites de gasto están en ACTIVE en Tracer. Consulta Configurar reglas y límites de gasto.

Diagrama

Transacción

#	Origen	Destino	Mensaje	API de Lerian	Qué ocurre
1	Tu institución	Midaz	API de Lerian	`POST /v2/transactions/direct`	Crea la transacción.
2	Midaz	Tracer	Llamada interna		Antes de que se mueva cualquier saldo, Midaz le pide a Tracer que verifique la transacción y reserve capacidad en tus límites de gasto.
3	Tracer	Tracer	Paso interno		Tracer evalúa tus reglas activas. Si las reglas no deciden `DENY` o `REVIEW`, Tracer verifica tus límites de gasto y reserva el monto en los límites que cuentan uso.
4	Tracer	Midaz	Llamada interna		Tracer responde `ALLOW`, `DENY` o `REVIEW`.
5	Midaz	Midaz	Paso interno		En el modo `enforce`, Midaz rechaza un `DENY` o un `REVIEW`, y ningún saldo se mueve. Si no, Midaz aplica los débitos y los créditos.
6	Midaz	Tracer	Llamada interna		Después de que se mueven los saldos, Midaz confirma la capacidad reservada.
7	Midaz	Tu institución	API de Lerian	Respuesta al paso 1	Midaz devuelve la transacción con `201`, o el rechazo.

Transacción pendiente

#	Origen	Destino	Mensaje	API de Lerian	Qué ocurre
1	Tu institución	Midaz	API de Lerian	`POST /v2/transactions/hold`	Crea una transacción pendiente.
2	Midaz	Tracer	Llamada interna		Midaz le pide a Tracer que verifique la transacción y reserve capacidad para ella.
3	Tracer	Midaz	Llamada interna		Tracer responde `ALLOW`, `DENY` o `REVIEW`.
4	Midaz	Tu institución	API de Lerian	Respuesta al paso 1	Midaz devuelve la transacción pendiente con `201`, o el rechazo.
5	Tu institución	Midaz	API de Lerian	`POST /v2/organizations/{organization_id}/ledgers/{ledger_id}/transactions/{transaction_id}/commit` o `POST /v2/organizations/{organization_id}/ledgers/{ledger_id}/transactions/{transaction_id}/cancel`	Confirma la transacción pendiente o cancélala.
6	Midaz	Tracer	Llamada interna		En una confirmación, Midaz confirma la capacidad reservada. En una cancelación, Midaz la libera.
7	Midaz	Tu institución	API de Lerian	Respuesta al paso 5	Midaz devuelve la transacción confirmada o cancelada.

Cómo saber que terminó

Midaz devolvió la transacción, o la transacción pendiente confirmada o cancelada.

Reglas

Las rutas de transacción v1 no llaman a Tracer.
En el modo advisory, Midaz llama a Tracer y nunca bloquea la transacción.
En el modo enforce, cuando Tracer no responde a tiempo, tracer.failPosture decide. Con open, el valor predeterminado, la transacción sigue sin la verificación. Con closed, Midaz la rechaza.
Cuando ninguna regla coincide, Tracer no aplica la decisión predeterminada en este camino.
Tracer verifica la cuenta del primer origen de la transacción, con su segmento y su portafolio. El monto incluye las comisiones.
Tracer recibe solo valores de metadatos escalares, como texto. Compáralos como strings en las reglas de este camino.
Una reversión cuenta en tus límites de gasto. Tracer no le aplica tus reglas.
Si una confirmación o una liberación no llega a Tracer, el resultado de la transacción no cambia.
Una solicitud puede omitir la verificación de Tracer con skip.tracer solo cuando la configuración del ledger overrides.allowTracerSkip es true.

Qué puede salir mal

Los códigos 0177, 0531, 0532, 0535 y 0178 vienen solo de un ledger en el modo enforce.

Situación	Qué ves	Qué hacer
Se excede un límite.	`422`, código `0177`.	Nada se movió. Reduce el monto o espera a que se reinicie el periodo del límite.
Una regla deniega.	`422`, código `0535`.	Nada se movió. Revisa la regla que coincidió.
Una regla pide revisión, o Tracer no puede evaluar una regla.	`422`, código `0531`.	Nada se movió. Atiende el caso en tu proceso de revisión.
Tracer rechaza la solicitud.	`422`, código `0532`.	Nada se movió. Verifica el activo, el tipo de cuenta y la fecha de la transacción.
Tracer no responde, y la postura es `closed`.	`503`, código `0178`.	Nada se movió. Envía la transacción de nuevo más tarde.
El ledger no permite omitir la verificación.	`422`, código `0490`.	Quita `skip.tracer` o permite omitir la verificación en la configuración del ledger.
Midaz no responde a tiempo.	Ninguna respuesta.	El resultado no se conoce. Envía la misma solicitud con la misma clave `X-Idempotency` antes de que la clave expire.

La lista de errores de Midaz describe cada código.

Resumen

Midaz

Tracer

Reporter

Verificar transacciones de Midaz con Tracer (API)

Participantes

Antes de empezar

Diagrama

Transacción

Transacción pendiente

Cómo saber que terminó

Reglas

Qué puede salir mal

Relacionados

​Participantes

​Antes de empezar

​Diagrama

​Transacción

​Transacción pendiente

​Cómo saber que terminó

​Reglas

​Qué puede salir mal

​Relacionados

Participantes

Antes de empezar

Diagrama

Transacción

Transacción pendiente

Cómo saber que terminó

Reglas

Qué puede salir mal

Relacionados