Verificar transações do Midaz com o Tracer (API)

O Midaz consulta o Tracer sobre uma transação antes que qualquer saldo se mova. O Tracer reserva capacidade de limite, e o Midaz a confirma ou a libera.

Deixe o Midaz consultar o Tracer sobre uma transação antes que qualquer saldo se mova.

​

Participantes

---

• Sua instituição. Seu sistema cria, confirma e cancela as transações no Midaz.
• Midaz. O ledger. Ele consulta o Tracer antes de mover qualquer saldo e confirma ou libera a capacidade que o Tracer reserva.
• Tracer. Avalia suas regras ativas, reserva capacidade nos seus limites de gastos e devolve a decisão ao Midaz.

​

Antes de começar

---

• O Midaz está conectado ao Tracer no seu ambiente.
• O modo do Tracer nas configurações do seu ledger é advisory ou enforce. O padrão é off. Altere o modo com PATCH /v2/organizations/{organization_id}/ledgers/{ledger_id}/settings. Veja as configurações do ledger.
• Suas regras e seus limites de gastos estão em ACTIVE no Tracer. Veja Configurar regras e limites de gastos.

​

Diagrama

---

​

Transação

#	Origem	Destino	Mensagem	API da Lerian	O que acontece
1	Sua instituição	Midaz	API da Lerian	POST /v2/transactions/direct	Crie a transação.
2	Midaz	Tracer	Chamada interna		Antes que qualquer saldo se mova, o Midaz pede ao Tracer que verifique a transação e reserve capacidade nos seus limites de gastos.
3	Tracer	Tracer	Etapa interna		O Tracer avalia suas regras ativas. Se as regras não decidirem DENY ou REVIEW, o Tracer verifica seus limites de gastos e reserva o valor nos limites que contam uso.
4	Tracer	Midaz	Chamada interna		O Tracer responde ALLOW, DENY ou REVIEW.
5	Midaz	Midaz	Etapa interna		No modo enforce, o Midaz rejeita um DENY ou um REVIEW, e nenhum saldo se move. Caso contrário, o Midaz aplica os débitos e os créditos.
6	Midaz	Tracer	Chamada interna		Depois que os saldos se movem, o Midaz confirma a capacidade reservada.
7	Midaz	Sua instituição	API da Lerian	Resposta ao passo 1	O Midaz devolve a transação com 201, ou a rejeição.

​

Transação pendente

#	Origem	Destino	Mensagem	API da Lerian	O que acontece
1	Sua instituição	Midaz	API da Lerian	POST /v2/transactions/hold	Crie uma transação pendente.
2	Midaz	Tracer	Chamada interna		O Midaz pede ao Tracer que verifique a transação e reserve capacidade para ela.
3	Tracer	Midaz	Chamada interna		O Tracer responde ALLOW, DENY ou REVIEW.
4	Midaz	Sua instituição	API da Lerian	Resposta ao passo 1	O Midaz devolve a transação pendente com 201, ou a rejeição.
5	Sua instituição	Midaz	API da Lerian	POST /v2/organizations/{organization_id}/ledgers/{ledger_id}/transactions/{transaction_id}/commit ou POST /v2/organizations/{organization_id}/ledgers/{ledger_id}/transactions/{transaction_id}/cancel	Confirme a transação pendente ou cancele a transação.
6	Midaz	Tracer	Chamada interna		Em uma confirmação, o Midaz confirma a capacidade reservada. Em um cancelamento, o Midaz libera a capacidade.
7	Midaz	Sua instituição	API da Lerian	Resposta ao passo 5	O Midaz devolve a transação confirmada ou cancelada.

​

Como saber que terminou

---

O Midaz devolveu a transação, ou a transação pendente confirmada ou cancelada.

​

Regras

---

• As rotas de transação v1 não chamam o Tracer. Em um ledger no modo enforce, o Ledger HTTP v1 recusa com 0574 uma transação que movimenta saldos.
• No modo advisory, o Midaz chama o Tracer e nunca bloqueia a transação.
• No modo enforce, quando o Tracer não responde a tempo, tracer.failPosture decide. Com open, a transação segue sem a verificação. Com closed, o Midaz rejeita a transação.
• Quando nenhuma regra casa, o Tracer não aplica a decisão padrão neste caminho.
• O Tracer registra cada decisão como uma validação com o transactionId da transação. Encontre-a com GET /v1/validations e transaction_id. Para ler as retenções de limite da transação, chame GET /v1/validations/{validation_id}/reservations.
• O Tracer verifica as contas de origem que o Midaz envia, cada uma com o segmento, o portfólio e o valor que sai dela, e para no primeiro DENY. O valor inclui as tarifas. Uma origem que o Tracer recusa recusa a transação inteira. A validação de uma transação com mais de uma origem lista o resultado de cada origem em sources.
• O Tracer recebe apenas valores de metadados escalares, como texto. Compare esses valores como strings nas regras deste caminho.
• Um estorno conta nos seus limites de gastos. O Tracer não aplica suas regras a ele.
• Se uma confirmação ou uma liberação não chega ao Tracer, o resultado da transação não muda.
• Uma requisição pode pular a verificação do Tracer com skip.tracer apenas quando a configuração do ledger overrides.allowTracerSkip é true.

​

O que pode dar errado

---

Os códigos 0177, 0531, 0532, 0535 e 0178 vêm apenas de um ledger no modo enforce.

Situação	O que você vê	O que fazer
Um limite é excedido.	422, código 0177.	Nada se moveu. Reduza o valor ou espere o período do limite reiniciar.
Uma regra nega.	422, código 0535.	Nada se moveu. Revise a regra que casou.
Uma regra pede revisão, ou o Tracer não consegue avaliar uma regra.	422, código 0531.	Nada se moveu. Trate o caso no seu processo de revisão.
O Tracer recusa a requisição.	422, código 0532.	Nada se moveu. Confira o ativo, o tipo de conta e a data da transação.
O Tracer não responde, e a postura é closed.	503, código 0178.	Nada se moveu. Envie a transação de novo mais tarde.
O ledger não permite pular a verificação.	422, código 0490.	Remova skip.tracer ou permita pular a verificação nas configurações do ledger.
O Midaz não responde a tempo.	Nenhuma resposta.	O resultado não é conhecido. Envie a mesma requisição com a mesma chave X-Idempotency antes que a chave expire.

A lista de erros do Midaz descreve cada código.

​

Relacionados

---

• Validar uma transação antes do ledger
• Investigar uma decisão na trilha de auditoria
• Guia de integração do Tracer