NetSuite Invoice Payments Plugin

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:


Setup instructions

Part 1: Install and configure the Invoice Payment bundle

1.1 Install the bundle

  1. In NetSuite, go to Customization > SuiteBundler > Search & Install Bundles.
  2. Search for Bundle ID 486226, Airwallex Invoice Payment.

    Screenshot 2023-10-19 at 10.08.39 AM.png
     
  3. Install the bundle in your NetSuite instance.

1.2 Configure accounts for payment-related fees

  1. Go to Setup > Company > General Preferences > Custom Preferences.
  2. 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.
  1. 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.

NetSuite URL.png

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

  1. In NetSuite, open Airwallex Connection Overview.

    NS invoice payment connection.png
     
  2. In the Invoice Payment card, select Set Up.

    Screenshot 2024-03-07 at 16.28.05.png
     
  3. Select the NetSuite subsidiary to connect to your Airwallex account.

    NS invoice payment link account.png
     
  4. 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.
  5. Complete the connection.

    Invoice payment_3.png
    Invoice payment_4.png

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

  1. Create an invoice in NetSuite and complete the required invoice fields.
  2. Select the CREATE AIRWALLEX LINK checkbox.

    Invoice payment_5.png
     
  3. Select Save.

    Invoice payment_6.png

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.
 

Invoice payment_7.png

Invoice payment_8.png


Grouped invoices

You can generate one payment link for multiple invoices issued to the same customer.

Enable grouped invoices

  1. Go to Setup > Company > Enable Features.
  2. On the Transactions tab, enable Invoice Groups under Billing.


     
  3. Go to Lists > Relationships > Customers.
  4. Edit the customer for whom you want to enable grouped invoices.
  5. Under financial settings, select GROUP INVOICES.

Create a grouped invoice

  1. When creating each invoice, select FOR INVOICE GROUPING.


    Airwallex does not generate a payment link on an individual invoice marked for grouping.
     
  2. Go to Transactions > Sales > Group Invoices.


     
  3. Select the invoices to group, then select Submit.


     
  4. When the grouped invoice is created, select Edit, then Save.
  5. 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.

Was this article helpful?

1 out of 1 found this helpful

Have more questions? Submit a request