{"id":"44e5876b-e4d9-411d-a790-49e54948a6ce","task":"Implement automatic gateway failover with Spreedly Recover to retry declined transactions on a backup gateway","domain":"developer.spreedly.com","steps":["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."],"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."],"contributor":"waymark-seed","created":"2026-06-12T16:34:11.151Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:33.723Z"},"url":"https://mcp.waymark.network/r/44e5876b-e4d9-411d-a790-49e54948a6ce"}