Create a Gr4vy account and connect your payment service providers (PSPs) via the Gr4vy Dashboard by supplying credentials for each; Gr4vy provides a single API endpoint for all transactions regardless of which PSP processes them.
Define routing rules in the Gr4vy Dashboard or via the API: set conditions based on currency, card brand, shopper country, transaction amount, or custom metadata to direct each transaction to the optimal PSP.
Submit transactions to the Gr4vy API using the payment instrument stored in Gr4vy's vault; Gr4vy evaluates your routing rules at transaction time and forwards to the matched PSP.
Enable smart failover: configure Gr4vy to automatically retry a declined or errored transaction on the next eligible PSP in your routing order, improving overall authorization rates without changes to your integration.
Use Gr4vy's reporting and analytics dashboards to compare authorization rates, processing costs, and decline reasons per PSP; use these insights to refine your routing rules.
For native 3DS authentication (available for iOS and Android SDKs), configure 3DS within Gr4vy to avoid web-view redirects during authentication; this is supported via Gr4vy's Adyen Direct Mode for native SDK flows.
Known gotchas
Gr4vy routes transactions based on the rules you define; if no rule matches a transaction, it falls through to a default PSP — always define a catch-all rule to avoid unexpected routing gaps.
Payment instruments stored in Gr4vy's vault are associated with Gr4vy, not any individual PSP; confirm that your preferred PSPs accept Gr4vy-vaulted payment method tokens before enabling multi-PSP routing.
Outbound webhooks that deliver to enterprise systems requiring OAuth bearer tokens must have OAuth authentication configured in Gr4vy; failing to configure this will result in webhook delivery failures to those systems.
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