Payment gateways
The payment gateways Recurly Recover supports for retry collection, how gateway codes route transactions, and the reusable tokens Recover requires.
Supported gateways
Recover currently supports the following gateways, each with reusable gateway tokens:
| Gateway | Token support |
| Stripe | Reusable gateway tokens (for example, stripe_customer) and stripe_payment_method |
| Braintree | Legacy gateway tokens or Global IDs |
| Adyen | Stored Payment Method IDs + Shopper Reference + NTID |
| CommerceHub | Reusable TransArmor Token + Meta-Data (BIN/4 and Expiry Date) + NTID |
| FreedomPay | Reusable Gateway Token + NTID |
payment_gateway_references — see Payment methods.Gateway Configurations
When onboardng each individual gateway, use our guides to help assist with enabling or updating your gateways.
See our primary guide for enabling Adyen in RSM Documentation. For Recover users, the only required fields are as follows:
- Step 1: select Adyen as a gateway
- Step 2: Add relevant credentials -- username, password, and merchant account details. You do not need to provide an HMAC key or reporting credentials.
- Step 3: Enable payment methods and currencies, and save your configuration.
See our primary guide for enabling Braintree in RSM Documentation. For Recover users, the only required fields are as follows:
- Step 1: select Braintree as a gateway
- Step 2: Add relevant credentials -- Input your Merchant ID, Public Key, and Private Key.
- Step 3: Enable payment methods and currencies, and save your configuration.
See our primary guide for enabling Commerce Hub in RSM Documentation. For Recover users, the only required fields are as follows:
- Step 1: select Commerce Hub as a gateway
- Step 2: Add relevant credentials -- Fiserv Merchant ID, Terminal ID, API Key, and API Secret. If routing by store or site ID, also enter your Store ID and Site ID. If you are a former Payeezy merchant who was migrated to Commerce Hub, enter your Service Entitlement number as well, otherwise leave this blank.
- Step 3: Enable payment methods and currencies, and save your configuration.
See our primary guide for enabling FreedomPay in RSM Documentation. For Recover users, the only required fields are as follows:
- Step 1: select FreedomPay as a gateway
- Step 2: Add relevant credentials -- Store ID, Terminal ID, Enhanced Security Key, Enterprise Code (provided by your FreedomPay representative), and RSA Key ID.
- Step 3: Enable payment methods and currencies, and save your configuration.
See our primary guide for enabling Stripe in RSM Documentation. For Recover users, the only required fields are as follows:
- Step 1: select Stripe as a gateway
- Step 2: You will be redirect to Stripe to authenticate, and be redirected back to Recurly. Ensure you are connecting your existing Stripe account rather than creating a new one.
- Step 3: Credit cards are enabled by default, so enable Apple Pay and Google Pay, and currencies where relevant, and save your configuration.
Gateway codes and routing
Each gateway connection gets a unique gateway code. You pass this value in your API requests to route each transaction to the right connection.
To route different card types or gateway tokens through separate accounts, add multiple connections for the same or different providers — each one gets its own gateway code. Pass the matching gateway_code on the request to control exactly where a transaction is collected.
Updated about 1 hour ago