Step 1: Package Installation
Prerequisites
Packages
- Salesforce CPQ 222.2, or later must be installed first.
- Salesforce Billing, Version Summer ’19 220.7 or later must be installed first.
- Consumption Schedule must be enabled. Contact Salesforce support for enablement if needed.
Install Links
Chargent Gateways Connector for Salesforce Billing
Step 2: Salesforce Organization Setup
Add Gateway Type
In order to add Chargent gateways to your Salesforce Billing setup, you will first need to create a new Gateway Type in the Global Value set. To do this simply:
- Navigate to Salesforce Setup
- In the search box type “Picklist Value Sets”
- Click on “Picklist Value Sets”
- Find the “Gateway Type” value set
- Click On the “Gateway Type” label
- Click “New” under values
- Type “Chargent Gateway” in the text box – exclude the quotes
- Check the box that reads “Add the new picklist values to all Record Types that use this Global Value Set.”
- Click the [Save] button
Permission Set Assignment
Assign the “Chargent Gateway Admin” permission set to users who will set up and / or edit the Gateway records. Typically, it is advised to only provide this permission to Admin users.
- Navigate to Salesforce Setup
- In the search box type “Permission Sets”
- Click on “Permission Sets”
- Click on “Chargent Gateway Admin”
- Click the [Manage Assignments] button near the top of the screen
- Click the [Add Assignments] button
- Check the box next to users you wish to grant access, then click the [Assign] button.
Add Chargent Gateway to Custom Setting
- Navigate to Salesforce Setup
- In the search box type “Custom Settings”
- Click “Custom Settings”
- Next to Payment Gateway Config click “Manage”

- Click the [New] button
- Complete the Fields:
- Name
- Chargent Gateway
- Gateway Class Name
- ChrgntBllng.ChargentGatewayAPI
- Name

- Click the [Save] button
Update the Payment Gateway Page Layout
NOTE: Completing this step can be done in two ways; Adding the “Chargent Gateway” field to the default “Payment Gateway” page layout, or assigning the “Chargent Gateway Layout” to the needed profiles. We recommend the first option, adding the “Chargent Gateway” field to the default “Payment Gateway” page layout, as it’ll ensure that your “Payment Gateway” layout remains as up-to-date as possible in cases where Salesforce.com updates this Object.
To add the “Chargent Gateway” field to the Payment Gateway Layout, follow these steps:
- From the Salesforce Setup page, click the “Object Manager” tab
- Click on “Page Layouts” in the left-side menu
- Click “Payment Gateway Layout”
- From the “Fields” section of the palette, drag the “Chargent Gateway” field (ChrgntBllng__Chargent_Gateway__c) onto the Payment Gateway layout
- Click the [Save] button
If you wish to instead assign the Chargent Gateway Layout to the appropriate profiles, follow these steps:
- From the Salesforce Setup page, click on the “Object Manager” tab
- Click on “Payment Gateway”
- Click on “Page Layouts” in the left-side menu
- Click the [Page Layout Assignment] button
- Click the [Edit Assignments] button
- Select the appropriate profiles (those you wish to use for this feature). Hold the CTRL button while clicking to choose multiple profiles
- From the “Page Layout to Use” picklist, choose “Chargent Gateway Layout”
- Click the [Save] button
Step 3: Setup Your Chargent Gateway Record
- Click the App Launcher icon
at the top-left of the screen
- Search for and click on “Chargent Settings”
- Click the “Chargent Setup Wizard” tab
- Choose your payment gateway from the picklist
- Enter your payment gateway credentials, then click the [Sign In] button
- Choose whether to enable Tokenization. (We highly recommend enabling it in order to protect yours and your customers’ data.)
- Select the Currency Types you plan to accept, then click the [Continue] button
- Select the Payment Methods you plan to accept, then click the [Continue] button
Step 4: Salesforce Billing Payment Gateway Setup
- Click the App Launcher icon
at the top-left of the screen
- Search for “Payment Gateways,” then click on “Payment Gateways”
Note: There will be two different Payment Gateway objects. You want to select the one that is installed with the Billing Connector package.

- Click the [New] button
- Complete the following fields:
- Payment Gateway Name
- Check the Active box
- Check the Default (Based on your requirements)
- Gateway Type should be Chargent Gateway (See organization setup above if not present)
- Chargent Gateway – Lookup to the Chargent Gateway record you created in the previous step
- Click the [Save] button
