NetCash Direct API Connection
Overview
NetCash supports direct API connections to select banking institutions, enabling automated transaction syncing between a client's bank accounts and NetCash without manual file imports. This integration is available for the following institutions:
- JP Morgan
- Wells Fargo
- Bank of America CashPro
- KeyBank
What to Expect
Direct API setup is a multi-party process involving the client, their bank, and Netgain. The timeline varies by institution but should be expected to span several weeks. Clients should plan accordingly and initiate the process as early as possible.
The following summarizes what each party contributes to the setup:
Client responsibilities:
- Initiate contact with their bank account manager to request the integration
- Work with the bank's implementation team to authorize Netgain's access to the relevant accounts
- Provide the bank with a list of accounts to be provisioned
- Sign any forms or agreements required by the bank
Bank responsibilities:
- Assign an implementation representative and manage the provisioning process
- Issue Sandbox and Production API certificates and credentials to Netgain
Netgain responsibilities:
- Complete technical configuration in NetCash once credentials are received
- Conduct Sandbox testing prior to activating the Production connection
Setup Process
Step 1: Client contacts their Bank Account Manager
The client initiates the process by contacting their dedicated account manager at the bank. The purpose of this outreach is to request a direct API connection to NetCash and to be connected with the appropriate implementation team.
The following sample email may be used as a starting point:
Subject: Direct API Integration Request – NetCash by Netgain
Hi [Account Manager Name],
We are implementing NetCash, a cash management application managed by Netgain, and would like to set up a direct API connection to pull transaction activity from our bank accounts into the application.
Could you please connect us with the appropriate team to set up a project for this integration? We would also appreciate guidance on the information and authorizations required on our end to move forward.
Thank you, [Client Name]
Step 2: Bank-Led Implementation
Following the initial outreach, the bank will assign an implementation representative and walk the client through their institution-specific provisioning process. The steps involved vary by bank and are managed by the bank's implementation team. The client should expect to provide authorization for account access and any additional information the bank requests.
Netgain will coordinate on the technical side once credentials are received.
Final Step: Client Provides Netgain Team with NetSuite Credentials
Once the Netgain team has received credentials from the bank and set up the project, Netgain will request from the client their NetSuite credentials and URL's, including:
- Consumer Key / Client ID
- Consumer Secret / Client Secret
- Token ID
- Token Secret
- Restlet URL
- Restlet External URL
Follow the steps outlined below to retrieve these credentials. Please note that these steps must be completed for both sandbox and production.
- Navigate to Setup > Integration > Manage Integrations > New.
- Enter a descriptive name for the bank-to-NetCash integration.
- Ensure Authorization Code Grant is unchecked, then check Token-Based Authentication.
- Uncheck TBA: Authorization Flow.
- Click Save. Record the credentials displayed — these will be required to establish the connection.
- Return to the NetSuite Home page to set up a new access token.
- Click Manage Access Tokens, then click New to create a new access token.
- Select the integration created in the previous steps.
- Click Save. Record the Token ID and Token Secret — both are required to complete the connection.
- Navigate to Customization > Scripting > Scripts.
- Click View on the "NetCash | SuperSync | RL" Restlet.
- Click Deployments. Then, select the deployment record.
- Copy the URL and External URL.
Once complete, provide these credentials and URL's to the Netgain team. With these, the Netgain team can start the API flow.
