Recurly

Additional Gateways

Gateway Support

Recurly gateway support is dependent on your business location. Please see http://recurly.com/features/payment-gateway-support for gateways supported in your country.

Authorize.net

For pricing and signup information for a new production Authorize.net account, please visit Authorize.net.

Address Verification Service (AVS)

US & International

If your company accepts payments from international customers, you need to be aware of some the AVS shortcomings. Currently, AVS fails to match zip codes if the zip code contains letters. US Zip Codes are numeric but many international postal codes will contain letters and will fail to match on the zip code. In order to use AVS with international credit cards, we recommend allowing the transaction to proceed if the street address OR zip code matches.

This configuration works best for accepting international payments:

US-only

If your company will only accept payments from US customers, your AVS settings can be a little stricter:

Card Code Verification (CCV)

When a subscription is first created or a credit card number is updated, Recurly will submit the card number and CCV to your payment gateway. PCI regulations do not allow anyone to store CCV values (regardless of encryption), so it can only be used for the first request. Submitting the CCV with the first request increases the likelihood that the transaction will be approved and will reduce fraud. Banks typically allow subsequent transactions to process if previous transactions have been processed by the same merchant without problem.

With Authorize.net, Recurly recommends enabling the CCV Filter and setting the permissions to match:

API Login ID and Transaction Key

Recurly needs your API Login ID and Transaction Key in order to communicate with your Authorize.net account. Within your Authorize.net account, navigate to Account → Settings → API Login ID and Transaction Key.

Once you have obtained your credentials, please enter them into Recurly’s Payment Gateway configuration.

Beanstream

To configure Recurly with a Beanstream account, you will need:

The username and password are configured under Administration → Account Settings → Order Settings → Use username/password validation against transaction. You’ll need to check that checkbox and then create a username and password.

The API user for Recurly is different than the normal user accounts configured in the Beanstream User Manager.

Address Requirements

Beanstream requires full address information to be submitted for every transaction, including billing phone number. If you are using Beanstream, please set Recurly to require the full billing address (name, phone, street address, city, state/province, postal/zip, and country).

American Express

Please note: American Express prevents Canadian merchants from accepting USD American Express unless you have an entity located within the United States.

Braintree

Recurly supports both Braintree Orange (v1) and Blue (v2).

Chase Paymentech Orbital

Recurly support the Chase Paymentech Orbital, Global Platform. Please contact support before setting up your gateway.

In order for Recurly to connect to your Orbital account, you must ask Chase to configure your Orbital gateway to allow connections from Recurly. At the moment, we only support the Global Platform.

Currencies

The Tampa platform only supports US Dollars and Canadian Dollars.

The Salem platform supports many more currencies. Please contact Chase for more inforamtion.

Cybersource

To configure the CyberSource gateway you’ll need your account username and a Transaction Security Key for the SOAP Toolkit API.

To get a Transaction Security Key, do the following:

  1. Log into your CyberSource business gateway

  2. Navigate to Account Management → Transaction Security Keys → Security Keys for the SOAP Toolkit API.

  3. Click on Generate Key.

  4. Copy the new key into the password field of your Payment Gateway configuration in Recurly.

Litle & Co.

Recurly supports Litle and Co for US merchants. Before Recurly can connect to your Litle account, you must first ask Litle to allow Recurly to connect.

PayPal Business Accounts

In addition to accepting credit cards, Recurly allows your customers to pay via PayPal. In order to accept payments directly from a PayPal account, you must have a PayPal business account approved for referential transactions. When your customers pay via their PayPal account, the funds are deposited within your PayPal business account.

Apply for Referential Transactions

Once approved, PayPal will contact Recurly to enable this functionality on your site.

Recurly’s PayPal support vs. PayPal’s Recurring Payments

API PayPal’s Recurring Payments API allows your business to start and cancel subscriptions. However, once a subscription is started, it cannot be modified. This makes it difficult to allow your customer to upgrade or downgrade to a different plan or billing cycle.

When your customer agrees to a PayPal billing agreement, Recurly is then able to bill the customer with the same mechanics as a credit card. You can perform one-time transactions, subscription upgrades and downgrades, pay as you go, and use all the other functionality of Recurly as normal. Recurly allows you to accept payments from PayPal accounts with the same ease as a credit card.

Billing Agreements

When your customers perform a transaction or begin a subscription with Recurly and opt to pay using their PayPal account, the customer is redirected to PayPal’s website to validate their PayPal account. During this process, the customer is presented with a billing agreement. After committing to the billing agreement, the subscription will begin.

Accepting Payments with PayPal

Once your PayPal business account has been configured with Recurly, you may accept payments via PayPal using the Hosted Payment Pages or the Transparent Post API.

Hosted Payment Pages

Once your PayPal business account is configured with Recurly, your hosted payment pages will automatically allow your customers to pay via PayPal.

Restrictions

In order to accept payments from a PayPal account with Recurly, your business must have a PayPal business account approved for referential transactions.

PayPal typically requires a history of processing credit card transactions before approving accounts for referential transactions.

PayPal Referential Transaction Application

PayPal Payflow Pro

PayPal Payflow Pro is a payment gateway only product. Recurly supports Payflow Pro in the US, UK, Canada, and Australia.

PayPal Website Payments Pro

Recurly can use PayPal’s WebSite Payments Pro to process credit cards. The WebSite Payments Pro acts as a payment gateway and merchant account in one.

To get started with PayPal’s Website Payments Pro, you only need to sign up for their base account. You do not need their Recurring Payments feature—that’s completely handled by Recurly.

WebSite Payments Pro only works for merchants located in the US, Canada, and UK. Due to PayPal restrictions, we cannot integrate with PayPal Website Payments Pro in any other country.

Card Security Code (CSC)

Some PayPal accounts are required to present the Card Security Code (CSC) for every transaction. After you setup your PayPal credentials, Recurly will verify your credentials. If Recurly determines your account requires CSC for every transaction, you will need to contact PayPal to disable this requirement before your account can be used with Recurly.

Important Note: By default, Recurly requires the CSC (also known as CVV) to start a new subscription or transaction. Due to PCI requirements, Recurly cannot store the CSC. Therefore, Recurly submits recurring transactions without the CSC, and your PayPal account must be configured to not require this value.

Configuring Recurly to use PayPal

Recurly requires the PayPal API Username, API Password, and Signature (preferred) or PEM Certificate to connect to your PayPal WebSite Payments Pro account. To retrieve your Signature from PayPal, follow these steps:

  1. Log in to your PayPal account at paypal.com

  2. On the My Account tab, click on the Profile sub-tab.

  3. Click on API access or Request API credentials, depending on your PayPal account type.

  4. PayPal will present two options: granting API permissions (Option 1) and requesting API credentials (Option 2). Select option 2. It may say View API Signature or View API Credentials.

  5. If you have already requested an API Signature, you will now see your API credentials. Otherwise,

  6. The final page will display your API username, password and signature. All three pieces are required to connect Recurly to your PayPal Website Payments Pro account.

PEM versus Signature

Recurly supports connecting to your PayPal account using the PEM or signature for credit card transactions. If in the future you wish to support payments via PayPal (in addition to credit cards), you must use the signature API credentials. If you have created a PEM certificate, you will need to delete the PEM certificate and walk through the process of choosing the signature credentials.

Canada and American Express

Please note, PayPal Website Payments Pro in Canada does not support American Express.

Address Requirements

PayPal Website Payments Pro requires full address information to be submitted for every transaction. If you are using PayPal WPP, please set Recurly to require the full billing address (name, phone, street address, city, state/province, postal/zip, and country).

SagePay

Recurly supports the Sage Pay gateway in the UK. A continuous authority merchant account number is required to work with Recurly and Sage Pay.

SagePay Setup

When configuring your SagePay setup, choose I want to use my own payment pages and leave the Form and Server product checkboxes unchecked.

SagePay requires a test transaction and refund against their test server to finalize your setup. Please contact Recurly support for assistance connecting to SagePay’s test server. SagePay’s instructions for processing these test transactions can be found at http://www.sagepay.com/help/faq/how_can_i_test_the_different_card_types.

IP Addresses

SagePay requires a list of IP Addresses that will issue transactions on your behalf. The IP address range that may issue transactions from Recurly:

75.98.92.96 with subnet 255.255.255.240

The range can also be expressed:

75.98.92.96/28

Wirecard

Recurly supports Wirecard as a payment gateway.