In order to integrate with Vantiv, formerly Litle, you will need to have a Vantiv merchant account set up through them. Then you will need to obtain your API credentials (username and password) in order to link Engaging Networks donation pages to your Vantiv Payments account. Once you've obtained your API credentials, please contact a Engaging Networks team member in order to have the gatway added into your account.
| Field | Description |
| Reference name |
A unique name for the gateway. It is a good idea for the name to include the type of gateway (eg. Vantiv), and whether it is a live or test gateway. |
| Select gateway |
Select ‘Vantiv Gateway’. |
| Username |
This is our API username. You will need to obtain this from Engaging Networks support. |
| Password |
This is our API password. You will need to obtain this from Engaging Networks support. |
| Merchant ID |
Vantiv uses a Merchant ID (MID) in order to correctly process the payments. |
| Test mode |
Should be checked for a test gateway, must be unchecked for a gateway that will accept live donations. |
The following fields need to be set up in the default supporter record and then added to the form in ‘build’.
| Form Field | Value type |
Comments |
| Email Address | Alphanumeric |
Email address identifying the supporter record |
| Payment Type | Alpha |
For card payment methods, one of the following values should be passed in (case sensitive): MasterCard = MC Amex = AX Discover = DI Diners = DC JCB = JC eCheck = EC ACHEFT = ACH |
| Donation Amount | Numeric |
Must be entered as a whole number or number with two decimals only. Eg. 50 dollars needs to be entered as ‘50’ or '50.00'. You can apply a form field validator to check for numbers only in the field. |
Not required for “pay via paypal”.
| Form Field | Value type | Description |
| Credit Card Number | Integer |
Credit card number w/o spaces |
| Credit Card Expiration | Date |
Format must be MMYY. e.g. 0515. It is strongly recommended that you use the ‘split select’ field type for this form field. |
|
Credit Card Verification value (CVV2 or CVC2) |
Numeric | The additional Card Verification Value printed on the card, used for fraud checks. |
Credit card number and credit card verification values are not stored in the default supporter record.
| Form Field | Value |
Description |
| Bank Account Type | Alpha |
Checking or Savings |
| Bank Account Number | Numeric |
The bank account number |
| Bank Routing Transit Number | Numeric |
The bank routing number |
NOTE: Please be sure to enable tokenization through Vantiv for recurring processing.
| Form Field | Value |
Description |
| Recurring Payment | Alpha |
Submitting ‘Y’ will flag the transaction as a recurring payment. Any other value will result in a single payment. |
| Recurring Frequency | Alpha |
Permitted values are MONTHLY, QUARTERLY, SEMI_ANNUAL and ANNUAL. Please see the notes below on ‘select’ field types for details of ways of presenting these fields to supporters. |
| Recurring Day | Numeric |
The day of the month on which the recurring payment should be taken. This can be defaulted to the day the initial donation was made. |
It is always recommended that you test your new forms using a 'Test Gateway'. This ensures that the proper values are being submitted to the gateway and that the page is processing correctly. Once tested, you can make is live and test an actual donation using your gateway.
The following credit card information can be used to test the Vantiv gateway.
Payment Type = Visa
Card Number = 4100200300011001
Card Expiration = Any future date
CVV Code = 463
© Engaging Networks | Company registered in England and Wales | Company number: 03848111