Configuring the TransferMate Integration for Zone AP Payments

Zone AP Payments, powered by TransferMate Global Payments, enables NetSuite users to execute secure, compliant global payments without leaving NetSuite. This article walks through the full setup process: storing your TransferMate credentials, creating an AP Payment Connection, and configuring webhooks for real-time payment status notifications.

Note: Clicking on the images within this guide will enlarge them for better viewing.

Prerequisites

Before configuring the integration, confirm that OAuth 2.0 is enabled in your NetSuite account.

1. Navigate to Setup > Company > Enable Features.
2. Select the SuiteCloud subtab.
3. Confirm that OAuth 2.0 is enabled.

Important: Enabling OAuth 2.0 is mandatory for this integration. The AP Payment Connection cannot be established without it.

Storing your TransferMate credentials in NetSuite

After completing the TransferMate onboarding process, you will receive 1 or more sets of credentials — each consisting of a username and password — depending on the number of subsidiaries onboarded. Store each credential set securely in NetSuite as API Secrets. Repeat this process for each set of credentials received.

Store the username

1. Navigate to Setup > Company > API Secrets.
2. Click Create New.
3. Enter a clear, meaningful value in the Name and ID fields. Refer to the screenshot below for an example.
4. In the Password and Confirm Password fields, enter the username provided by the TransferMate onboarding team.
5. Select the Restrictions subtab and select both the Allow for all scripts and Allow for all domains checkboxes.
6. Click Save.

Store the password

1. Click Create New again.
2. Enter a clear, meaningful value in the Name and ID fields. Refer to the screenshot below for an example.
3. In the Password and Confirm Password fields, enter the password provided by the TransferMate onboarding team.
4. Select the Restrictions subtab and select both the Allow for all scripts and Allow for all domains checkboxes.
5. Click Save.

Creating an AP Payment Connection

Create an AP Payment Connection to link your TransferMate credentials to the applicable subsidiary.

1. Navigate to AP Payment > Setup > AP Payment Connection > New.
2. Populate the following fields:
   • Name: Enter a clear, meaningful name for this TransferMate connection.
   • Subsidiary: Select the subsidiary associated with this TransferMate Payment Connection.
   • Payment Instance: Select TransferMate Default Instance from the pick-list.
   • Username: Enter the API Secret ID you created for the TransferMate username. The ID always begins with custsecret.
   • Password Secret Script ID: Enter the API Secret ID you created for the TransferMate password.
3. Click Save.

The connection is now created successfully.

Important: Creating the AP Payment Connection automatically deploys the following scripts on the Vendor Bill record. These scripts are required for Zone AP Payments to function correctly:

• AP Transaction UE
• AP Transaction CL

Configuring webhooks

Webhooks are required to receive real-time payment status notifications from TransferMate into your NetSuite account. Complete the following steps to register your NetSuite account.

1. In NetSuite's Global Search, search for OAuth 2.0 Client Credentials Setup and open the record.  
2. Click Create New.
3. Populate the following fields:
   • Entity: Select a user assigned the Administrator role.
   • Role: Select Administrator.
   • Application: Select AP Payment Integration.

   • Certificate: Upload the public certificate provided by the Zone & Co team. Download it directly from your NetSuite account by navigating to Documents > Files > File Cabinet, then opening the SuiteBundles > OAUTH 2.0 Bundle 299642 > certificates folder.

     Important: Zone & Co employees can access the certificate key in the internal shared drive. Contact your Zone & Co implementation contact if you need assistance locating it.

   • 

4. Click Save.

Saving this record automatically triggers the AP Register Payment Provider MR script, which registers your NetSuite account to receive webhook notifications from TransferMate.