Vantiv Salesforce Integration Chargent

Integrating Worldpay by FIS (Vantiv eCommerce - formerly Litle) and Salesforce using Chargent

worldpay from FIS

Easily connect Vantiv and Salesforce with Chargent,

the leading payments app on the Salesforce AppExchange. See all Vantiv transactions, manage refunds, send payment links and more, all inside Salesforce.

Not yet a Chargent customer?
Contact us for a no-obligation 30 day trial, and see for yourself!

Note: Worldpay by FIS has many merchant solutions for different types of businesses. The Chargent integration is specific to Worldpay’s primary US Gateway which is Vantiv eCommerce (Formerly known as Litle Transact).


Chargent Payment Processing for Salesforce is the leading payments application available on the Salesforce AppExchange. Chargent can connect Salesforce to Vantiv's ecommerce payment gateway (formerly Litle Transact) in just a few steps listed below. You will then be able to process credit cards and ACH payments through Vantiv directly from Salesforce.

Installation and Configuration of Chargent

  1. Install both Chargent Base and Chargent Transactions into your Salesforce org.

  2. Configure Chargent according to the step by step Quick Start Guide.

Vantiv Setup in Salesforce

Connecting Vantiv & Salesforce using the Chargent Setup Wizard

  1. Click on the App Launcher on the top left side in Salesforce.
  2. applauncher
  3. Select Chargent as the App
  4. Select the Chargent Settings Tab
  5. Choose Chargent Setup Wizard
  6. Select Yes when asked if you have a Payment Gateway account.
  7. Select Vantiv from the dropdown and follow the prompts to configure your gateway

payment gateway

You will need the following information to configure the gateway:

  • Select Test Transactions for Sandbox or Live Transactions Production.
  • Add your credentials: If testing in Sandbox, Vantiv doesn’t require you to have an account to test with their Sandbox environment. Only Pre-Live, Post-Live, and Production (live) environments will require credentials.

    • Username: Your Vantiv Username (any random username for Sandbox)
    • Password: Your Vantiv Password (any random username for Sandbox)
    • Merchant ID: Your Vantiv Merchant ID (any random username for Sandbox)

If you are testing using test data in Production make sure to select the Test Transactions option (default). Salesforce Production environments will send to the Vantiv Sandbox, when this option checks the Test Endpoint box on the Chargent Gateway record.

Chargent in Salesforce Sandboxes always sends to the Vantiv Sandbox (details below).

Continue through the Setup:

  • Use Tokenization? (recommended)
  • Select your Payment Gateway Currency (USD, CAD, etc..)
  • Do you want to use Payment Console? (Requires Platform Edition and higher)
  • Select the Payment Methods you accept
    • Card: Credit Cards you will be accepting? (Visa, MasterCard, etc…)
    • Bank Account: If your Gateway allows for bank account transactions, you should set the Direct Debit Network to ACH for Vantiv.
    • ACH Validation (optional - disable if you are not using Lyon’s Validation): If you use Lyons ACH verification, you should enable this feature to validate ACH transactions. The ACH Validation feature works with Lyon’s ACH Validation service to validate the bank account, and store the validation in your Salesforce Org. During your Gateway Setup you will authenticate your Lyon's credentials and Chargent uses a referral relationship for all first-time transactions.

    Select payment methods

  • Setup your Payment Console (Premium feature for Platform Edition)
    • Show Charge Button
    • Show / Create Update Token Button
    • Show Authorize Button
  • Will you be using recurring, scheduled, or installment payments? Do you want to set up Chargent Recurring Billing for subscription billing.
    • If Yes, you will be prompted to select the time. Chargent recommends 3am but you can choose no and select the days and times of the week for the batch to run.

Congratulations! You successfully configured a new gateway. Now you can easily start payments.

Direct Debit Network

Starting with Chargent version 6.15, you can now select the Bank Account network for your region during the gateway setup process. uses the ACH Network. This will allow for the correct Direct Debit Network fields to be displayed on Payment Requests and Payment Console based on your region.

You should choose ACH - US as the network. ACH is also known as echeck or electronic check.

  • US - ACH (also known as echeck or electronic check)

Select the Payment Methods You Accept

Once you have your Direct Debit Network set, you will see the appropriate field names on your Payment Request that are sent as well as your internal Payment Console.

Payment Request Bank Account

Connecting Vantiv & Salesforce (Chargent versions prior to v5.40)

  1. Click on the AppLauncher on the top left side in Salesforce.

  2. applauncher

  3. In the Search for apps or items box, Search for Gateways and select

  4. items box

  5. Click New

  6. Select Vantiv as the record type

  7. Add your credentials: If testing in Sandbox, Vantiv doesn’t require you to have an account to test with their Sandbox environment. Only Pre-Live, Post-Live, and Production (Live) environments will require credentials.

    • Username: Your Vantiv Username (any random username for Sandbox)
    • Password: Your Vantiv Password (any random username for Sandbox)
    • Merchant ID: Your Vantiv Merchant ID (any random username for Sandbox)

    If you are testing using test data in Salesforce Production, make sure to check the Test Endpoint box. Salesforce Production environments, when the Test Endpoint box is checked, will send to the Vantiv Sandbox.

    Chargent in Salesforce Sandboxes always sends to the Vantiv Sandbox (details below).

  8. Setup the following Gateway fields

    • Check the Active box - To make the Gateway active
    • Use Tokenization - If you are planning on using Vantiv tokenization
    • Available Card Types - Select the cards you will be accepting (this is based on your gateway settings and what card types they can process - Visa, Mastercard, American Express, etc..)
    • Available Payment Methods - Will you be accepting just Credit Cards or ACH (also known as electronic check, e-check, or direct debit)
    • Available Currencies - What currencies will you accept (this is based on your payment gateway and the currencies they accept).
    • Credit Card / Bank Account Data Handling - This lets Chargent know when to clear the information in Salesforce. You have 4 options.

      • Never Clear
      • Clear After Successful Charge
      • Clear After All Transactions
      • Clear When Token is Present (recommended)

      vantiv test

      When using Payment Requests or Payment Console the following should also be set. Please note these features come with Sites and Platform edition & require activation in your Production Org.

    • Available PR Transaction Types

      • Charge Full Amount - Charges the credit card immediately
      • Authorize Full Amount - This option won’t charge the card but only holds the funds available until you charge the card.
      • Authorize Minimum Amount - This option won’t charge the card but only holds the minimum amount that your gateway will allow. You will need to charge the correct amount in order to capture the transaction.

    • Show Charge Button
    • Show Authorize Button

    • tokenization

Testing Vantiv in Salesforce

Notes on Vantiv Endpoints

Chargent is set up to allow testing using the Vantiv Sandbox and sending live transactions to your Vantiv Production (Live) account. Additional testing may be done using Vantiv Pre-Live and Post-Live environments, which Vantiv may have provided you credentials to. These test environments behave more like the Vantiv production account.

Vantiv Pre-Live environment allows you to run additional tests using test credit card data. The test credit card you use will allow you test your credentials and make sure Chargent is communicating with your gateway properly to approve transactions. Post-Live environment is the one for regression testing of changes to your Salesforce system after you go live and are sending transactions to production.

To send Pre-Live or Post-Live tests from Salesforce, you need to update the Endpoint Override field on the Chargent Gateway record with the correct Endpoint URL, and make sure corresponding remote site settings are active.

By default the Test Endpoint checkbox in the Gateway record goes to the Sandbox URL so you want to make sure you have this unchecked if you are using the Endpoint Override.

Testing Using Vantiv Sandbox

Create a Chargent Order in Salesforce to run test transactions

  1. Click on the App Launcher in the top left side and select Chargent as the App.

  2. testing

  3. Click the Chargent Orders Tab.

  4. Click on New

  5. Enter in the following information:

    • Account: The Account the Chargent Order should be associated with.
    • Gateway should be Vantiv ( if you are using multiple active gateways)
    • Charge Type should be either credit card or Check depending on if you are testing credit cards or electronic check (ACH or direct debit)
    • Billing Information

      • Billing First Name
      • Billing Last Name
      • Billing Address
      • Billing City
      • Billing State / Province
      • Billing Zip Code / Postal Code
      • Billing Email Address (if you want to test the email receipt that gets triggered upon a successful transaction)

    • Charge Amount (check the Manual Charge if you are testing a specific amount. If you are entering Subtotal, Tax, and Shipping then the Charge Amount will default to the Balance Due and the Manual Charge box should not be checked)
    • Credit Card Number = This can be any random 16 digit string of numbers
    • Card type (Visa, MasterCard, etc..) or Bank Account Type for ACH (Checking or Savings).
    • Card Expiration Month and Card Expiration Year should be in the future


  6. Click Save

  7. You can now test the Charge buttons to process the transaction.

  8. When you click the Charge button you will receive a pop-up asking for the CSC (Card Security Code). This can be any 3 digits for Visa, MasterCard or Discover or 4 digits for American Express when testing in the Sandbox.

  9. card security

  10. Press the Charge button

  11. You should receive a popup that shows the test transaction was approved.


Testing Pre-Live/Post-Live Vantiv from Salesforce

  1. Obtain Test Credentials for Vantiv Pre-Live/Post Live environments in Salesforce

    • Contact Vantiv and have your IP addresses whitelisted
    • Obtain the Test Credentials from Vantiv
    • Log into your Vantiv Pre-Live/Post Live Reporting environment

    •     Pre-Live:

    • Go to Presenter Credentials
    • Credentials expire every 6 months. If the existing credentials have expired, you may need to generate a new set.
    • Click the Eye icon to decrypt the Password and then copy it.

    • presenter

You also need to make sure you have the Remote Sites added to your Remote Site Settings in Salesforce.

Click the gear icon on the top right and select Settings

  • Under Security select Remote Site Settings
  • Click the New Remote Site Button

    • Remote Site Name = Vantiv PreLive or PostLive
    • Remote Site URL

      1. Pre-Live URL:
      2. Post-Live URL:

    • Check the Active box
    • Click Save

For detailed testing parameters, you may wish to obtain a copy of the current Vantiv LitleXML Reference Guide PDF from your Vantiv Implementation Consultant. Chargent's Salesforce connection to Vantiv has already been certified, so testing is primarily necessary to verify any Salesforce configuration and your merchant credentials.

Vantiv Test Credit Card Numbers

Please note that these test card numbers are only for the test environments, and should never be used in the live, production environment.

If you wish to do more extensive tests, Vantiv can provide detailed transaction data (name, address, amount, card numbers, etc.) and the expected responses that they will return. However, this level of testing is not required as Chargent has already certified its Salesforce pre-built integration with Vantiv.

Vantiv Test Credit Cards

Account Number Card Type CVV2/CID
4457010000000009 Visa 349
4457010100000008 Visa 992
4457010140000141 Visa N/A
4457010200000247 Visa N/A
4100200300011001 Visa 463
4100200300012009 Visa N/A
4100200300013007 Visa N/A
4100200310000002 Visa N/A
4024720001231239 Visa N/A
4457012400000001 Visa N/A
4457013200000001 Visa N/A
4457119922390123 Visa N/A
4457000300000007 Visa N/A
4457000100000009 Visa N/A
4457003100000003 Visa N/A
4457000400000006 Visa N/A
4457000200000008 Visa N/A
4457000800000002 Visa N/A
4457000900000001 Visa N/A
4457001000000008 Visa N/A
4005550000081019 Visa N/A
4000000000000001 Visa 555
5112000100000003 Mastercard N/A
5112002100000009 Mastercard N/A
5112002200000008 Mastercard N/A
5112000200000002 Mastercard N/A
5112000300000001 Mastercard N/A
5112000400000000 Mastercard N/A
5112010400000009 Mastercard N/A
5112000600000008 Mastercard N/A
5112010000000003 Mastercard 261
5112010100000002 Mastercard 251
5112010140000004 Mastercard N/A
5500000254444445 Mastercard N/A
5592106621450897 Mastercard N/A
5590409551104142 Mastercard N/A
5587755665222179 Mastercard N/A
5445840176552850 Mastercard N/A
5390016478904678 Mastercard N/A
5112010201000109 Mastercard N/A
5112010202000108 Mastercard N/A
5194560012341234 Mastercard N/A
5435101234510196 Mastercard 987
5112000900000005 Mastercard 758
6011010000000003 Mastercard N/A
6011010100000002 Mastercard 184
6011010140000004 Mastercard N/A
375000026600004 American Express N/A
375001000000005 American Express N/A
375001010000003 American Express 0421
375001014000009 American Express N/A
341234567890127 American Express N/A

Vantiv Test eCheck Number

accType accNum routingNum
Checking 4099999992 011075150
Checking 1099999003 011100012
Checking 1099999999 011100012

Sending Live Transactions from a Salesforce Sandbox

When Chargent is installed in a Salesforce Sandbox, transactions are always sent to the Vantiv Sandbox environment, regardless of whether Chargent's Test Endpoint checkbox is checked (or whether you select Live Transactions during the wizard setup). This is done as a security precaution, to prevent real transactions from being accidentally sent from a Salesforce Sandbox.

When Chargent is installed in a production or developer Salesforce org, the Test Endpoint checkbox on the Gateway record will select between sending to Vantiv’s live and test environments.

If you wish to send live transactions from a Salesforce Sandbox, as a final step in testing, you need to set up a Gateway record using your Production (Live) Credentials and simply use Chargent's Endpoint Override field to enter the production endpoint of your chosen gateway there.

Here is the production endpoint URL for Chargent's integration with Vantiv:

Note that the full endpoint URL must be entered in the Endpoint Override field and the Remote Site for the domain must be active in your Remote Site Settings.

Moving to Production

Once you have completed testing of your Chargent configuration and Salesforce connection to Vantiv, you are ready to move to processing live transactions.

In your Production Org, delete or deactivate the Vantiv Sandbox / or Pre-/Post-Live and create a new Gateway Record for your Vantiv Live environment:

Complete the Vantiv gateway record in Salesforce using the Gateway Wizard or Manual Setup described above. Your Merchant ID provided to you by Vantiv and the Presenter Credentials available in the live reporting interface:

Test credit card numbers should not be used in the live environment. If you wish to test a few live transactions with your own credit card, you can void them immediately after, to prevent the transactions from settling and capturing funds. Just click on the related transaction record in Salesforce and press the Void button.

Please keep in mind that fees may be charged on all transactions sent to the live, production environment, so a few real tests are recommended, but the majority of testing should be done in the Vantiv Prelive environment.

Vantiv Tokenization

Chargent's Salesforce integration with Vantiv supports tokenization, which replaces credit card numbers or bank account numbers with a reference code called a token. The account number is then stored in Vantiv's vault, and the token is stored in your Salesforce account and referenced for future transactions.

Since you do not store the customer's credit card account information, the scope of PCI compliance is reduced, and if your systems were ever breached only tokens that can only be used with your account are stored in Salesforce, rather than any critical customer account numbers.

AppFrontier recommends that you consult your own legal and PCI Compliance resources regarding how customer data should be handled, but we also offer a Salesforce PCI Compliance guide to provide a useful overview.

Vantiv Token Format

Vantiv Tokens are similar in format to the credit card originally submitted, in that they are the same length as the original credit card number (typically 16 digits), and the last 4 digits of the token are the same as the card. Since Vantiv tokens are stored in the unencrypted Token field in Salesforce by Chargent, this makes them convenient for customer service or other members of your staff to refer to with customers, without knowing or having access to the original account number.

For Vantiv eCheck / ACH tokens, because bank account number length can vary widely, Vantiv made these tokens a uniform length of 17 digits. Unlike credit card tokens, the entire eCheck token number is randomly generated.

To set up Vantiv Tokenization in Salesforce:

  1. Confirm with your Vantiv Account Representative that your account is enabled for tokenization.

  2. Check the Use Tokenization checkbox in the Chargent Gateway record you have set up for Vantiv

  3. Set the Credit Card Handling field (unless you are using Payment Console)

    • Never Clear: Chargent will not remove any card data automatically.

    • Clear After Successful Charge: Chargent will clear the credit card number, expiration dates and card security code only after a successful charge is run.

    • Clear After All Transactions: The credit card number, expiration date and card security code will be erased after any transaction (Charge, Void, Refund)

    • Clear When Token Present: Only when a token is present in the token field, will the credit card number, expiration date and card security code be cleared.

Using Tokens

  • Tokens are obtained either through the Register Token process, which Chargent's Payment Console feature enables, or when your first approved Charge or Authorization is sent.

  • The Vantiv token is stored in Chargent's Token field in Salesforce.

  • The Credit Card Number field value will be deleted (based on your Credit Card Handling field settings), and a token will be stored for future transactions (or if you are using Chargent's Payment Console feature, the card number was never stored during the generation of the token)

If you are migrating from another system, you should be able to import Vantiv tokens into Chargent's Token field in Salesforce. Tokens would need to be associated with the same customer in Salesforce that the token was generated for. Please contact us for assistance or more information.


Automatic Account Updater (AAU)

Avoid missed / failed payments by enabling Vantiv’s Automatic Account Updater. Contact your Vantiv rep to enable this feature. Once enabled, Chargent will capture a new token for any failed card or ACH payment as long as the new payment data has been updated at the Gateway level.

NOTE: The decline reason must be related to a potential account change. For instance, an update will not occur for declines due to insufficient funds. It can take a couple of days before updated information is received.

The next time Chargent attempts to collect the payment with the outdated card information, the transaction has a better chance of success because Vantiv has passed the updated token back to the Chargent Order record.

Chargent supports Vantiv Account Updater beginning in Chargent 5.81, and can update any token in need of repair. When a credit card changes on Vantiv’s side, and the token for the original credit card is sent, Vantiv will send back an updated token related to the new card. Chargent will then write the new token back to the token field on the Chargent Order.

This token replacement will happen seamlessly in the background when the Chargent Recurring Batch runs, or when you process a payment manually using the Payment Console. The following are required

  1. Vantiv’s Token Updater service
  2. Vantiv v12 credentials in your Gateway setup in Salesforce
  3. Select v12 in the “Gateway Version” field in your Gateway setup

Unreferenced Bank Credit

An Unreferenced Bank Credit gives you the ability to send money from a Chargent Order directly to a customer's bank account.

In order to send an Unreferenced Bank Credit you need to be on Chargent version 5.81 or newer. If you are on an older version of Chargent you want to upgrade your current packages using our PIM (Product Installation Manager) on our Installation page.

To send an Unreferenced Bank Credit using Chargent you need to make sure you have the Credit Button and the Credit Amount field visible on your Salesforce Page Layout.

To create an Unreferenced Bank Credit you want to create a new Chargent Order.

  1. Click on the App Launcher and select Chargent App

  2. Hit the New button to create a new Chargent Order

  3. Make sure the following fields are populated

    • Account
    • Payment Method = Check
    • Credit Amount: The amount of the Direct Credit.
    • Bank Account Type: Checking or Savings.
    • Bank Account Number
    • Bank Routing Number
    • Bank Account Name: The name of the individual who holds the bank account.
    • Bank Name: The name of the institution where the bank account is held.


  4. Click Save

  5. You can now press the Credit button at the top (it may be under the drop down). If you don’t see the Credit button, you will want to make sure it’s added to the correct Page Layout and is accessible by your Salesforce Profile permissions.

You will then see an approved transaction.


Gateway Version Update

In order to support newer features by Vantiv you should be sure you have Chargent version 5.81 or newer. If you are on an older version of Chargent you will want to upgrade using our PIM (Package Installation Manager). Chargent v5.81 has updated the integration to work with both Vantiv API v8 and Vantiv API v12. If you recently upgraded Chargent you will need to add this field to your Gateway Page Layout and select the version of Vantiv to work with.

If you have been on Vantiv for some time, you likely will need to select v8. To use newer features such as the Account Updater, request v12 credentials from the Vantiv Implementation team. (Please note that it may take Vantiv 2-6 weeks to generate these credentials).

To add this to the layout:

  1. Click the gear icon on the top right and select Setup
  2. Under Objects and Fields select Object Manager
  3. Choose the Gateways object
  4. Under Page Layouts select Vantiv Litle Layout
  5. Drag the Gateway Version field into the Page Layout and click Save


Next you want to update this field on the Gateway record.

  1. Click the App Launcher on the top left side and search for Gateways
  2. Click the Vantiv Gateway record
  3. Click Edit
  4. Click Advanced Features
  5. Select the correct Vantiv version from the drop down.
  6. Click Save


Salesforce to Vantiv Field Mapping

Here are a few relevant fields and their mappings between the Chargent software in Salesforce and the Vantiv system.

Gateway ID
Vantiv Payment ID
Invoice Number
Merchant Order Number
Invoice Number
Merchant Transaction ID
Salesforce record ID (of Chargent Order, Opportunity, or Case)
Customer ID

Note: If you do not populate the Invoice Number field, Chargent will auto-populate the calls to Vantiv with the format "ChargentOrder071414100533" where the first 6 numeric characters indicate the date.

Congratulations! You have successfully integrated Salesforce and the Vantiv Payment Gateway using the Chargent Payment Processing for Salesforce software. You can now process one-time or recurring credit card payments through Vantiv directly from Salesforce.

If you have any questions or need assistance, please contact us.