Airwallex

CLICK HERE to learn more about the Airwallex integration with Checkout Champ!

Airwallex supports multiple payment methods - credit card, Apple Pay, Google Pay, Afterpay, BLIK, Bancontact, BLIK, iDEAL, P24, Klarna, EPS, MyBank, PayU, Trustly, and SEPA Direct Debit.

• Contact Airwallex to enable the third-party 3DS feature

• Contact Airwallex to enable the skip 3DS feature

STEP 1

Go to Gateways | Gateway Integrations and select the Airwallex tile. Click on +Activate.

STEP 2

Enter a Title for the gateway.

Then enter the following information specific to Airwallex:

clientId - obtained from Airwallex

apiKey - obtained from Airwallex. This must be a restricted API key. The restricted API key must be set with only the permission Payment Acceptance → Payment Acceptance (Edit & View). Do not set any other permissions. Follow instructions here.

secure3DS - choose Default, Skip, or Force. Check with your Airwallex account manager for the proper choice.

sendUpsellToken - choose to send a payment token instead of card number on upsells.

useTestServer - use sandbox credentials to test the integration. Be sure this is unchecked for live processing.

Nothing else is required on this page. Please review this document for more details. Press Create Gateway when finished.

Steps 3-5 can be skipped if using CheckoutChamp hosted pages

STEP 3

Add the hidden input browserData inside of the same form as the card input.

<input type="hidden" name="browserData" value="" id="browserData">

STEP 4

Add this script to your page before the closing body tag.

<script type="text/javascript">
    const navigator = window.navigator;
    const browserData = {
        acceptHeader: 'application/json',
        userAgent: navigator.userAgent,
        language: navigator.language,
        timezone: (new Date()).getTimezoneOffset().toString(),
        colorDepth: screen.colorDepth,
        screen: {
            height: screen.height.toString(),
            width: screen.width.toString()
        },
        javaScriptEnabled: true,
        javaEnabled: navigator.javaEnabled()
    };
    document.getElementById('browserData').value = JSON.stringify(browserData);
</script>

STEP 5

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

Basic 3DS Instructions

STEP 6

Airwallex require a fraud fingerprint be submitted with the sale. Place this script onto the checkout page. It creates an Airwallex fingerprint and places the ID into a hidden fraudSessionId element. Pass this element value as "fraudSessionId" on Import Order API.

If using CheckoutChamp hosted pages then this script must be pasted into your checkout page. However the fraudSessionId is automatically passed with the order. There is no additional coding needed.

(function () {
    'use strict';

    const SCRIPT_ID = 'airwallex-fraud-api';
    if (document.getElementById(SCRIPT_ID)) {
        return;
    }

    const generateUUID = function () {
        if (
            typeof crypto !== 'undefined' &&
            typeof crypto.randomUUID === 'function'
        ) {
            return crypto.randomUUID();
        }

        if (
            typeof crypto !== 'undefined' &&
            typeof crypto.getRandomValues === 'function'
        ) {
            return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(
                /[xy]/g,
                function (c) {
                    const arr = new Uint8Array(1);
                    crypto.getRandomValues(arr);
                    const r = arr[0] % 16;
                    return (c === 'x' ? r : (r & 0x3) | 0x8).toString(16);
                }
            );
        }

        let timestamp = new Date().getTime();
        return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(
            /[xy]/g,
            function (c) {
                const r = (timestamp + Math.random() * 16) % 16 | 0;
                timestamp = Math.floor(timestamp / 16);
                return (c === 'x' ? r : (r & 0x3) | 0x8).toString(16);
            }
        );
    };

    const fraudSessionId = generateUUID();

    const appendHiddenInput = function () {
        const el = document.createElement('input');
        el.type = 'hidden';
        el.name = 'fraudSessionId';
        el.value = fraudSessionId;
        (document.body || document.documentElement).appendChild(el);
    };

    const fraudScript = document.createElement('script');
    fraudScript.type = 'text/javascript';
    fraudScript.id = SCRIPT_ID;
    fraudScript.async = true;
    fraudScript.src = 'https://static.airwallex.com/webapp/fraud/device-fingerprint/index.js';
    fraudScript.setAttribute('data-order-session-id', fraudSessionId);
    fraudScript.onload = appendHiddenInput;
    fraudScript.onerror = function () {
        console.warn('[airwallex-fraud] Failed to load device fingerprint script.');
    };

    document.head.appendChild(fraudScript);
}());

Apple Pay

If using CheckoutChamp pages then follow Apple Pay instructions here.

If not using CheckoutChamp pages then obtain the appropriate token on your page and pass applePayToken to CheckoutChamp on the Import Order API call.

Google Pay

If using CheckoutChamp pages then follow Google Pay instructions here.

If not using CheckoutChamp pages then obtain the appropriate token on your page and pass googlePayToken to CheckoutChamp on the Import Order API call.