Airwallex

Cards, wallets and local methods in many currencies through your own Airwallex account: connect it and turn it on at checkout.

In the admin Settings › Payments › Other payment providers › Airwallex

Open Settings › Payments › Other payment providers and choose Set up Airwallex (Manage Airwallex once it is connected). Other payment providers is also under Payments in the Settings menu.

Airwallex takes cards, wallets and local methods in many currencies through your own Airwallex account. Storeloom charges nothing for it; Airwallex’s own fees apply.

The page has two cards. Connection is where you connect your Airwallex account; At checkout has the switch Offer Airwallex at checkout and Instructions for customers (optional), shown when they choose it and in their order confirmation. Apply in the bar at the top (it says Unsaved changes while something is not saved) keeps the switch and the instructions; Discard puts them back.

  1. In Airwallex, under Developer › Webhooks, add a webhook to the webhook address shown on this page for payment intent events, and copy its secret.
  2. Here, fill in the Client ID and API key (Settings › Developer › API keys), the Account ID (Settings › Account details), the Webhook secret and the Environment: Sandbox or Live. Choose Connect Airwallex. Storeloom signs in with them first, then keeps them locked away: never shown again, only the account ID, the API key’s last four characters and Sandbox or Live.
  3. Under At checkout, tick Offer Airwallex at checkout.

At checkout customers choose Card and other online payments and pay on Airwallex’s hosted page; a declined card can be retried there. Back on their order page, Storeloom asks Airwallex what became of the payment:

  • Paid: the order is paid and ships; only then do they get the order confirmation, and you the new-order notification.
  • Cancelled or expired: the order is cancelled and its stock goes back; their order page offers Try again.
  • Page left unpaid: Airwallex’s page closes after an hour, and Storeloom then cancels the order (stock back).

Webhooks from Airwallex are only read when they carry a fresh signature made with your webhook secret. Refunds of orders paid through Airwallex go back through Airwallex. A refund goes back through the Airwallex account and mode that took the payment: if you have connected another account since, or switched between Sandbox and Live, Storeloom asks you to connect the same account and mode again before it refunds. Disconnect forgets the details and stops offering Airwallex. Airwallex cannot pay subscription renewals yet. Only the owner connects or disconnects Airwallex.