New License Manager

Laravel PHP Licenser & Updates Manager - REST API, webhooks, customer portal

Airwallex Payment Gateway for UK and US

Plugin
Airwallex payment gateway for UK & US Accept cards, Apple Pay & Google Pay globally. Supports sandbox & live, 130+ currencies, refunds, and webhooks.
$99.00 $149.00

Version

1.0.0

Botble Version

>= 7.3.0

License

MIT

πŸš€ 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?

Feature Details
🌍 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.

βš™οΈ Configuration

Step 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:

Setting Description
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 Number Brand
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 Number Scenario
4012 0003 0000 0005 Frictionless 3DS success
4012 0003 0000 0062 Challenge 3DS β€” OTP: 1234

❌ Decline Cards

Card Number Error
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

Theme Status
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

Status Meaning
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


Airwallex Payment Gateway Plugin β€” engineered for reliability, built for growth.

❀️

Support the Author

If you find this product helpful, consider supporting the developer.

Bank Information

Bank Name- Wio BankΒ  IBAN: AE040860000009582249758 ACCOUNT NUMBER: 9582249758 ACCOUNT NAME: MARYAM INTERNATIONAL LLC, Country United Arab Emirates

Scan QR Code

Bank Name- Wio BankΒ  IBAN: AE040860000009582249758 ACCOUNT NUMBER: 9582249758 ACCOUNT NAME: MARYAM INTERNATIONAL LLC, Country United Arab Emirates

Leave a comment

Your email address will not be published. Required fields are marked *

Kindly log in to share your feedback on this plugin.