Integrate Spreedly's single tokenization API to collect and vault payment methods once; card data is stored in Spreedly and never flows through your servers, keeping your PCI scope minimal.
Connect each PSP or gateway to your Spreedly environment via the Marketplace or API; each connected gateway receives a gateway token used to target transactions.
Model your business routing logic in Composer using conditional routing rules: route by currency to reduce cross-border fees, by card brand to target lowest-cost acquirers, and by issuing country to maximize local authorization rates.
Wrap every `authorize` or `purchase` call in a Recover configuration specifying up to two backup gateways and a retry mode (Standard for maximum success rate, Outage-only for minimal re-submission risk).
After each transaction, read Spreedly's normalized response fields to get a consistent view of success, decline, or error across all PSPs; feed these fields into your own reconciliation pipeline without parsing each PSP's proprietary response format.
Use Spreedly's Advanced Vault network tokenization to automatically enroll stored cards with Visa and Mastercard, further improving authorization rates for recurring charges routed across any connected gateway.
Known gotchas
Spreedly normalizes gateway responses into a common schema, but gateway-specific data is also available in `transaction.gateway_specific_response_fields`; consult this for debugging declines that require PSP-specific error context.
Recover retries submit the transaction to a different gateway using the same Spreedly token; if a gateway has already partially processed a transaction (for example, an authorization that timed out), verify idempotency before relying on Recover to avoid duplicate charges.
Adding a new PSP to Spreedly requires provisioning the gateway and running test transactions; do not add a new gateway to live routing rules before it has been validated end-to-end in the Spreedly sandbox.
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