Recuperación de pagos

Un timeout después de POST /v1/payments no dice si el proveedor recibió la operación. Conserva la misma Idempotency-Key, saleReference y ambiente, consulta el Payment y registra el Request-Id. No crees otro pago para comprobarlo.

verifying es un estado real y no terminal. Programa una consulta con backoff y muestra “verificando” al comercio; succeeded permite cumplir la venta, mientras declined, canceled y expired requieren la política comercial correspondiente. Si la respuesta de consulta también falla, deja la orden en revisión operativa.

El webhook puede adelantar la consulta, pero no sustituye la recuperación autoritativa. Reconciliación significa comparar la misma referencia, clave, ambiente y Payment.id antes de cerrar o repetir una acción.