Adyen V2
STEP 1
ADYEN ACCOUNT
Obtain merchantAccount and apiKey from Adyen
Obtain liveUrlPrefix from Adyen. liveUrlPrefix is a string composed of a hex-encoded random part and your company name. Get the prefix from your live Customer Area under Developers > API URLs > Prefix.
Enable the “API PCI Payments” role for the API key (Contact the Adyen support to enable this feature). This may require submitting the CheckoutChamp PCI documentation. Please contact your account manager if this is needed.
Under Account Settings set your account to “immediate” capture delay.
In your Customer Area, go to Developers > Additional data.
Enable the following settings
Acquirer result
Raw acquirer result
Recurring details
Network transaction reference
3D Secure (optional)
Setup a standard webhook. This is required for final resolution of refund and capture requests.
Server configuration
URL: https://api.checkoutchamp.com/billers/adyenv2/notification/
Method: JSON
Encryption protocol: TLSv1.2
Security
HMAC: Generate a new key and added to the hmacKey gateway field in Step 2.
Events
CAPTURE
REFUND
STEP 2
In the CRM, go to Gateways > Gateway Integrations. Find AdyenV2 and click the tile. Then click the +Activate button.
STEP 3
Fill the fields obtained in Step 1.
Select “No” on secure3DS if it is for Non-3DS. Use force3DS to require 3DS from Adyen.
Skip steps 4-6 if using CheckoutChamp hosted pages
STEP 4
Add the hidden input browserData inside of the same form as the card input.
<input type="hidden" name="browserData" value="" id="browserData">
STEP 5
Add this script to your page before the closing body tag.
Script to get browserData:
<script type="text/javascript">
const navigator = window.navigator;
const browserData = {
acceptHeader: 'application/json',
colorDepth: screen.colorDepth,
javaEnabled: navigator.javaEnabled(),
javaScriptEnabled: true,
language: navigator.language,
screenHeight: screen.height,
screenWidth: screen.width,
timeZoneOffset: (new Date()).getTimezoneOffset().toString(),
userAgent: navigator.userAgent
};
document.getElementById('browserData').value = JSON.stringify(browserData);
</script>
STEP 6
For 3DS your checkout page must support the standard 3DS workflow