{"__v":6,"_id":"5665e2b9d7490819006a5044","category":{"__v":29,"_id":"5665dfa0e93ae70d00b96a2a","pages":["5665dfca1b6559190020ae7d","5665e000e93ae70d00b96a2c","5665e0a9e93ae70d00b96a32","5665e0c7d8a06b170063f311","5665e12bd7490819006a503f","5665e1431b6559190020ae86","5665e16f63109d0d0036ba19","5665e192b6c0f60d00eae53d","5665e29ed8a06b170063f315","5665e2b9d7490819006a5044","566630b03360850d00336cb6","566631547cc81e0d00253f1a","566631b38744940d004c3eff","5666328b2342100d007dcbf7","566729ab5d00370d00ede6c2","56672a86f672550d0008523a","56672fd9ee53940d00516267","5667335f5d00370d00ede6db","566735cf6819320d000c2f05","5667362b32dd550d00f3924b","5667373d6819320d000c2f0a","566737c232dd550d00f3924e","5667380ad784a70d00397ce1","56673ee86819320d000c2f1b","56673f95ee53940d0051629d","56673feed784a70d00397cec","5667431e66debc1700503f6a","5667436d66debc1700503f6d","566745066819320d000c2f3d"],"project":"56450a342229d7170010928a","version":"56450a342229d7170010928d","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-12-07T19:36:00.783Z","from_sync":false,"order":2,"slug":"configuration","title":"Configuration"},"parentDoc":null,"project":"56450a342229d7170010928a","user":"55648cf93b87582b003ab8b1","version":{"__v":9,"_id":"56450a342229d7170010928d","project":"56450a342229d7170010928a","createdAt":"2015-11-12T21:52:52.685Z","releaseDate":"2015-11-12T21:52:52.684Z","categories":["56450a352229d7170010928e","56450a472c74cf1900da48ca","565def2677f0090d005819bb","5665dfa0e93ae70d00b96a2a","5665e3db1b6559190020ae8c","5665e47763109d0d0036ba5a","5690123f18c3920d00be8b1c","56944016d8c04d1700e5ae20","569447891005590d0062cace"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"createdAt":"2015-12-07T19:49:13.691Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":9,"body":"## Gateway Configuration\n\nIf you don't have a gateway yet, please see our [Getting Started documentation][2] for instructions. If you already have a gateway, follow these steps:\n\n1. From [your gateway configuration page][1], click **Add Gateway**\n\n2. Select your payment gateway (not seeing the right gateways for your location? Check your company country settings in [your Site Settings][2]).\n\n3. 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][3] for instructions on obtaining gateway API credentials.\n\n4. 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.\n\n5. Configure your Zero Dollar Authorization (ZDA) settings. Please test updating billing information with every card type you accept after enabling Zero Dollar Authorizations.\n\n[1]: https://app.recurly.com/go/configuration/payment_gateways\n[2]: https://app.recurly.com/go/configuration/edit\n[3]: /docs/payment-gateways/additional\n\n## Test Configuration\n\nOnce 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.\n\n## Payment Routing\n\nFor 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.\n\n## Enabling/Disabling Gateway\n\nA 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**.\n\n## Switching Gateways\n\nBecause 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.\n\n## Gateway Downtime\n\nIf 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.\n\n## Zero Dollar Authorizations (ZDA)\n\nYour 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.\n\n## Validations\nRecurly works to save you money by passing some basic validations before passing the transaction to your payment gateway. This includes:\n\n1. Validating that the credit card number is a valid number (ie; passes Luhn check)\n2. Validating that the CVV format matches the card type selected \n3. Validating a future expiration date format\n4. Validating the zip code format (when country code is supplied, for limited countries)\n5. Validate the entry of address information based on site-level address requirements.\n\n## Fraud Velocity Checks\n\nAll transactions are passed through a simple fraud velocity filter before being passed on to your payment gateway. Please see the [transactions documentation](/docs/transactions) for details on our fraud check system and how you can take full advantage of it.","excerpt":"Payment gateways are responsible for processing transactions and distributing funds into your merchant bank account.","slug":"payment-gateways","type":"basic","title":"Payment Gateways"}

Payment Gateways

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

## Gateway Configuration If you don't have a gateway yet, please see our [Getting Started documentation][2] for instructions. If you already have a gateway, follow these steps: 1. From [your gateway configuration page][1], 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][2]). 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][3] 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. [1]: https://app.recurly.com/go/configuration/payment_gateways [2]: https://app.recurly.com/go/configuration/edit [3]: /docs/payment-gateways/additional ## 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. ## Validations Recurly works to save you money by passing some basic validations before passing the transaction to your payment gateway. This includes: 1. Validating that the credit card number is a valid number (ie; passes Luhn check) 2. Validating that the CVV format matches the card type selected 3. Validating a future expiration date format 4. Validating the zip code format (when country code is supplied, for limited countries) 5. Validate the entry of address information based on site-level address requirements. ## 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](/docs/transactions) for details on our fraud check system and how you can take full advantage of it.