Enable Spreedly Recover on your account (it is an optional paid add-on); identify a primary gateway and up to two secondary (backup) gateways that will receive retried transactions.
Choose a retry mode: Standard retries both soft declines and gateway outages; Outage-only retries only on confirmed or suspected outages (server errors, timeouts, degraded performance); Custom lets you define specific gateway error codes to retry on.
Include the Recover object in your `POST /v1/gateways/{gateway_token}/authorize` or `purchase` API requests, specifying the backup gateways in priority order.
Alternatively, configure Recover inside a Composer workflow so failover logic is managed through the no-code UI and applied automatically to all transactions matching the workflow.
When the primary gateway returns a configured retry code or an outage is detected, Recover automatically retries the transaction on the next backup gateway; inspect the transaction response to identify which gateway ultimately processed the payment.
Review the gateway error code mapping documentation to understand which Spreedly normalized codes map to gateway-specific decline codes, and tune your Custom retry configuration accordingly.
Known gotchas
Recover does not retry if the primary gateway returns a hard decline or a code not in your retry configuration; only soft declines and outage-class errors trigger failover.
Retrying a transaction on a different gateway re-submits the same Spreedly payment method token; ensure the backup gateway is also provisioned in your Spreedly environment and has been tested end-to-end before enabling Recover.
In Custom mode, Recover can operate in additive mode (adds to the Spreedly Standard codes) or override mode (only retries on your explicitly listed codes); choose carefully to avoid either over-retrying hard declines or under-retrying soft failures.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp