Vantiv

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.

Adding the Vantiv Gateway

STEP 1

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

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.

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 .

STEP 2

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

STEP 3

Assign the gateway to campaign products

STEP 4

This step can be ignored if using CheckoutChamp hosted pages

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

Basic 3DS Instructions

STEP 5 (Optional)

Vantiv (Worldpay) supports both Signifyd and FraudSight fraud screening.

Follow the detailed instructions for each.

---

Signifyd (Guaranteed Payments)

For CheckoutChamp hosted pages:

Place this script in the Head using the Global Scripts feature

<script>
var fraudSessionId = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function(uniqueChar) {
	var currentdate = new Date().getTime();
	var convertDate = (currentdate + Math.random() * 16) % 16 | 0;
	currentdate = Math.floor(currentdate / 16);
	return (uniqueChar === "x" ? convertDate : (convertDate & 0x3 | 0x8)).toString(16);
});

var script = document.createElement('script');
script.type = 'text/javascript';
script.id = 'sig-api';
script.src = 'https://cdn-scripts.signifyd.com/api/script-tag.js';
script.setAttribute('data-order-session-id', fraudSessionId);
script.onload = createfraudSessionElement;
document.head.append(script);

function createfraudSessionElement() {
	var el = document.createElement('INPUT');
	el.type = 'hidden';
	el.name = 'fraudSessionId';
	el.value = fraudSessionId;
	document.body.appendChild(el);
}
</script>

For Direct API:

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.

<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

For CheckoutChamp hosted pages:

Place this script in the Head using the Global Scripts feature

<script>
var fraudSessionId = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function(uniqueChar) {
	var currentdate = new Date().getTime();
	var convertDate = (currentdate + Math.random() * 16) % 16 | 0;
	currentdate = Math.floor(currentdate / 16);
	return (uniqueChar === "x" ? convertDate : (convertDate & 0x3 | 0x8)).toString(16);
});

var script = document.createElement('script');
script.type = 'text/javascript';
script.src = "https://h.online-metrix.net/fp/tags.js?org_id=e0j3u9ji&session_id=" + fraudSessionId;
script.onload = createfraudSessionElement;
document.head.append(script);

function createfraudSessionElement() {
	var el = document.createElement('INPUT');
	el.type = 'hidden';
	el.name = 'fraudSessionId';
	el.value = fraudSessionId;
	document.body.appendChild(el);
}
</script>

For Direct API:

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.

<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