Table of Contents |
---|
Summary
This article describes how to configure Vantiv as a token card processor in EngageIP. This integration is not iBiz based.
Vantiv Token card processing works by taking the credit card number, expiry date and security number and converting it to a token which can be used for regular processing so that the card number is not sent across networks every time sales are processed. Address information is NOT stored within the data represented by the token however, so for Vantiv, there is an AVS rate and non AVS rate. To get the AVS rate, you will need to have AVS checked in your credit card type to get the preferred rate. With that in place, EngageIP sends the customer name and address along with the Vantiv token for sales and refunds. If AVS is NOT enabled, the address is not sent with the request and you fall back to the non preferred Vantiv rate for processing credit cards.
Testing
Sandbox Environment
Note |
---|
Notice: Vantiv test servers and live servers are IP restricted, so if you see an error communicating, check with Vantiv support that the external IP of your test or production system is known and registered with them otherwise EngageIP will not be able to communicate at the URL entered. |
Vantiv offers a sandbox environment (simulator) that provides a basic interface for functional level testing of transaction messages. Typically, merchants using one of the available Software Development Kits (SDKs) would use the Sandbox to test basic functionality. This is a stateless simulator, so it has no historical transactional data, and does not provide full functionality. This environment is not intended for certification or regression testing.
See the page http://vantiv-ecommerce.github.io/sandbox/ for details on how to use the Vantiv sandbox.
Testing via EngageIP
In the Card Processor Configuration specify:
Gateway URL: https://www.testlitle.com/sandbox/communicator/online
Attribute: enter the Litle/Vantiv supplied username
Visa numbers can be taken from the sandbox page linked to above. There are card numbers to trigger successful processing and card numbers to trigger different kinds failures, so if you're just looking to test successes, pick the appropriate card number and add it to a user in EngageIP.
Desired Response | Credit Card Number |
---|---|
000: Approved | 4470330769941000 |
010: Partially Approved | 4658512425423010 |
100: Processing Network Unavailable | 4886883711815100 |
101: Issuer Unavailable | 4215176886320101 |
110: Insufficient Funds | 4488282659650110 |
Configuration
Token Card Processor Configuration
Create a Card Processor called 'Token Processor' (required so that the card type can be created)
In the AdminPortal load the Setup page
Click on Card Processors and configure it as displayed below:
Click Save
Card Type Configuration
Create the Card Type and assign the Token Processor to it
On the Setup page click on Card Types
Click Add
Set the Card Name, Type and Processor
Note: you must enable AVS (Address Verification System) if you wish to send data to Level3 in the Credit Card Token Processors configuration
Click Save
Credit Card Token Processor Configuration
On the Setup page click on Credit Card Token Processors
Click Add
Set the Attribute (Vantiv supplied username), Merchant Login (merchantid), Password and the Gateway URL (either Live or Test URL)
Click Save
Payment Type Configuration
Create a Payment Type and associate it with the Token Processor
On the Setup page click on Payment Types
Click Add
Set the Name and the Payment Type (must be 'Credit Card Token')
4. Click Save
Testing
To test your configuration:
Load a test account in the AdminPortal
Click on Tools and then Payment Methods
Click Add
Select Credit Card Token
Populate the required card details and click Save
You should see a message indicating the creation was successful, or a failure error
If the creation was successful submit a test payment to make sure it goes through (you can refund this amount from the Tools page as well)
When the test payment is made, load the Reports page and check the Payments report, it should show your test and include the approval code and transaction number
Vantiv Payment Reconciliation
To reconcile payments between Vantiv and EngageIP:
Access the Vantiv transaction report
Log in to EngageIP and click on Reports
Under the Owner Reports section click on the Payments report
The Transaction Number column vs. the 'Vantiv Payment ID' field should match
5. To filter the report to return the needed results click the Date column and enter the Min (start) and Max
(end) date that matches the period the Vantiv transaction report covers
6. Further filter the list by clicking the Payment Type column and selecting the appropriate payment type
(i.e. 'Credit Card') to filter out other payment results (cash, wire transfer, etc.)
7. Once you have the list filtered down to include only payments made through Vantiv you can compare
the report total (Amount column) vs. the total on the Vantiv transaction report to reconcile payments
Troubleshooting
Some cases come up where there are issues processing or updating credit cards, those scenarios will be listed here as they are encountered:
Card expiry date is reset/will not update when adding a new credit card
If you've added a credit card initially with an incorrect expiry date, Vantiv will have already generated a token with the incorrect expiry date. Adding the card again with a new expiry date may not work (the expiry date of the existing token on file with the same token ID may be used). To permit the expiry date update in situations where the expiry date was added incorrectly initially do the following
Ensure you have access to log into the Vantiv portal
Contact Vantiv support to have them reveal a hidden button in the portal which temporarily disables the auto updating feature of the expiry date (and the rest of the token info).
Log into the Vantiv portal and click the revealed button so that the token can be updated
Note: this feature will turn itself off after one token update
Changing MID Values (Account Name)
If you need to switch MIDs or Usernames and you need to refund a payment, simply login to the Vantiv gateway using the old account, refund it manually and then add a correcting transaction to EngageIP. Going forward, cards processed using new MID will be able to be refunded as long as they were initially processed with that MID