Salesforce Commerce Cloud
Accept 160+ payment methods on your SFCC storefront with the Airwallex Payments Cartridge.
Salesforce Commerce Cloud (SFCC) is an enterprise ecommerce platform used by merchants worldwide to build and manage scalable online storefronts. The Airwallex Payments Cartridge is a prebuilt integration for the SFCC Storefront Reference Architecture (SFRA) that enables merchants to accept 160+ payment methods — including credit cards, Apple Pay, Google Pay, and a wide range of local payment methods — while benefiting from competitive FX rates through Like-for-Like settlement.
To accept payments, create an Airwallex account and install the cartridge on your existing SFCC storefront using the installation guides below.
Supported features
| Capabilities | Salesforce Commerce Cloud |
|---|---|
| Merchant country codes | AU, CH, EU, HK, SG, NZ, UK, US |
| Shopper country codes | Global |
| Payment methods | Visa, Mastercard, American Express, UnionPay, JCB, Diners Club, Discover, Apple Pay, Google Pay, Alipay, WeChat Pay, iDEAL, Klarna, Afterpay, GrabPay, DANA, PIX, and 160+ more |
| Features | Payment, Refund, Partial refund, 3D Secure authentication, Manual and Auto capture |
| Currencies | See payment method capabilities |
| Supported SFCC versions | SFRA 5.x and later |
Checkout experience
Express checkout
Apple Pay and Google Pay buttons appear at the top of the checkout page, enabling one-tap purchases. The shopper's shipping address and payment details are collected in a single step without leaving the page.
Credit and debit cards
The shopper enters their card details into a secure, PCI-compliant card form (card number, expiry, CVC) rendered directly on the checkout page through the Airwallex Components SDK. Supported card schemes include Visa, Mastercard, American Express, UnionPay, JCB, Diners Club, and Discover.
When 3D Secure is required, the shopper completes an additional authentication step (for example, a one-time passcode) before the payment is processed.
Local payment methods
Region-specific payment options such as Alipay, WeChat Pay, iDEAL, Klarna, Afterpay, GrabPay, DANA, PIX, and 160+ more are automatically presented based on the shopper's currency and region. The shopper selects a local payment method and is redirected to the corresponding payment provider to complete the transaction, then returned to the storefront success page.
Capture
The cartridge supports both automatic and manual capture modes:
- Auto capture — Payments are captured automatically when the order is placed. This is the default behavior.
- Manual capture — Payments are authorized at order placement and captured separately at a later time (for example, at fulfillment). Enable manual capture in the Airwallex settings page in Business Manager.
Refunds
Refunds and partial refunds are processed through the Airwallex web app. When a refund is initiated, Airwallex sends a webhook event (refund.accepted) to your SFCC storefront. The webhook processing job updates the corresponding order status automatically.
Webhook configuration required
To receive refund status updates, you must configure webhooks and enable the webhook processing job. See Configure webhooks for details.
Architecture
The cartridge is composed of three modules:
| Cartridge | Purpose |
|---|---|
int_airwallex | Server-side integration — API clients, payment processing, webhooks, jobs |
app_airwallex | Storefront UI — ISML templates, client-side JavaScript, checkout flow |
bm_airwallex | Business Manager module — Airwallex settings configuration page |
Compatibility
| Requirement | Version |
|---|---|
| SFCC B2C Commerce | SFRA 5.x and later |
| Node.js (build only) | 18.x or later |
| Storefront Reference Architecture | Required |
Installation guides
To install and configure the Airwallex Payments Cartridge, complete these steps in order:
- Prepare and import metadata — Create all necessary system objects, services, payment methods, and jobs in your SFCC realm.
- Build and upload the cartridge — Clone the repository, build the source, and upload the cartridge code to your realm.
- Configure SFCC to enable the cartridge — Register the cartridges in Business Manager and enable payment methods.
- Configure Airwallex settings — Enter your API credentials and configure payment features.
- Configure webhooks — Set up webhook notifications to keep order statuses in sync.
- Go-live checklist — Verify your configuration before switching to production.