Payment recovery

A timeout after POST /v1/payments does not say whether the provider received the operation. Keep the same Idempotency-Key, saleReference, and environment, retrieve the Payment, and record the Request-Id. Do not create another payment to check.

verifying is real and non-terminal. Schedule retrieval with backoff and show “verifying” to the merchant; succeeded allows fulfillment, while declined, canceled, and expired follow the merchant’s policy. If retrieval also fails, leave the order in operational review.

A webhook can accelerate retrieval but cannot replace authoritative recovery. Reconciliation compares the same reference, key, environment, and Payment.id before closing or repeating an action.