Salesforce FAQ

Staff Management

What profile permissions are required?

The Salesforce integration has a permissions set, “Provide Permissions to Chargify”, that must be granted to the Site Guest User (which receives and handles webhooks) and any user with a license that will use the integration. These permission sets are automatically updated as new fields and objects are added to the integration; this means that you won’t need to manually update permissions as new updates are released.

To add the permission set to standard users:

  • Go to Setup > Manage Users > Permission Sets
  • Select ‘Provide Permissions to Chargify’ > Manage Assignments > Add Assignments
  • Assign permission set to all users with access to the Chargify integration

To add the permission set for the Site User:

  • Go to Setup > Develop > Sites
  • Click on the site label for the Chargify Site
  • Select Public Access Settings > View Users
  • Choose the Site User
  • Click on ‘Edit Assignments’ in the ‘Permission Set Assignments’ section
  • Add “Provide Permissions to Chargify” to right column
  • Save

What needs to be done to add another user to my production Salesforce account?

These steps are only required if the new user(s) will need access to the Chargify integration and/or will need to view Chargify data. In these cases, they need a paid Chargify license.

  1. Contact and specify how many additional licenses are needed. For information on pricing, please refer to the pricing page here.
  2. Once the licenses have been allocated to your account, they need to be distributed to the new users.
    • Go to Setup > Installed Packages > and select the Manage Licenses link next to the Chargify package.
    • From here you can assign the licenses to the correct users.
    • Select “Add Users” to proceed.
  3. Lastly, a permission set needs to be added for each user called “Provide Permissions to Chargify”.
    • Please refer to the What profile permissions are required? section of the FAQ for instructions on how to accomplish this. The instructions to follow will be the ones for a standard user, not the Site User.

How do I enable support access for Chargify staff to access my account?

Occasionally the Chargify support staff will require access to your Salesforce Org in order to diagnose a problem. Rather than providing your login information, you can enable support access once the Chargify for Salesforce package has been installed.

  • Go to “My Settings”
  • In left column click Personal > Grant Account Login Access
  • Enable Chargify Support by selecting duration in dropdown (depending on the issue, 1 week is recommended)
  • Save

If the option to grant access isn’t available, one of the following situations may be applicable:

  • A system admin disabled the ability for non-admins to grant access.
  • The user doesn’t have a license for the package.
  • The package is licensed to the entire org. Only admins with the “Manage Users” permission can grant access.
  • The org preference Administrators Can Log in as Any User is enabled.

Salesforce Application FAQs

Is Lightning supported?


Does the integration update Opportunity “stage”?

The integration allows you to select the desired stage for trialing subscriptions when a new Opportunity is created, or to retain the stage when a trialing subscription is linked to an existing Opportunity. Opportunities will automatically convert to Closed/Won when the subscription transitions to an Active state.

Are Opportunities automatically linked to Contact Role when records are updated or created?

Opportunities and Contact Roles are automatically linked in Salesforce.

  • If the Opportunity and Contact already exist and Contact Role was already associated with the Opportunity, the integration will not alter the existing Contact Role when the subscription information is attached to the existing Opportunity.
  • If a new Contact or Opportunity is created by the integration, the Contact Role will be assigned as “other” and the Contact with matching email address will be associated with the Opportunity.

Why doesn’t a pending cancelation show inside Salesforce ?

If the delayed product change was initiated in the Chargify user interface or Billing Portal, there is no webhook associated with these actions, so it will not reflect in Salesforce. You will need to cancel the delayed product change within Chargify.

However, if the delayed product change was initiated from within Salesforce, then Salesforce will record this information. You will be able to select the “Cancel Delayed Product Change” button in the Opportunity.

Can I delete external payments and refunds inside Salesforce?

Currently you cannot delete external payments or refunds inside Salesforce. This action can only be done in Chargify.

Can I update the billing address in Salesforce and push it to Chargify?

Billing addresses may only be pushed to Chargify when creating a subscription or adding/updating a payment profile.

What timezone will timestamps be displayed in Salesforce?

Timestamps will be converted and displayed in the timezone set in your Salesforce Org settings, or user settings. For example, if the Chargify site timezone is set to Eastern time and the Salesforce Org and user are set to Pacific time, a Next Billing At time would appear as 4PM Eastern in Chargify and 1PM Pacific in Salesforce.

Sync Questions

Why aren’t my renewals updating?

If renewals aren’t updating, it is likely that the webhook configuration is not setup properly. The initial sync that takes place when you hit submit in the Chargify Configuration tab is an API sync. However, all subsequent customer and subscription updates are completed via webhook.

Please check to see if your webhooks are still active within the Chargify webhook panel in Settings –> Webhooks. For more information, please click here.

Resyncing Salesforce Data

Occasionally you may need to resync your SalesForce data from the information contained in Chargify. Please follow the steps below to perform a resync:

  1. Navigate to the Chargify Configuration tab
  2. Hit submit at bottom of page after making sure “historical data import settings” are set to the right dates, or import all data if that is preferable.
  3. Go to Setup and search for Apex jobs.
  4. See if any CHRGFY jobs are running. If all completed, the resync is done!

How many Chargify Customer and Subscription records are synced during each API batch?

Each Customer sync is 100 Customers. Each Subscription sync is 200 Subscriptions. When syncing large amounts of Chargify records, this allows ample time for your workflows and triggers to process without timing out the API batch sync.

How do I reduce the batch size during Subscriptions import/sync?

The subscriptions import batch size is set to 200 records per batch by default. If your Salesforce Org has a lot of triggers and workflows, you may encounter COU timeout errors. To resolve these errors, you can reduce the batch size for Subscriptions from 200 to a lesser value.

  1. Go to Setup.
  2. Search Custom Settings in Quick Find Box and click Custom Settings under develop.
  3. There will be a custom setting named ‘Batch Size’, click on manage link adjacent to this custom setting.
  4. Click on New button (for reference go through attached screenshot).
  5. Then enter ‘Subscription Batch Size’ manually (max batch size can be 200 and min batch size can be 1).

How can I prevent a CPU timeout with the Portal batch sync?

It’s possible to reduce the per-page size of the Portal batch, which is using to retrieve and update Billing Portal information from Chargify. This is done via the ‘Chargify Portal Batch Size’ setting in the ‘Batch Size’ Custom Setting.

To change the size of the Portal batch:

  1. Go to Setup.
  2. Search for ‘Custom Settings’ in the quick find box along the lefthand side and click on it.
  3. Click on the Custom Setting named ‘Batch Size’.
  4. Press the Manage button.
  5. Check if any record exists.
    • If a record exists, then edit it and change the value in “Chargify Portal Batch Size” from 0 to 50.
    • Otherwise, create the new record and modify this value from 0 to 50.

How do I connect multiple Chargify sites to one Salesforce account?

There are three additional settings that need to be added for each Chargify subdomain:

  1. Additional Remote Site(s) in Salesforce
  2. Additional Custom Settings in Salesforce
  3. Additional webhook endpoint(s) in Chargify

Once the above settings are added as needed, the subdomain and API key of each new Chargify site may be added to the Chargify Configuration.

General FAQ

Does the Chargify for Salesforce integration work with person accounts?

Yes, we released Person Account support in September 2018. By default, the integration works with Business accounts only. You will need to configure your settings to enable Person Accounts.

How can I calculate MRR and ARR in Opportunities?

Merchants have accomplished this by creating custom fields for ARR and MRR in Opportunities, checking the Line items in the Standard Price Book for product and components, getting the totals, checking the product intervals in the Products object, and calculating by multiplying or dividing the totals by the interval.

For example, if an Opportunity has a product attached to the Standard Price Book that shows $12 total, the Chargify Interval for that product (visible in the Products object) is “12” and Chargify Interval Unit is “month”, you would divide the $12 total by 12 to get MRR.

Another example would be if an Opportunity has a product attached to the Standard Price Book that shows $1 total, the Chargify Interval for that product (visible in the Products object) is “1” and Chargify Interval Unit is “month”, you would multiply the $1 total by 12 to get ARR.

Can I download the Chargify Logs?

Yes, you can download the log files at any time in the list view by selecting “Download Chargify Logs”.