Saltar al contenido principal
Opera Pix Lerian como una aplicación con estado, contabilizaciones en Midaz y resultados asíncronos del proveedor.

Observa la operación, no solo la respuesta HTTP

Una respuesta de creación puede confirmar el trabajo aceptado antes de que el adaptador de conectividad comunique un resultado terminal. Guarda el identificador del recurso, los datos de correlación de la solicitud y el valor de idempotencia. Después, lee el recurso hasta que su estado sea terminal.
  • Usa las lecturas de transferencias SPI y las lecturas de devoluciones para los flujos de pago.
  • Usa las lecturas de recursos de DICT y COB que devuelve la referencia generada para sus respectivos flujos.
  • Compara el estado final del plugin con el débito, crédito, retención, liberación o reversión esperados de Midaz.
No deduzcas la liquidación de un envío correcto por sí solo.

Conserva un comportamiento seguro de reintento

Conserva X-Idempotency junto con el payload y la respuesta de la solicitud original. Reutilízalo solo para reintentar esa solicitud. El plugin rechaza un uso divergente, excepto en las dos rutas de creación de cobros: devuelven el cobro inmediato o con fecha de vencimiento existente. Un fallo de dependencia no es una señal para inventar un estado terminal. Restaura la dependencia, conserva la misma identidad de reintento cuando el contrato lo permita y lee el recurso antes de enviar una nueva solicitud de negocio.

Gestiona la conciliación y MED 2.0

DICT puede bloquear temporalmente determinadas mutaciones de claves y reclamaciones mientras VSync concilia un ámbito. Un 503 de ese bloqueo significa que la conciliación está activa. Inspecciona su estado y reintenta solo cuando el ámbito esté disponible. La cancelación sigue siendo distinta de las mutaciones que pueden introducir deriva. Las retenciones y devoluciones MED 2.0 tienen sus propias transiciones de estado. Usa la guía de SPI y la guía de DICT para determinar si una retención debe liquidarse, compensarse, liberarse o revisarse. No conviertas las anulaciones operativas en flujos normales del cliente.

Respeta el límite de conectividad

El adaptador de conectividad comunica el resultado del proveedor e invoca callbacks internos. Un cliente no debe invocar directamente rutas de callback, anulación o recuperación.

Lista de comprobación de operación

  1. Verifica el ámbito de la cuenta autenticada antes de una escritura.
  2. Guarda la solicitud, el valor de X-Idempotency y el identificador del recurso devuelto.
  3. Espera y observa el resultado asíncrono mediante una lectura pública.
  4. Verifica la contabilización esperada de Midaz o la contabilización compensatoria.
  5. Para un resultado no terminal, lee primero el estado. Solo después sigue la acción documentada de reintento o recuperación.
Consulta Integración para conocer los límites del cliente y las convenciones de solicitud.