Operar o Pix Lerian

Opere o Pix Lerian como uma aplicação com estado, lançamentos no Midaz e resultados assíncronos do provedor.

​

Observar a operação, não apenas a resposta HTTP

Uma resposta de criação pode confirmar o trabalho aceito antes de o adaptador de conectividade informar um resultado terminal. Armazene o identificador do recurso, os dados de correlação da requisição e o valor de idempotência. Depois, leia o recurso até seu estado ser terminal.

• Use as leituras de transferência do SPI e as leituras de devolução para fluxos de pagamento.
• Use as leituras de recursos do DICT e do COB retornadas pela referência gerada para os respectivos fluxos.
• Compare o estado final do plugin com o débito, crédito, retenção, liberação ou estorno esperado no Midaz.

Não deduza a liquidação apenas de um envio bem-sucedido.

​

Preservar um comportamento seguro de retry

Mantenha X-Idempotency junto do payload e da resposta da requisição original. Reutilize-o somente para repetir essa requisição. O plugin rejeita uma reutilização divergente, exceto nas duas rotas de criação de cobrança: elas retornam a cobrança imediata ou com vencimento existente. Uma falha de dependência não é um sinal para inventar um estado terminal. Restaure a dependência, preserve a mesma identidade de retry quando o contrato permitir e leia o recurso antes de enviar uma nova requisição de negócio.

​

Tratar conciliação e MED 2.0

O DICT pode bloquear temporariamente mutações selecionadas de chaves e reivindicações enquanto o VSync concilia um escopo. Um 503 desse bloqueio significa que a conciliação está ativa. Inspecione o estado e repita somente depois de o escopo ficar disponível. O cancelamento continua separado das mutações que podem introduzir divergências. As retenções e devoluções do MED 2.0 têm suas próprias transições de estado. Use o guia de SPI e o guia de DICT para determinar se uma retenção deve ser liquidada, compensada, liberada ou revisada. Não transforme overrides operacionais em fluxos normais do cliente.

​

Respeitar o limite de conectividade

O adaptador de conectividade informa o resultado do provedor e chama callbacks internos. Um cliente não deve chamar diretamente rotas de callback, override ou recuperação.

​

Checklist de operação

1. Verifique o escopo da conta autenticada antes de uma gravação.
2. Salve a requisição, o valor de X-Idempotency e o identificador do recurso retornado.
3. Aguarde e observe o resultado assíncrono por meio de uma leitura pública.
4. Verifique o lançamento esperado no Midaz ou o lançamento de compensação.
5. Para um resultado não terminal, leia o estado primeiro. Somente depois siga a ação documentada de retry ou recuperação.

Consulte Integração para os limites do cliente e as convenções de requisição.