Airwallex is a global payment provider, so you can charge guests almost anywhere right inside Mangobeds. Guests pay with international and local cards and wallets in 30+ currencies through Airwallex’s hosted payment link, while you keep clean reconciliation in one place.

---

Before you start (what you need)

• An active Airwallex account.
• Your Airwallex Client ID and API key (with Payment Links access).
• Your Mangobeds property currency set to a currency Airwallex supports (for example USD, EUR, GBP, AUD, SGD or HKD).

Where to find your API keys in Airwallex

1. Log in to your Airwallex Web App.
2. Go to Settings → Developer → API keys and click New scoped API key (an Admin key also works).
3. Under Account permissions → Payment Acceptance, enable Payment Links (Read and Write). This is the only permission the integration needs.
4. Create the key, then copy the Client ID and the API key. The API key is shown only once, so save it. If you lose it, create a new key.

Register the webhook (required)

Airwallex tells Mangobeds when a payment is completed through a webhook, which is configured once per Airwallex account. You need to add it yourself. In your Airwallex Web App go to Settings → Developer → Webhooks → Add Webhook and set:

• Notification URL: https://www.mangobeds.com/api/webhooks/airwallex
• Event: payment_link.paid (under Payment Link)

If this webhook is missing, payments will succeed in Airwallex but bookings in Mangobeds will not be marked as paid.

Supported countries and currencies

Airwallex onboards businesses in 75+ countries and territories and collects payments in 30+ currencies, so it works as a global alternative wherever Airwallex is available. Just make sure your Mangobeds property currency is one Airwallex supports (for example USD, EUR, GBP, AUD, SGD, HKD, CAD, NZD, JPY or CHF). Guests can pay with international and local cards and wallets through Airwallex’s hosted checkout.

How to set it up in Mangobeds

1. Go to: Property → Settings → Payment Accounts → Connect Payment Account.
2. In Create a new payment account, choose Airwallex as the provider.
3. Paste:
   • Airwallex Client ID
   • Airwallex API Key
4. Tick the box confirming you’ve read this guide and registered the webhook.
5. Save to create the payment account, then Connect it to the property.

Heads-up: once a property is linked to a payment account, you can’t swap providers on that property without removing the connection first.

How a guest payment works

• Mangobeds redirects the guest to Airwallex’s hosted payment page.
• The guest pays with a card or a local method.
• Airwallex notifies Mangobeds automatically through the payment_link.paid webhook once the payment is confirmed.
• Mangobeds marks the booking’s payment as Succeeded and sends you the usual property notification.

Wrap-up

Connecting Airwallex to Mangobeds gives your guests a familiar global checkout with cards and local methods in 30+ currencies, while keeping your ops tidy with automatic payment reconciliation. Grab your Client ID and API key, register the webhook, connect, and you’re live.