Introduction

Zone AP Payments, powered by TransferMate Global Payments, enables NetSuite users to execute secure, compliant global payments directly from within their NetSuite account. 

After completing the onboarding process with TransferMate, you will receive one or more sets of credentials, each consisting of a username and password, depending on the number of Subsidiaries onboarded with TransferMate. These credentials are required to establish a secure connection between your NetSuite account and the TransferMate API. Once configured, you will be able to pay vendor bills directly from within NetSuite.

Prerequisities

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

1. Navigate to Setup > Company > Enable Features

2. Open the SuiteCloud tab

3. Ensure that OAuth 2.0 is enabled

Note: Enabling OAuth 2.0 is mandatory for this integration.

Secure Username and Password

Once you receive the username(s) and password(s) from the TransferMate onboarding team, you must store them securely in NetSuite. This setup process should be repeated for each set of credentials received.

1. Navigate to Setup > Company > API Secrets

2. Click Create New

3. Populate the Name and ID fields (refer to the example shown in the screenshot below)

4. In the Password and Confirm Password fields, enter the username provided by the TransferMate onboarding team

Switch to Restrictions tab and mark options:  Allow for all scripts and Allow for all domains.

Click Save.

Click one more time the button Create New.

Populate Name and ID  fields (refer to the example shown in the screenshot below).

In the Password and Confirm Password fields, enter the password provided by the TransferMate onboarding team

Switch to Restrictions tab and mark options:  Allow for all scripts and Allow for all domains.

Click Save.

Keep the browser tab with API secrets opened as IDs of API secrets will be needed in the next steps.

Create AP Payment Connection

Create a Payment Connection and link it to the applicable Subsidiary associated with the corresponding TransferMate credentials.

Navigate to AP Payment > Setup > AP Payment Connection > New

Populate the following fields:

Name: Enter a clear and meaningful name for the specific TransferMate Connection. 

Subsidiary: Select the subsidiary associated with this TransferMate Payment Connection.

Payment Instance: Select "TransferMate Default Instance" from the dropdown list.

Username: Populate the previously created API Secret ID for the username associated to this connection. The ID will always begin with custsecret.

Password Secret Script ID: Populate the previously created API Secret ID for the password associated with this connection.

Click Save.

The connection should be successfully created.

Note:

Creating the connection automatically triggers the deployment of 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

Webhooks Configuration

Webhooks mechanism is a mandatory setup used to receive real-time payment status notifications from the payment provider into your NetSuite account.

1. In NetSuite’s Global Search, enter OAuth 2.0 Client Credentials Setup and open the page.

2. Click Create New.

3. Populate the following fields:

• Entity: Select a user with Administrator role
• Role: Administrator
• Application: AP Payment Integration
• Certificate: A public certificate provided by the Zone & Co team
  Note: The certificate key is available internally here.

4. Click Save.

Upon saving the following script is triggered automatically to register your NetSuite account for webhooks:
AP Register Payment Provider MR.