Setting Up Chargent Terminal

Chargent Terminal is a separate app from our standard Chargent package, allowing you to process payments through Salesforce with a physical terminal. Both are sold individually and work separately from each other but can be integrated to work together. This guide provides step-by-step instructions to guide you through the installation and configuration process.

What is Chargent Terminal?

With Chargent Terminal, you can reduce your payment processing fees, take payments on the spot, and reduce the scope of your PCI compliance, all within Salesforce.

Chargent Terminal lets you take card-present (CP) transactions initiated from Salesforce. These transaction requests are sent to a physical PoS device, aka terminal, and processed securely by your payment processor. The purpose of a terminal is to verify that the transaction is being conducted with an authentic credit card presented by the card’s genuine owner. A record of all transactions is stored in Salesforce, allowing you to track all your payment data in one place.

Contact our sales team to get started with Chargent Terminal today.

Before You Begin #

Before you start implementing Chargent Terminal in your org, consider the following supported terminals and processors.

Supported Terminals

AppFrontier supports the GoDaddy Poynt Smart Terminal, Poynt 5, and Poynt/Newland N910 to connect to Salesforce, allowing POS and Salesforce integration. To learn more about Poynt’s terminals, check out GoDaddy Poynt Smart Terminals.

Supported Payment Processors

A payment processor is the entity responsible for moving money from the customer account to the merchant account. Your physical Poynt terminal communicates with your payment processor when you generate transactions in Chargent Terminal.

Processors supported by Chargent Terminal

• TSYS (recommended)
• Elavon
• Vantiv
• FisServ / First Data

Installing & Configuring Chargent Terminal #

Installing Chargent Terminal

First, install the Chargent Terminal package into your Production or Sandbox Org. Installation is easy using the Package Installation Manager (PIM). You can access the PIM to install or update Chargent Terminal on our website.

1. Click Update Chargent. You will need to log in to your Salesforce Sandbox or Production org.
2. Click Allow to grant access and install Chargent Terminal.
3. Click Terminal to install or update Chargent Terminal.

Note: The Chargent package is not required to use Chargent Terminal. If are interested in learning more about the Chargent package, see Chargent Payments for Salesforce.

It will take a few minutes to complete the installation. We recommend that you refrain from navigating away from the PIM webpage during installation. Some browsers include a memory mode that may interrupt your installation.

Once you have installed Chargent Terminal, you will see Terminal checked with a checkmark, indicating that the package has been installed and is up to date.

License Assignment

Now that you’ve installed Chargent Terminal, the next step is to assign licenses. Licenses only need to be assigned in Production. They don’t need to be assigned in your Salesforce Sandbox.

To assign licenses, follow these steps:

1. Click on the Gear Icon and click Setup.
2. In Quick Find, search for and click Installed Packages.
3. Click Manage Licenses to the left of Chargent Terminal, as shown below.

Note: You may be in a sandbox environment if you do not see a Manage Licenses link.

5. Click Add Users and select the checkbox next to those requiring access to Chargent Terminal.
6. Click Add.

Permission Sets

Chargent Terminal Permission Sets are assigned using the Chargent Terminal Setup Wizard (covered in the next section). There are three Permission Sets related to Chargent Terminal.

• Terminal Admin – Has the ability to assign permissions and administrate the Chargent Terminal app in Salesforce.
• Terminal User – Has access to Reset Terminal Connection and can see Terminal history.
• Terminal Unlinked Payments – Has the ability to view and assign Chargent Terminal Unlinked Payments. For more information about Unlinked Payments, see the Unlinked Payments section of this guide.

Chargent Terminal Setup Wizard

Once Chargent Terminal is installed in your Salesforce Org and you have assigned licenses, you must configure your Salesforce Org to connect with your terminal.

1. Click the AppLauncher and select the Chargent Terminal app
2. Click the Terminal Configuration tab
3. Select Setup Wizard from the menu
4. Follow the step-by-step wizard to configure your terminal(s) in Salesforce:
   • Add Remote Site 
   • Add Permissions
     • Terminal Admin
     • Terminal User
     • Terminal Unlinked Payments
   • Business Authorization: Authenticate with Poynt HQ and select the Store(s) that will be associated with this Salesforce Org.
   • Push Topic: This enables the Salesforce Streaming API to send details to the terminal.
   • Click Finish

Assign a Default Terminal

If multiple terminals are used for different areas of your business, you can set the default terminal for the user you are currently logged in as.

1. Click the AppLauncher and select the Chargent Terminal app
2. Click the Terminal Configuration tab
3. Select User Terminal from the menu.
4. From the drop-down menu, select the correct terminal as the default.
5. Click Save Default Choice

All transactions sent from this Salesforce user will now be sent to the terminal you set as the default.

Add the Chargent Terminal Component

Chargent Terminal was written to work with your existing lightning pages on any object in Salesforce!  

1. Click the gear icon on an object record page of your choice, click Edit Page
2. From the left side, under Custom – Managed, drag Chargent Terminal onto the Page.

3. Click Save
4. Activate the page (if prompted)

Using the Terminal Payments Object #

There is an object that comes with the installation of Chargent Terminal called ‘Terminal Payments’. All transactions processed in your Poynt HQ account, including those from the terminal, are represented in Salesforce as a Terminal Payment record.

Terminal Payment Actions

The app will only show actions that are valid for the specific Terminal Payment record. When there are no actions displayed, this means that there are no actions allowed on the Terminal Payment record.  

From the Terminal Payment record, users may:

1. Void the Transaction – Available when the charge is still in an ‘Authorize’ status and removes the charge from the customer’s credit card.
2. Capture the Transaction – Used when you want to Capture the amount immediately or capture an amount different than what was originally authorized (an example would be tips or concession fees).
3. Refund the Transaction – Refunds are used for charges that have already been captured. Refunding the charge adds the funds back to the customer’s credit card.  You can refund the full amount or a portion of the transaction.

Processing Payments with Chargent Terminal #

From the Chargent Terminal Lightning Component, you can charge the balance due or a lower amount.

1. Enter the amount you want to charge and click Charge with Terminal. This will send the transaction to the Terminal for the transaction to be completed.

2. The customer will be prompted to do the following:
   1. Tap a card/phone or insert a card to be charged
   2. Add their signature on the screen
   3. Select a method of receipt

The available methods of receipt include:

• Send Text – They will enter their mobile phone number and receive a text message with a link to their receipt.
• Email – They will enter their email address and receive an email containing their receipt.
• Paper Receipt – Prints the receipt from the terminal.
• No Receipt – No receipt is sent or printed.

The terminal will return to the main customer screen once the receipt is sent or printed.

Note: Chargent Terminal is compatible with modern forms of payment, both card and mobile phone, including Apple Pay and Google Pay on compatible mobile devices.

Unlinked Payments #

Chargent Terminal Unlinked Payments originate from transactions made directly on the terminal, not from within Salesforce.

While we recommend that Chargent Terminal payments are initiated from Salesforce, there may be times when you need to process a charge directly from the terminal. Once synced to Salesforce, this will generate a Chargent Terminal Unlinked Payment record, including the credit card details and the charge information. The Unlinked Payment must then be associated with the correct Salesforce record.

You can follow the instructions below to sync your Unlinked Payments in Salesforce and associate them with the proper Salesforce record.

Unlinked Payments Permissions

Before working with Unlinked Payments, you must assign the ‘Terminal Unlinked Payments Permission Set’.

Note: Users with the Terminal Admin permission also require the Terminal Unlinked Payments permission to access Chargent Terminal Unlinked Payments.

To Add Permissions:

1. Go to the App Launcher and select the Chargent Terminal app
2. Click the Terminal Configuration tab
3. Select Permission Set Assignment(s)
4. Select Unlinked Payments
5. Select the Available Users who should have permission
6. Click Assign

CT Transaction Sync

To transfer your Unlinked Payments into Salesforce, you must run the CT Transaction Sync. Chargent Terminal Unlinked Payments can only be created if the sync is enabled. CT Transaction Sync can be scheduled or run on demand.

1. Click the AppLauncher and select the Chargent Terminal app
2. Click the Terminal Configuration tab
3. On the left select CT Transaction Sync
4. Choose Schedule to Schedule the batch to run daily or Choose Run Now to do an immediate Sync.
   1. ​​​​​​​Schedule: This will create a new Schedule Batch that will run daily. The time the batch will run depends on when you click the Schedule button. The time will be set for the next even hour on the hour, so if you press Schedule at 10:23, it will schedule it for 12:00. If you press Schedule at 11:45, it will also schedule it for 12:00. Also note that this batch will run every 2 hours syncing any transactions initiated from the terminal within the past two days.
   2. Run Now: Run Now will automatically run the Apex batch that syncs the Chargent Terminal Unlinked Payment but does not schedule a regular batch to run.  

View Chargent Terminal Unlinked Payments

After syncing your terminal transactions to Salesforce, you can query and view the Unlinked Payments that have not yet been associated with a record.

1. Click the App Launcher and select Chargent Terminal Unlinked Payments
2. Linked Object: Select the object the Chargent Terminal App is used on
3. Store Name: Select the store you’d like to search
4. Populate Date Ranges: Select the time frame you want to search
5. Click Query

Link a Chargent Terminal Unlinked Payment

After populating your Unlinked Payments, you can associate them to a record using the dropdown arrow to the right of the Transaction and select Link Record. Select the record and click Save.

Search for and select the record you want to link the transaction to and click Save.

A success message will appear, confirming that you have successfully connected an Unlinked Chargent Terminal Transaction to the correct Salesforce record.

Device Group Implementation #

Some customers have multiple Terminals in different locations and must group a subset of all terminals. This could be due to employees who log in to Salesforce from multiple stores and need to process payments based on each location. They don’t necessarily want to go through all terminals but only those within the stores they travel to.

Using Device Group Implementation, developers can create an API Class (cterminal.DeviceGroup), allowing you to define a list of terminals based on the cterminal.DeviceGroup class.

Once you have defined the list of terminals to the cterminal.DeviceGroup you can apply it in Salesforce under the Chargent Terminal Configuration.

1. Click the App Launcher and select the Chargent Terminal app
2. Click the Terminal Configuration tab
3. Select Device Group Implementation 
4. Enter the API Name for the class implementing cterminal.DeviceGroup
5. Click Save

Note: Device Group Implementation is not a commonly used feature. You will require a Salesforce Developer to implement this feature. Chargent support is unable to assist with custom development.

See Also

Payment Gateways vs. Payment Processors
Chargent Terminal: What are Unlinked Payments?
Grouping Chargent Terminal Visibility