Airwallex Payment Gateway for UK and US

🚀 Airwallex Payment Gateway for Botble CMS

By Maryam International LLC — the team behind the most battle-tested Botble payment plugins on CodeCanyon.

Accept cards, Apple Pay, Google Pay & 160+ local payment methods in 130+ currencies from 180+ countries — all through a beautiful, secure, hosted checkout. Zero PCI hassle. Zero compromise.

✨ Why Airwallex?

FeatureDetails

🌍 Global reach

180+ countries, 130+ currencies

💳 All major cards

Visa, Mastercard, Amex, JCB, Discover, Diners, UnionPay

📱 Digital wallets

Apple Pay, Google Pay, Cash App Pay

🔒 3D Secure

Full 3DS support — built into hosted page

🔁 Full & partial refunds

One API call — no dashboard needed

🪝 Real-time webhooks

Instant order confirmation even if browser closes

🧪 Sandbox + Live

One setting to switch — no code changes ever

⚡ Token caching

Auth tokens cached 30min — no rate limit issues

🛡️ HMAC signature

Every webhook cryptographically verified

🎨 3 themes

Works perfectly on Martfury, Nest, Shofy

📦 Installation

1. Upload the AirwallexByCodeupp folder to platform/plugins/ on your server.
2. Go to Admin → Plugins and activate Airwallex Payment Gateway.
3. The migration runs automatically — no artisan migrate needed.
4. Go to Admin → Payments → Payment Methods and configure Airwallex.

⚙️ ConfigurationStep 1 — Get Your Credentials

Sandbox:

1. Log in at demo.airwallex.com
2. Navigate to Developer → API Keys
3. Copy your Client ID and API Key

Production:

1. Log in at airwallex.com
2. Navigate to Developer → API Keys
3. Copy your Live Client ID and Live API Key

Step 2 — Configure in Admin Panel

Go to Admin → Payments → Payment Methods → Airwallex:

SettingDescription

Environment

Sandbox for testing, Live for production

Sandbox Client ID

From demo.airwallex.com → Developer → API Keys

Sandbox API Key

From demo.airwallex.com → Developer → API Keys

Live Client ID

From airwallex.com → Developer → API Keys

Live API Key

From airwallex.com → Developer → API Keys

Webhook Secret

From Airwallex Dashboard → Developer → Webhooks

Statement Descriptor

Text on customer's card statement (max 22 chars)

Logo URL

Optional store logo shown on checkout page

Step 3 — Register Your Webhook

1. In Airwallex Dashboard → Developer → Webhooks → Add endpoint
2. URL: https://yourstore.com/payment/airwallex/webhook
3. Subscribe to: payment_intent.succeeded, payment_intent.cancelled, refund.settled, refund.failed, payment_dispute.requires_response
4. Copy the webhook secret → paste in admin settings
5. Repeat this step separately for sandbox and production dashboards.

🧪 Test Cards (Sandbox Only)

Use any future expiry date and any 3-digit CVC.

✅ Always Successful

Card NumberBrand

4035 5010 0000 0008

Visa Debit ⭐ Start here

2223 0000 4841 0010

Mastercard Credit

3706 3680 3809 394

American Express

6580 0700 0000 0008

Discover

3569 5999 9909 7585

JCB

6252 4701 4444 4939

UnionPay

🔐 3D Secure

Card NumberScenario

4012 0003 0000 0005

Frictionless 3DS success

4012 0003 0000 0062

Challenge 3DS — OTP: 1234

❌ Decline Cards

Card NumberError

4646 4646 4646 4644

Risk declined

2223 0000 1018 1375

Various errors (use amount 80.05 / 80.51 / 80.14)

⚠️ Use amounts that don't start with 80. for successful tests (e.g. 9.99, 50.00, 99.99)

🔄 Payment Flow

Customer clicks Pay → Server authenticates with Airwallex (token cached 30min) → Server creates PaymentIntent (major units, e.g. 99.99 USD) → Redirect to Airwallex HPP (Hosted Payment Page) → Customer pays (card / Apple Pay / Google Pay / 3DS) → Airwallex redirects to /payment/airwallex/success → Server verifies status via GET /pa/payment_intents/{id} → PAYMENT_ACTION_PAYMENT_PROCESSED fired → Botble marks order paid + sends confirmation email → Customer sees "Order Confirmed" ✅

Webhooks also fire asynchronously as a secondary confirmation layer.

💰 Refunds

Refunds are processed directly from Admin → Orders → [Order] → Refund.

• Full refund: omit amount — Airwallex refunds the full captured amount
• Partial refund: enter an amount — Airwallex processes it in the original currency
• Refund status updates automatically via the refund.settled webhook

🌐 Supported Themes

ThemeStatus

Martfury

✅ Fully compatible

Nest

✅ Fully compatible

Shofy

✅ Fully compatible

The checkout UI adapts to whatever theme is active — no theme-specific code required.

🔒 Security

• All credentials stored in Botble's encrypted settings table — never in source code
• Access tokens cached server-side — never exposed to the browser
• client_secret only used in server-side HPP URL construction
• Every webhook verified with HMAC-SHA256 before processing
• Payment status always re-verified server-side before marking order paid
• Webhook route CSRF-exempt via framework middleware filter
• Full audit trail via Laravel logs

📊 Payment Status Reference

StatusMeaning

REQUIRES_PAYMENT_METHOD

Awaiting card entry — customer on HPP

REQUIRES_CUSTOMER_ACTION

3DS challenge in progress

PENDING

Async processing

SUCCEEDED

✅ Payment complete — order marked paid

FAILED

❌ Payment declined

CANCELLED

Intent cancelled

🚀 Go-Live Checklist

• [ ] Production credentials obtained from airwallex.com
• [ ] Admin settings → switch Environment to Live
• [ ] Production webhook URL registered in production Airwallex dashboard
• [ ] Production webhook secret saved in admin settings
• [ ] Live test with real card for minimum amount
• [ ] Test refund to confirm refund flow works
• [ ] Verify order confirmation email fires correctly

🆘 Support

Built by Maryam International LLC

• Website: codeupp.xyz
• Plugin issues: Open a support ticket via CodeCanyon
• maryaminternationalllc@gmail.com
• +971553682656