Recurly

Payment Gateways

Payment gateways are responsible for processing transactions and distributing funds into your merchant bank account.

Gateway Configuration

  1. From your gateway configuration page, click Add Gateway

  2. Select your payment gateway (not seeing the right gateways for your location? Check your company country settings in your Site Settings).

  3. Enter your gateway credentials. These are typically not the credentials you use to access your virtual terminal but a set of API credentials. Please see our gateway-specific documentation for instructions on obtaining gateway API credentials.

  4. Set your accepted card types. Recurly will be able to collect payments from any card type supported by your payment gateway—the one exception are Maestro cards, which cannot be used for recurring transactions.

  5. Configure your Zero Dollar Authorization (ZDA) settings. Please test updating billing information with every card type you accept after enabling Zero Dollar Authorizations.

Test Configuration

Once a gateway is configured on your Recurly site, the test configuration option can be used for a basic verification check. When your site is in production mode, Recurly recommends running a test transaction (and then voiding the charge) to fully validate your gateway setup before you go live.

Payment Routing

For accounts with multiple gateways configured, Recurly will route transactions based on accepted card type and currency. Beyond those settings, Recurly will send the transaction to the gateway first added to the account.

Enabling/Disabling Gateway

A payment gateway can be enabled or disabled at any time to allow transactions to flow to another gateway. Simply enter the gateway edit page and check or uncheck Enabled for New Transactions.

Switching Gateways

Because Recurly stores your customer credit card data, you can easily switch payment gateways at any time. Simply disable/delete the old payment gateway and enable the new—Recurly will automatically funnel transactions to the new payment gateway.

Gateway Downtime

If for any reason your payment gateway is not reachable, Recurly will automatically retry your recurring transactions every 2–4 hours until either the gateway is reached or a maximum of 20 payment failures occurs.

Zero Dollar Authorizations (ZDA)

Your payment gateway settings can be configured for Zero Dollar Authorizations (ZDA), bypassing the default $1.00 authorization for billing information updates. ZDA transactions can only be processed when billing address information is present and your payment gateway supports this authorization type.

Fraud Velocity Checks

All transactions are passed through a simple fraud velocity filter before being passed on to your payment gateway. Please see the transactions documentation for details on our fraud check system and how you can take full advantage of it.