Skip to main content
Opera Pix Lerian como una aplicación con estado, contabilizaciones en Midaz y resultados asíncronos del proveedor. En v1.0.0, prueba este modelo solo con el proveedor mock incluido.

Observa la operación, no solo la respuesta HTTP

Una respuesta de creación puede confirmar el trabajo aceptado antes de que el proveedor mock 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 en la evidencia de pruebas.
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. Un uso divergente se rechaza, mientras que una repetición específica de la ruta puede devolver el recurso existente en lugar de crear otro. 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 de forma deliberada

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 plugin y Midaz son los componentes bajo prueba. El proveedor mock incluido simula el resultado del proveedor e invoca callbacks internos. Un cliente no debe invocar directamente rutas de callback, anulación o recuperación. La integración de mensajería nativa de SPI no está disponible en esta versión. Estas páginas no establecen la conectividad de producción ni un modelo de selección de proveedores.

Lista de comprobación de operación de pruebas

  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 simulado 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.