Skip to main content

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

​
Connect Airwllex 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.
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.
  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)

Embedding Apple/Google Pay into custom checkout

Once enabled, Apple Pay and Google Pay can be integrated directly into your custom checkout form using PaymentKit’s <ElementsForm />. Click to learn more.