# Airwallex

> Accept card, direct debit, and digital wallet payments through Airwallex using PaymentKit. PaymentKit handles PCI compliance and securely orchestrates all payment operations with Airwallex.

# Set up summary

To accept payments with Airwallex in PaymentKit, you will need to:

1. Generate API credentials in Airwallex
2. Connect Airwallex to PaymentKit
3. (Optional) Enable Apple Pay
4. (Optional) Enable Google Pay

# Generate API credentials in Airwallex

PaymentKit requires a secure connection to Airwallex via your **Client ID** and **API key**.

2. In your Airwallex account, navigate to **Account → Developer → API Keys**
3. Click **Create Restricted API Key**
4. Provide a descriptive name, e.g., `"PaymentKit Integration Key"`
5. Assign access to all payments-related resources (edit and view)
6. Save your **Client ID** and **API Key** — you will add these into PaymentKit

# Connect Airwallex to PaymentKit

1. Navigate to **Developers → Payment Processors**
2. Click **Add Processor** and select **Airwallex**
3. Enter your **Client ID** and **API Key**
4. Select the **Environment Type**
5. Turn on the payment methods you want to accept payments in **(for Apple Pay and Google Pay, you will need to complete the additional steps below)**

# Enable Apple Pay

Apple Pay requires a verified custom domain.

1. Retrieve your **Apple Pay Merchant ID Association Key** in Airwallex:\
   **Payments → Payment Methods → Apple Pay → Manage → Add Domain**
2. Enter your domain (e.g., `https://pay.apollo.com`) and download the verification file
3. Decompress the ZIP file

## Accept payments via PaymentKit's hosted checkout

These are the required steps if you are planning to accept payments through PaymentKit's hosted checkout.

* In PaymentKit, navigate to **Settings → Brand & Identity**
* Upload the verification file provided by Airwallex

## Accept payments via your own custom checkout

These are the required steps if you are planning to accept payments through your own custom checkout with PaymentKit's embedded checkout elements.

* Host the key file at the location specified by Airwallex
* Confirm registration in the Airwallex dashboard by clicking **Add**

## Complete setup

1. Enable Apple Pay in Airwallex
2. In PaymentKit, navigate to **Developers → Payment Processors**
3. Edit your Airwallex processor settings
   * Turn on Apple Pay and enter your **Airwallex Account ID** and **Merchant Name**

# Enable Google Pay

Google Pay setup requires a [Google Pay Wallet Account.](https://developers.google.com/wallet)

<Note>
  To ensure a smooth approval process, register your Google Pay Merchant ID once your staging integration is complete. You will need to provide screenshots showing successful Google Pay transactions on your site. Approval usually takes a few hours.
</Note>

1. In PaymentKit, navigate to **Developers → Payment Processors**
2. Edit your Airwallex processor settings
   * Turn on Google Pay and enter the following:
     * **Airwallex Account ID**
     * **Merchant Name**
     * **Google Pay Merchant ID** (not required for test mode)

<Card title="Embedding Apple/Google Pay into custom checkout" icon="solid diagram-successor" color="#C6C7F8">
  Once enabled, Apple Pay and Google Pay can be integrated directly into your custom checkout form using PaymentKit's `<ElementsForm />`. Click to learn more.
</Card>

***

\[MBCC]