The Airwallex Invoice Payment plugin lets you generate Airwallex payment links for invoices created in NetSuite. Share the link with your customer to direct them to an Airwallex payment page. When payment succeeds, the payment is added to your Airwallex account and the NetSuite invoice is updated after settlement.
This setup guide covers:
- Part 1: Install and configure the Invoice Payment bundle
- Part 2: Connect your Airwallex account
- Part 3: Create invoices and payment links
- Grouped invoices
- FAQs and troubleshooting
Setup instructions
Part 1: Install and configure the Invoice Payment bundle
1.1 Install the bundle
- In NetSuite, go to Customization > SuiteBundler > Search & Install Bundles.
- Search for Bundle ID 486226, Airwallex Invoice Payment.
- Install the bundle in your NetSuite instance.
1.2 Configure accounts for payment-related fees
- Go to Setup > Company > General Preferences > Custom Preferences.
- Under Airwallex Invoice Payment, select the appropriate NetSuite account for each fee type:
| Fee setting | Use for |
| Airwallex Bank Fees | Miscellaneous bank fees incurred in the transaction. |
| Airwallex Merchant Fees | Payment-method, gateway, scheme, or interchange fees associated with online payments. |
| Airwallex Taxes | GST charged on Airwallex fees. |
| Airwallex Surcharge | Surcharges collected when you pass payment-processing fees to the payer. |
- If you use surcharging, enter the Airwallex Surcharge Fee Rate configured in the Airwallex web app. This is the fixed percentage added to the transaction amount and helps ensure settlement accuracy.
1.3 Configure Airwallex URLs
In Custom Preferences, enter the URLs that match the Airwallex environment you are connecting.
| Setting | Demo environment | Production environment |
| Airwallex URL | https://api-demo.airwallex.com | https://api.airwallex.com |
| Airwallex OAuth TokenRequest URL | https://api-demo.airwallex.com/oauth/token? | https://api.airwallex.com/oauth/token? |
| Airwallex OAuth Consent Request URL | https://demo.airwallex.com/app/oauth/consent? | https://www.airwallex.com/app/oauth/consent? |
Part 2: Connect your Airwallex account
- In NetSuite, open Airwallex Connection Overview.
- In the Invoice Payment card, select Set Up.
- Select the NetSuite subsidiary to connect to your Airwallex account.
- Select the NetSuite settlement bank account or accounts:
- You can select more than one account when you settle in multiple currencies, such as AUD, USD, or EUR.
- Select a default settlement bank account for non-like-for-like settlements.
- Complete the connection.
To change the settlement bank accounts later, open the connected Invoice Payment card and select Update Settlement Settings.
Part 3: Create an invoice and payment link
- Create an invoice in NetSuite and complete the required invoice fields.
- Select the CREATE AIRWALLEX LINK checkbox.
- Select Save.
Airwallex generates a payment link that you can embed in, or share with, the invoice. When your customer completes payment, the invoice is marked PAID IN FULL and the payment amount is credited to the configured NetSuite account upon settlement.
Grouped invoices
You can generate one payment link for multiple invoices issued to the same customer.
Enable grouped invoices
- Go to Setup > Company > Enable Features.
- On the Transactions tab, enable Invoice Groups under Billing.
- Go to Lists > Relationships > Customers.
- Edit the customer for whom you want to enable grouped invoices.
- Under financial settings, select GROUP INVOICES.
Create a grouped invoice
- When creating each invoice, select FOR INVOICE GROUPING.
Airwallex does not generate a payment link on an individual invoice marked for grouping.
- Go to Transactions > Sales > Group Invoices.
- Select the invoices to group, then select Submit.
- When the grouped invoice is created, select Edit, then Save.
- Find the Airwallex payment link in the IG_PAYMENT_LINK field.
FAQs and troubleshooting
I cannot generate payment links. What should I check?
Confirm that:
- Payment Acceptance and Payment Links are activated for your Airwallex account.
- Your required payment methods are configured in Airwallex.
Can I customise the payment link?
Yes. In the Airwallex web app, go to Payments > Payment Links > Customise in Themes to customise:
- The logo at the top of the payment link
- The support email address and phone number shown in payer receipts
When will I receive payment?
Airwallex sends an email notification when your customer makes a payment. Settlement timing depends on the reserve terms that apply to your account.
What payment methods can my customers use?
Customers can pay using supported credit or debit cards, including Visa, Mastercard, and UPI, and supported local payment methods, such as WeChat Pay and Alipay.