> For the complete documentation index, see [llms.txt](https://help.checkoutchamp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.checkoutchamp.com/crm/gateway-setup/gateway-integrations/airwallex.md).

# Airwallex

<figure><img src="/files/lU8MHaHHQDSp37U3c64j" alt=""><figcaption></figcaption></figure>

<p align="center"><a href="https://www.airwallex.com/gtmp/payments/integration-partners/checkoutchamp?utm_source=gtm-partner&#x26;utm_medium=partner_referral&#x26;utm_campaign=v01_glbl_multi_ib_dg_prttm_gen_checkoutchamp&#x26;sfcid=701Nn00000Sc3JJIAZ">CLICK HERE</a> to learn more about the Airwallex integration with Checkout Champ!</p>

{% hint style="info" %}
Airwallex supports multiple payment methods - credit card, [Apple Pay](#apple-pay), [Google Pay](#google-pay), Afterpay, BLIK, Bancontact, BLIK, iDEAL, P24, Klarna, EPS, MyBank, PayU, Trustly, and SEPA Direct Debit.
{% endhint %}

{% hint style="warning" %}

* Contact Airwallex to enable the third-party 3DS feature
* Contact Airwallex to enable the skip 3DS feature
  {% endhint %}

**STEP 1**

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

<figure><img src="/files/ya5JNvIc8pM1dIXPrW05" alt="" width="375"><figcaption></figcaption></figure>

#### STEP 2

Enter a Title for the gateway.

Then enter the following information specific to Airwallex:

**clientId -** obtained from Airwallex

<figure><img src="/files/MpG0wMygGP4LAXbXXEnT" alt="" width="563"><figcaption></figcaption></figure>

**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](https://www.airwallex.com/docs/developer-tools__api__manage-api-keys).

**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.

<figure><img src="/files/Zt4OeXMAnmWV9XyjNvIP" alt="" width="375"><figcaption></figcaption></figure>

Nothing else is required on this page.  Please review this [document ](/crm/gateway-setup/adding-a-gateway.md)for more details.  Press <mark style="color:green;">**Create Gateway**</mark> when finished.

{% hint style="info" %}
Steps 3-5 can be skipped if using CheckoutChamp hosted pages
{% endhint %}

**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](/crm/gateway-setup/direct-api-3ds-instructions.md)

#### 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](/funnel-builder/creating-and-editing-funnels-pages/funnel-visualizer-and-page-builder/funnel-visualizer/edit-funnel-settings/payments/apple-pay.md).

If not using CheckoutChamp pages then obtain the appropriate token on your page and pass **applePayToken** to CheckoutChamp on the [Import Order](https://apidocs.checkoutchamp.com/#275a54c6-b4b0-414c-819b-7387e9a81f58) API call.

#### Google Pay

If using CheckoutChamp pages then follow Google Pay instructions [here](/funnel-builder/creating-and-editing-funnels-pages/funnel-visualizer-and-page-builder/funnel-visualizer/edit-funnel-settings/payments/google-pay.md).

If not using CheckoutChamp pages then obtain the appropriate token on your page and pass **googlePayToken** to CheckoutChamp on the [Import Order](https://apidocs.checkoutchamp.com/#275a54c6-b4b0-414c-819b-7387e9a81f58) API call.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.checkoutchamp.com/crm/gateway-setup/gateway-integrations/airwallex.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.