Using the Salesforce Integration


In this section we will go over how to use the new Salesforce integration.

Salesforce Accounts & Contacts to Chargify Customers

Salesforce Account and Contact information contain the same information that would exist in the Chargify Customer record. If an Account has more than one Contact then the Contact will need to be specified at Customer/Subscription creation in Chargify.

Salesforce Products / Price Books to Chargify Products / Price Points

Chargify Products will create a Product in Salesforce. However the Product Price Point and Currency will exist as a Price Book entry.

Salesforce Opportunities to Chargify Subscription Previews & Subscriptions

One of the new features with the Salesforce integration is that Subscription Previews can now be created on Opportunity in Salesforce. This allows for a preview of the Subscription pricing that can be saved for later use if the deal is won or when manually activated.



Creating a Subscription in a group

When creating a subscription in the subscription wizard, if “Invoice Type” is set as “Consolidated” a subscription group will be created for that subscription. More information on subscription groups can be found here: Subscription Groups

Subscription Preview to PDF

After a subscription preview is created you are able to generate a PDF that can be sent to the customer prior to purchasing. This is a helpful tool in the early stages of negotiation and price setting.

To generate a PDF of the Subscription Preview navigate to the desired Subscription Preview. In the top right click on Generate PDF to download the PDF.


Salesforce Account & Chargify Customer Management

Depending on your sync settings any changes made to the Account or Contact in Salesforce or Chargify will automatically be synced.

Create a Customer in Chargify from an Account in Salesforce

At the Account or Contact level in Salesforce you are able to create a Customer using the Subscription Wizard. Clicking the “New Subscription” button the Subscription Wizard will open and a Chargify Customer can be created in Salesforce.


Create an Account in Salesforce from a Customer in Chargify

If your sync settings allow, when a Customer is created in Chargify it will automatically create an Account/Contact in Salesforce. The sync will occur on the selected sync timing that has been setup in your Chargify Configuration for Batch Timing.

Update an Account in Salesforce from a Customer Update in Chargify

If selected in the Chargify Configuration any update to a Chargify Customer will automatically update the Account in Salesforce. This update will occur on the setup batch timing.

Update a Customer in Chargify from an Account Update in Salesforce

If an Account it updated in Salesforce it will automatically update the Customer in Chargify. One thing to note is that if an update occurs in Salesforce it will immediately be sent to Chargify and not wait for the batch timing. Only updates that occur in Chargify will respect the batch timing.

Create a Contact in Salesforce

Please note an Account will need a Contact to be present inorder to create a Customer/Subscription in Chargify from Salesforce. If more than one Contact is present the subscription will need to be created on the Contact level so that the Customer record in Chargify can correctly reflect that Contact.

Update a Contact in Salesforce

Any updates to a Contact will automatically sync to Chargify. Also any updates to a Customer record in Chargify can sync to Salesforce, depending on the selected sync settings.

Salesforce Opportunity & Chargify Subscription Management

At the Opportunity level a Subscription preview can be added.


Clicking into the you will have the option to Activate the Subscription.


Also if setup in your sync settings a Subscription can be created when an Opportunity is Closed/Won.

Collect Payment Profile Information

Payment profile information can be collected via the Subscription Creation Wizard. Payment Profiles can later be updated by navigating into the subscription in Salesforce and clicking the “Upgrade Opportunity” button, here you will be able to changed the payment profile.


View Chargify Transactions in Salesforce

New to Salesforce V3 is the ability to see transactions. The transactions can be found under the Chargify Transactions tab.


Update a Chargify Subscription or in Salesforce

Subscriptions can be altered at any time. To do this navigate into a the desired Subscription in Salesforce. Once in the Subscription click the “Upgrade Opportunity”. In this wizard you will be able to change payment profile information as well as adjust the subscriptions product, components and coupons.



Change Product Immediately (No Proration)

When using the Upgrade Opportunity wizard, if a product is changed you will be presented options on how you would like to change the Product. If only “Change Product” is selected only the Product will be changed.


Upgrade / Downgrade Product (with Proration)

Similarly to above a Product can be Upgraded/Downgraded which will add a Proration to the difference of the Products.

  • If “Preserve Period” is selected the normal next billing date will be respected.
  • If “Include Trial” is selected the new products trial will be included on the subscription.
  • If “Include Initial” is selected the setup fee will be included at the time of Upgrade/Downgrade.


Add Coupon

When using the Create Subscription Wizard you will be able to add a coupon at the time of Subscription Creation. Coupons can also be added later when updating a Subscription.


Remove Coupon

Coupon removal can also be done in the Subscription Wizard by clicking the “Remove” button next to the Coupon.

Subscription Actions

When inside of a subscription in Salesforce you will have options to control the subscription in Chargify.13.png

  • Cancel Subscription- This option allows you to cancel the subscription in Chargify. You will be given the option to cancel immediately or to Cancel at End of Period. Churn code and additional notes can be added here as well.


  • Reactivate Subscription- Reactivating a subscription will move a subscription from a cancelled state to an active state. Please note that if any amount is due it will be expected immediately and if payment fails the subscription will remain in a cancelled state.

  • Clear Pending Cancellation- Using this option will remove any upcoming cancellation that has been placed on the subscription.

  • Give / Deduct Service Credit- Clicking this option provides the ability for giving or deducting service credits from a subscription.15.png16.png

  • Put on hold- When selected the subscription will be moved to an On Hold state. Options for how long to keep the subscription in an on hold state will be presented. More information about this state can be found here: On Hold Subscriptions

  • Resume- This option will allow you to remove a subscription’s On Hold state.


Chargify Invoices can be found by searching for and selecting “Chargify Invoices” in the App Search. This will open a Chargify Invoices tab. Here you would be able to access invoices that have been generated by Chargify.


Invoice Actions

Clicking into a subscription you will be presented with actions that can be applied to the invoice.19.png

  • Record Payment-

    • Use Existing Payment Profile - Selecting this option will charge the active card on file for the invoiced amount.

    • Record External Payment - This option allows for an external payment be created and applied the to invoice.

    • Apply Prepayment - If a prepayment balance exists on the subscription it can be applied to the invoice using this button.

    • Apply Service Credit - If a service credit balance exists on the subscription it can be applied to the invoice using this button.


  • View Invoice Public URL- Selecting this button will display a link to the invoice which can be sent to customers for payment.21.png

  • Void Invoice- Using this action will move the invoice to a voided state and will no longer be able to recieve payment.

  • Invoice Refund-
    Once clicked the option to refund the invoices payment profile or externally apply a refund can be selected. On the next page the payment to be refunded can be selected. Once the payment to be refunded has been selected the exact amount can be entered.



Creating a Coupon

Creating coupons can be done by using our coupon creation wizard in Salesforce. This wizard can be found by going to the ‘Products’ tab and clicking the ‘Create Coupon’ button.25.png

This will open the coupon creation wizard which will create a coupon in Chargify and can be applied to a subscription at creation. All of the usual coupon options and restrictions can be found in the wizard. For more information on coupon options please see our coupon documentation here: Coupon Documentation26.png

Custom Fields

Setting Up Custom Fields

To map custom fields within Salesforce, navigate to the chargify configuration tab within Salesforce and select ‘Configure’ from the dropdown for the corresponding site as indicated in the screenshot below. 27.png

From the next page, locate the ‘Custom Field Mapping section and choose the option indicated in the screenshot below.28.png

This will open up a new window from which you can select the Object in Salesforce for the custom field to map to, which in this case will be subscription.29.png

Next choose the Chargify Custom Field to be mapped to the object chosen. For the middle field, ‘Choose Salesforce Field’, this field will first need to be created in the ‘Object Manager’ for the particular Object chosen (Subscription). Next add this created field to the layout for the Subscription Object. 

To create the field, Navigate to ‘Object Manger’ within setup and chose the corresponding object, in this case it will be the Chargify Subscription.


Then locate the ‘Fields & Relationships’ tab within the Object Manager and select ‘New’ to create a new field. 31.png

Next, Salesforce will open a modal and the following steps will need to be taken.

For step 1 of the creation process, you’ll want to choose the option that best fits the related custom field. The descriptors for these custom fields are indicated within step one and are shown in the screenshot below.32.png

Step 2 is where you’ll be able to define the name for the field which can be something specific such as ‘Custom Field PO Box’. Additionally, this step is where the length of certain fields will be defined. 33.png

Step 3 will allow you to select the profiles to which you want to grant edit access to this field via field-level security. The field will be hidden from all profiles if you do not add it to field-level security.34.png

Step 4 allows you to choose which page layouts you would like to add this field too. Once this step is completed, please confirm the fields has been added to the desired page layout. After this is completed, the field created will show within the ‘Choose Salesforce Field’ when mapping the custom field.


It’s important to mention that these fields will need to be created and added to the Page Layouts for each custom field you would like to display and for each object they will be displayed on. 

Chargify’s Salesforce Quoting

When an opportunity has a subscription preview attached the subscription preview can be used as a quote versioning system to help negotiate the pricing of the opportunity before it is closed/won. Once the opportunity is closed/won the newest generated quote will be used to create the subscription.

These options can be found by clicking into the desired subscription preview.


Once inside the subscription preview you will find a button labeled “Generate Quote”. Clicking this button will generate a quote that can be shared with your customer.


If the quote’s price needs to be changed due to customer negotiation you can click the edit button on the subscription preview page. This will reopen the subscription wizard and the subscription preview can be reconfigured. After the subscription changes have been saved in the wizard you can then click “Generate Quote” and another version of the quote will appear in the subscription preview. In this example 50 components were removed and a new version of the quote was generated.


Clicking into the quote will show the information on the quote as well as a downloadable PDF that can be shared with a customer for approval.


The design of the PDF can be customized and branded in the Salesforce Visualforce pages.


Additional options for how the quoting system will function can be found in “Chargify Configuration” tab under “Opportunity Configuration”. Here you can require customer or sales manager approval before the subscription preview will convert into an active subscription in Chargify.

If Manager Approval is selected an approval will be needed before the Customer Approval is input.

Please note that the Customer Approval button will need to be added to the subscription preview page from the layout edit page. Additionally the “Manager Approval” uses the standard Salesforce approval processes and will need to be added as well.



Custom Offer Signup Pages

The Custom Signup Page is an externally available offer summary page, that can be shared with an external prospect looking to become a subscriber. This is typically used to present an offer at signup. 


Generating Custom Offer Signup Link

To generate Custom Offer Signup link go to Opportunity > Chargify Subscription Preview and click “Generate Offer URL” button:

Screen_Shot_2022-08-01_at_9.31.04_AM.png Templates for Signup Pages

The pop up will list the templates available through your configurations 

Note:  The link will be valid until the displayed “Valid Until” date. After that day, the customer will see an offer expiration message 'This offer has expired.'. To prolong the offer, a new link needs to be generated. (Admin Tip: expiration message can be customized in the Site Template: OfferExpiredMessage).




Default validity dates are populated for each template record, they can be overridden for a new Signup page upon clicking the date and entering a new one.

If the offer has been changed after the link was generated (Subscription Preview modified: i.e. product or component updated), the modification error message will be displayed on the page and subscription creation from the page will be blocked. A new link needs to be generated for an updated offer (Preview). 

Modification error message: custom message from Preview_Changed_Message__c or 'Your offer was modified. Please contact our Sales team to get the new URL.'

Upon filling in payment details and clicking the “Place Order” button, consent checkboxes validation (optionally) and gateway validation are performed. If any of the required consent checkboxes is not selected, either the custom message from Missing_Consent_Agreement_Message__c field or the default one (if field is left blank): 'Check all required agreements to accept the offer.' will be shown.

If there is an error during gateway validation, the error from gateway will be shown to the user.

Upon passing gateway validation, the subscription is created both in Chargify and Salesforce. Custom Offer Signup page displays ‘Your subscription was successfully created.’ or custom message from Success_message__c.

Once the subscription is created, the same link cannot be used to create another subscription. Custom Offer Signup page will show “Subscription is already created” message or custom message from Subscription_Exists_Message__c.

Customer Information, Shipping Address and Billing address are fetched from data in Salesforce. Plan Summary details are dynamically fetched from Chargify each time the offer is opened.


Using the Custom Offer Signup Pages

The generated link can be shared with customers/prospects for self-servicing subscription signups. The link is unique to the offer and customer, however anyone with the link can view and submit. 


Offer can be generated in the following scenarios: 

  • When Subscription Preview is not already sent nor queued to be sent
  • When Subscription Preview is not canceled
  • When a new Subscription('Upgrade' subscription type not supported)
  • When a Subscription Preview is approved by the manager if the approval is required

Once template is selected the action generates a Custom Offer Signup Link, copies this to the clipboard and opens in a new browser tab.


This Signup Form is generated by Salesforce using Chargify JS to facilitate an in Salesforce workflow for self-service subscriptions.



Error Messages / Troubleshooting Signup Pages

When subscription creation fails, a customer is presented with an error message and the event log with details is created in Salesforce -> Chargify Event Log.

If there is some error during page rendering, it will be shown to the customer and logged into Salesforce. Possible error messages:

  • 'There was a problem with decoding data from your offer link. Please contact our Sales team to get the new URL.’ - for broken link with empty or missing data;
  • 'There is a problem with your offer. Please contact our Sales team to get the new URL.' - when Chargify Subscription Preview or Chargify Signup Page record was deleted from Salesforce;
  • 'There is a problem with your offer. Please contact our Sales team to get the new URL.' or message from Error_Message__c - for an unexpected error.

To attach error log at the end of default or custom error message, check Show_Error_Log__c field on Chargify Signup Page record.


One time Invoice

Salesforce users can generate customizable one time invoices for existing subscriptions. To use this feature in Salesforce navigate to Setup > Object Manager. Once in object manager select Chargify Subscription > Page Layout > Chargify Subscription Layout.

On the layout edit page click Buttons and drag “Create New Invoice” down to the “Standard Buttons” area of the page.


Next, click “Mobile and Lightning Actions” in the page layout editor. Drag “Create New Invoice” down to the “Salesforce Mobile and Lightning Experience Actions” section of the page. Click Save.

After the setup has been completed users will find a “Create New Invoice” button when looking at a subscription in Salesforce.

When clicked a customizable invoice template will appear.


In the top left corner merchants can fill in their company name and address.

Below that clicking on the pencil icon will allow users to input custom billing and shipping information for this invoice.

Clicking on “Add New Line” will prompt users to input a line item for this invoice. Multiple line items can be added to each invoice.


Once the invoice looks correct clicking on the “Issue Invoice” button at the bottom will generate this invoice in Chargify. The Chargify version of this invoice can be seen by navigating to the subscription in Chargify and clicking on “Invoice” and locating the recently generated invoice.

Was this article helpful?
0 out of 0 found this helpful