Airwallex Payment

Airwallex checkout counter without redirection within the site: Customers can directly complete card payment and 3D Secure verification on the checkout page.

"## Function

• ** In-site payment without redirection ** : Use Airwallex.js to render the card number/validity period/CVV input box on the checkout page. 3DS also completes the floating layer on the current page. The card information does not pass through this site throughout the process.
• ** Two cashier counter styles ** : Embedded card number form (purely within the site, recommended) and Drop-in aggregated cashier counter (including Alipay, wechat, Apple Pay, etc. Some wallets will redirect to the App or external page).
• ** Server-side pricing ** : The payment amount and currency are always calculated on the server based on the order. The front end only receives the payment order identifier and one-time key, which cannot be tampered with.
• ** Secondary verification of payment results ** : After the front-end payment is completed, the server will query the real status from Airwallex and verify the order number, amount and currency.
• **Webhook callback ** : Use 'x-signature' + 'x-timestamp' to perform HMAC-SHA256 signature verification and verify the 5-minute time window for replay prevention; All callbacks are rejected (fail-closed) when the signature key is not configured.
• ** Deduction modes available ** : "Authorize and deduct immediately" (recommended) and "Authorize only, deduct manually later".
• ** Refund Capability ** : Full/partial refund interfaces are provided, which need to be invoked in a custom controller or command line.
• ** Zero decimal currency ** : Automatically recognize currencies such as JPY and KRW and submit them in integer amounts.

Use

1. In the Airwallex merchant backend, "Developer → API Key", copy the Client ID and API Key.
2. In the Airwallex merchant backend, go to "Developer → Webhooks" to create a new Endpoint. Fill in the Notification URL as' https:// your domain /callback/bk_airwallex '. Subscribe to 'payment_intent.succeeded' (add 'payment_intent.requires_capture' when using the "Authorization only" mode), and copy the Webhook Secret after saving.
3. Install and enable "Plugin Management → Airwallex" in the background. Fill in the Client ID, API Key, and Webhook signature key on the Settings page (all are mandatory. The exact callback address of this site will be displayed at the top of the Settings page and can be directly copied), and save.
4. The payment method list on the checkout page shows "Airwallex". When the customer completes the payment within the page and it is successful, they will be redirected to the successful order placement page.
5. Before going live, turn off the "Sandbox (test) mode" and configure the Webhook Secret separately for the official environment (the sandbox key is different from the official key).

! [ScreenShot_2026-10-08_134606_267.png](https://beikeshop.cn/storage/plugins/20261008/48Dm1sA9mzAJ3XyTf2V8mTwA6ZSJJNH XdP9VTGEK.png)

! [ScreenShot_2026-10-08_134614_312.png](https://beikeshop.cn/storage/plugins/20261008/EAXfsRjfLfwG0wtIJtBccmLCdCi90zA YU8XvUE8V.png)