# Vantiv

{% hint style="info" %}
Request Vantiv to enable the Vault feature on your account.

This will allow subscription billing to be done with a payment token.

Without Vault enabled, subscription billing will use the card number without cvv, which generally results in lower approvals.
{% endhint %}

## **Adding the Vantiv Gateway**

**STEP 1**

Obtain a **user**, **password, merchantId,** and **reportGroup** from Vantiv.

{% hint style="warning" %}
If you are currently using a VantivV1 gateway then those credentials will not work on VantivV2. The new v12 integration requires you to use a new authentication username/password which will be different from your current integration.
{% endhint %}

{% hint style="info" %}
The **reportGroup** attribute is a completely customizable field that accepts any alphanumeric string values and allows you to segment transactions into various categories to make reporting/reconciliation easier.  You can send a single default value for every transaction if you choose, or you can send different values based on how you want to review your traffic in the iQ reporting system.  For more details, please see here: <http://support.worldpay.com/support/CNP-API/content/codeforrepgroups.htm> .
{% endhint %}

**STEP 2**

Activate the Vantiv gateway and enter the values from Step 1.

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FwP3ThplEUW2wrYLO8Iqo%2FUntitled.png?alt=media&#x26;token=3a0ab93c-381b-40dd-9260-2a706fdb4fa2" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FVh5A7Nhl77WyGbttFiaA%2FUntitled-1.png?alt=media&#x26;token=cb7609e6-a63a-4259-9337-6db4750301ca" alt=""><figcaption></figcaption></figure>

**STEP 3**

Assign the gateway to campaign products

**STEP 4**

If using Secure 3DS be sure the checkout page supports challenge requests

[Basic 3DS Instructions](https://help.konnektive.com/konnektive-crm/gateway-setup/basic-3ds-instructions)

**STEP 5** (Optional)

Vantiv (Worldpay) supports both [Signifyd](#vantiv-signifyd-guaranteedpayments) and [FraudSight](#vantiv-fraudsight) fraud screening.

Follow the detailed instructions for each.

***

## **Signifyd (Guaranteed Payments)** <a href="#vantiv-signifyd-guaranteedpayments" id="vantiv-signifyd-guaranteedpayments"></a>

**1. Install the javascript snippet**

Place the following script just before the closing `</head>` tag on the checkout page. The script loads asynchronously and does not affect page load time.

```javascript
<script
defer
type="text/javascript"
id="sig-api"
data-order-session-id="YOUR-SESSION-ID-HERE"
src="https://cdn-scripts.signifyd.com/api/script-tag.js"></script>
```

**2. Provide a unique session id**

Replace `YOUR-SESSION-ID-HERE` with a unique session id for the current user's checkout.

The session id must be formatted as followed:

* Less than 100 characters long
* Upper and lowercase English letters (a-z, A-Z)
* Digits (0-9)
* Underscore (\_)
* Hyphen (-)

**3. Send the session id to Import Order API**

Send the session id to Import Order API using the **fraudSessionId** parameter

***

## **FraudSight** <a href="#vantiv-fraudsight" id="vantiv-fraudsight"></a>

**1. Install the javascript snippet**

Place the following script just before the closing `</head>` tag on the checkout page. The script loads asynchronously and does not affect page load time.

```javascript
<script type="text/javascript"
src="https://h.online-metrix.net/fp/tags.js?org_id=e0j3u9ji&session_id=YOUR-SESSION-ID-HERE"></script>
```

**2. Provide a unique session id**

Replace `YOUR-SESSION-ID-HERE` with a unique session id for the current user's checkout.

The session id must be formatted as followed:

* Less than 100 characters long
* Upper and lowercase English letters (a-z, A-Z)
* Digits (0-9)
* Underscore (\_)
* Hyphen (-)

**3. Send the session id to Import Order API**

Send the session id to Import Order API using the **fraudSessionId** parameter