How do I install and use the Airwallex Payables Plugin on NetSuite

Our “Airwallex Payables” NetSuite plugin, enables you to effortlessly pay your domestic and international supplier/vendor bills directly within the NetSuite platform. This is achieved by utilising the funds in your connected Airwallex account. Additionally, you have the option to choose the currency balance from your wallet that is most suitable for your payment requirements. This is accompanied by the advantage of accessing the same competitive foreign exchange pricing available within your Airwallex account.

Installation guide

Please contact your designated Airwallex account manager to initiate the process. Once the bundle has been whitelisted for your NetSuite account, you can refer to the provided instructions to configure the setup.

Install bundle and configure settings

Step 1. Search for bundle ID 486225 “Airwallex Payables” Customisation > SuiteBundler > Search and Install Bundles and install to your NetSuite instance

Step 2. Go to Setup > Company > General preferences > Custom preferences to ensure you set up

  • AIRWALLEX TRANSFER FEE ITEM — Fee item for any transfer fee incurred (you may set up the item in Lists > Accounting > Items)
    • Please note that the fee item used should be of the following type
      • Non-inventory Item for Purchase
      • Other charge for Purchase
      • Service for Purchase
  • AIRWALLEX TRANSFER NOTICE PDF FOLDER ID — Folder to store your Airwallex Transfer Notices
  • Check the “CONNECT TO AWX PROD” box if you are connecting to a production Airwallex account.

Payables settings page.png

Setting up portlet

If you are using the plugin for the first time, you may have to set up the view portlet to ensure the cards are displayed properly

Step 1. Click set up link


Step 2. From the dropdown, click Airwallex | Connection Overview

Click AWX connection.png

Step 3. Click Layout and select the wide screen format


Establish connection

Step 1. To initiate a connection, go to “Airwallex Connection” and select “Connection Overview”.

Screenshot 2024-03-07 at 16.28.05.png

Step 2. Click “Manage” in the Payables card

Step 3. Before clicking the “Add connection” button, you will choose the NetSuite Subsidiary associated with your Airwallex account from the dropdown menu. Note that you can:

  • Connect multiple Airwallex accounts to multiple NetSuite Subsidiaries
  • Connect a single Airwallex account to multiple NetSuite Subsidiaries

To ensure successful payments via Airwallex, it's important to connect all the subsidiaries through which you intend to make payments. 

Click “Add connection” to connect your Airwallex account for bill payments within NetSuite.

NetSuite_Payables_add connection.png


Step 4. The first Airwallex account connected to a NetSuite Subsidiary will be set as the default Airwallex account. If you are making bulk bill payments, we will always deduct the balance from the default Airwallex account. You have the option to change the default Airwallex account by clicking “SET DEFAULT”

Create beneficiary

Step 1. To make bill payments to a vendor, you will first have to create an Airwallex Beneficiary under the NetSuite Vendor record. Click into a vendor which you wish to pay bills and access the “Airwallex Beneficiary Details” subtab to create an Airwallex beneficiary.

Step 2. Click the “New Airwallex Beneficiary Details” button to create a new beneficiary. Note that if this is the first beneficiary created under this vendor, the beneficiary will be set as “PRIMARY BENEFICIARY”. When making bulk payments, we will always pay to the “Primary Beneficiary” of a vendor. 

Step 3. Click “Add Payment Details”.

Step 4. Fill out the beneficiary bank account creation form.

Step 5. Once you have filled out the form, click “Continue”. You can review the payment details on the subsequent page. 

Step 6. You will also be required to provide a default value for:

  • Bank Payment Reference
  • Reason

Finally, select the Subsidiary that this beneficiary is applicable to. You can select multiple subsidiaries. Click “Save” to create the beneficiary.

Step 7. Once the beneficiary is successfully created, you can see the record under the “Airwallex Beneficiary Details” subtab. You can click “EDIT” to update the beneficiary details.

Note: There is no syncing of beneficiary records between Airwallex and NetSuite. The source of truth for beneficiary information will be stored in NetSuite.

Make payment

Single Bill Payment

Step 1. To make a single bill payment, you can click on a Bill in the “OPEN” status and click “Make a Payment”.

Step 2. On the bill payment page, you will be able to:

  • Choose the currency of the Bill
  • Choose the NetSuite account that you intend to pay the bill from
  • Choose the Airwallex account to fund the payment
  • View the balance of the wallet based on the NetSuite account currency
  • Enter the payment reference
  • Select the beneficiary
  • Enter the payment reason
  • View the indicative Airwallex FX rate

Screenshot 2024-01-26 at 22.06.16.png

Please make sure that the NetSuite account selected is marked as an Airwallex account, otherwise the above Airwallex specific fields will not appear



Step 3. Then click “Save” on the Bill Payment, which instructs our plugin to create a templated payment request to send to Airwallex.

Step 4. Once the payment is successfully paid, the bill will be marked as “Paid In Full”. A transfer record will appear in the Airwallex Transfer tab. You can locate the Airwallex Transfer ID on the confirmation page and verify against the transfer record.

Bill pay_7.png

Step 5. If you have enabled “Approval Workflow” in Airwallex, the payment created will be in the “Pending Approval” state. Following approval by the designated reviewer, the payment will then proceed to be dispatched. If the reviewer rejects the payment, we will void the payment record and the bill will revert to “OPEN” status.

If your payments require transfer approvals in Airwallex, please confirm with your Account Manager that your Airwallex account has been enabled for transfer approvals for payments initiated via API.

Bulk Bill Payments

Step 1. You can also execute multiple payments in a single batch (bulk payments). Our plugin iterates through a list of payments (created as a batch in NetSuite) and calls the Airwallex payment API. Multiple bills will be reflected as a single payout item in the Airwallex wallet transaction.

Bill pay_8.png

Bill pay_9.png

When will payments leave my account when using the Payables plugin?

Payments will leave your account the day you choose to pay the bill on NetSuite. If the date you select for us to send your transfer falls on a holiday or non-working day for your recipient’s currency, then we’ll send the money on the next working day. For more information, consult our guide on when you can make a transfer.

What payment methods can I use?

Payments are deducted directly from your selected wallet balance. The payments will be sent to your vendor via different banking and local payment methods, depending on the country and currency you choose. For more information, consult our payout guide.

What FX rate is used to pay an international bill?

The FX rate used to pay your bill (if paying in a different currency) will be taken at the time of payment. We do not offer the ability to lock in FX rates (including at the time of bill creation). 

The Payables plugin functionality isn’t working, what should I do?

Please contact Airwallex support if you are unable to pay a bill from your selected wallet balance.