Recurly

Salesforce Integration

Recurly's Salesforce integration links your Recurly account directly to your Salesforce Organization and automatically updates Subscription, Invoice, Transaction and Account data. Data recently added or updated within Recurly synchronizes with Salesforce every two hours.

Requirements

The Salesforce integration only works with Developer, Enterprise, and Unlimited editions of Salesforce. It does not work with Salesforce Sandboxes.

This feature is available in the enterprise edition of Recurly. You may configure and test the Salesforce integration before your site is in live mode.

Setup and Configuration

  1. If you don’t already have a Salesforce account, you may create a free developer account for evaluation.

  2. Install the Recurly package to your Salesforce Organization. Once installed:

    a. From inside of Salesforce, click your name in the upper right and click Setup.

    b. Under App Setup, click Accounts and then Fields.

    c. For each field from the Recurly package as well as Account Number, click the field name.

    d. Click Set Field-level Security and set it to Visible for all users. Click Save.

    e. Then go to Page Layouts and edit your active layouts.

    d. Create a section called “Recurly Information” and drag all of the Recurly-related fields into this section.

  3. In Recurly, under Salesforce, click the Connect to Salesforce button and grant Recurly access to your Salesforce organization.

  4. The Recurly package extends the Account table with Recurly specific columns and adds 3 new tables: Invoice, Subscription, and Transaction. The Recurly-specific columns and tables are scoped under the Recurly namespace so they will not interfere or collide with other packages installed in your Salesforce organization.

  5. Once you’ve connected your Salesforce account to Recurly, all of your historical data will begin to sync to Salesforce. This process can take up to 24 hours depending on the amount of data inside your Recurly account.

  6. You can monitor the status of the data synchronization by following the instructions here: http://www.salesforce.com/us/developer/docs/api_asynch/Content/asynch_api_batches_monitor.htm

The Recurly Package Schema

Account Matching

The Recurly Salesforce app adds a field called “recurly__Account_Code__c” to match accounts.

By setting this field on your Salesforce accounts before they are created inside Recurly, the Recurly Salesforce integration checks for all recurly__Account_Code_c values before pushing up data. Based on the presence of data in that field, the Salesforce integration will create or update those matching records.

Accounts

Recurly synchronizes your accounts with the following fields in the Account table:

These fields are added to your Account table specifically for Recurly records:

Invoices

Invoice is a Recurly specific table added by the Recurly package. It contains the following fields:

Subscriptions

Subscription is a Recurly specific table added by the Recurly package. It contains the following fields:

Transactions

Transaction is a Recurly specific table added by the Recurly package. The Transaction table will only include transactions linked to accounts. It will not include failed payment or authorization attempts before an account successfully signs up. It contains the following fields:

Person Accounts

Recurly’s Salesforce integration can be configured to use Salesforce Person Accounts if they are enabled in your salesforce account. Please contact support@recurly.com to have syncing to Person Accounts enabled. If you have Person Accounts enabled, our integration will default to use those when you first connect to Salesforce.

Please note that when you move from syncing from Standard Accounts to Person Accounts, the integration will create Person Accounts for the first time to sync all data. You’ll want to delete any Standard Accounts to ensure the data isn’t duplicated.

Support

If you are experiencing any trouble with your Salesforce synchronization, please follow these instructions to check the status of Recurly bulk imports. If the bulk imports report any errors, please send them to the Recurly support team.