Commerce PlatformB2C OmnichannelSeptember, 2025

Payments: Configurable refund retry delays for SOS

Adjust the time interval between automated refund retries in the Smart Order System (SOS) to match connector response times.

Payments: Configurable refund retry delays for SOS

What it does

This update allows merchants to define a specific delay for idempotent refund retries triggered by SOS. By extending the retry window; merchants can accommodate third-party payment connectors that require more than the previous 8-second default to process requests.

Benefits

  • Eliminate duplicate operations: Prevent race conditions where a retry is sent while the initial request is still processing
  • Increased stability: Align VTEX's financial logic with the specific latency of your payment providers
  • Reduced support overhead: Minimize 'unexpected behavior' tickets caused by timeout-induced retries

How to use

Access the Smart Order System (SOS) configuration via the VTEX Admin or API to set the 'refund_retry_delay' parameter according to your connector's requirements.

Related Updates

More releases from the same product suite, selected for focused reading.