Install the NetSuite connector invoice payment link

Learn how to self-serve onboard and set up the Stripe Connector for NetSuite payment link.

You can use the free, self-serve version of the Stripe Connector for NetSuite to integrate Stripe payment links into your NetSuite Enterprise Resource Planning (ERP) system and accept payments. The free version of the connector doesn’t include syncing payments or other data to NetSuite.

Compare plans

Choose between a free or a full plan for your Stripe Connector for NetSuite implementation. To learn more about the full version, you can install the app and request a demo.

Before you begin

Make sure you have the following to get started with the free version:

• A Stripe account
• A NetSuite account
• Administrator or equivalent access to both accounts
• A clear understanding of the invoice creation process in NetSuite

Obtain your Stripe account ID

You must find and make a note of the Stripe account ID for each account you want to connect. If you’re setting up multiple subsidiaries, repeat the following steps for all accounts.

1. In the Stripe Dashboard, go to the Business settings page.
2. On the Account details tab, copy the Account ID . This value is case sensitive.

Install the app

In the Stripe App Marketplace, on the Stripe Connector for NetSuite page, click Install app.

If you need to set up multiple accounts, make sure you provide Stripe sales with all of the account IDs you want to set up. You then need to install the app for each account.

Connect your Stripe and NetSuite accounts

Note

After installing the app, you can follow the in-app wizard to complete this step.

Use token-based authentication to securely connect your Stripe and NetSuite accounts.

To do so, log in to your NetSuite account and go to Setup > Company > Enabled Features. On the SuiteCloud tab, enable the following:

• SOAP web services
• Token-based authentication

Some services, like token-based authentication, can take a day to propagate when enabled.

Install the Stripe Token Based Authentication bundle (ID 178262). Then, add the Stripe Limited Access role created from the bundle to your preferred employee. We recommend using a dedicated employee.

Handle NetSuite subsidiaries

Do the following if you have subsidiaries in NetSuite, even if only one subsidiary uses the payment link:

1. Open the Stripe Limited Access role.
2. For Accessible Subsidiaries , select All Subsidiaries .
3. Enable Allow Cross-Subsidiary Record Viewing .
4. Under Permissions > Lists , add View permissions for your subsidiaries.

Obtain your NetSuite account ID

Log in to your NetSuite account, and go to Setup > Company > Company Information. Make a note of your NetSuite account ID, which is case sensitive.

Create an access token

Navigate to Setup > Users/Roles > Access Tokens, and click New to create an access token with the following values:

• Application name: Stripe Connector for NetSuite
• User: [employee record]
• Role: Stripe Limited Access
• Token name: Stripe Connector for NetSuite - [Main Contact], Stripe Limited Access

When finished, click Save, but don’t close the window.

Add a token to the NetSuite connector app

In the Stripe Dashboard, on the app dock, click the Stripe Connector for NetSuite app icon.

On the App Settings page, under NetSuite credentials, enter the following:

• NetSuite account ID
• Token ID
• Token secret

Install and configure the payment link field

Note

If you use the free payment page, click Set Up Payment Pages, and then follow the in-app wizard to complete this step.

1. In your NetSuite account, go to Customization > SuiteBundler > Search & Install Bundles.
2. Search for 449983 to find and install the Stripe Invoice Payment Page bundle.
3. (Optional) To use the payment page for transactions created before installation, you must apply a GUID to past transactions (used as a security measure). To do so, search for 581482 to find and install the Stripe Payment Page GUID Backfill bundle. After installation, this bundle applies a GUID to all applicable transactions, and sends you a confirmation email upon completion.
4. After the Stripe Invoice Payment Page is installed, go to Customization > Lists, Records, & Fields > Transaction Body Fields.
5. Edit the Stripe payment page, and then go to the Validation & Defaulting tab.
6. Update the Default Value field as follows: On a new browser tab in your NetSuite account, go to Customization > SuiteBundler > Search & Install Bundles. Search for 218349 to find and install the Stripe Subsidiary Stripe Account ID bundle. For each subsidiary that you want to have use a payment link, edit its entity record to add the Stripe account ID that corresponds to that subsidiary.

• To install the payment link on one NetSuite subsidiary, edit the formula to use your Stripe account ID in either a testing environment or in live mode. For example: https://netsuite-connector.stripe.com/payment/acct_1M6zZFLzNi11nE9A/test/invoice/184BB28E2462B9ABE0630F192E0A1219_32590401.
• To install the payment link on two or more NetSuite subsidiaries within a OneWorld account, edit the formula to replace acct_REPLACE_ME with the dynamic value '||{subsidiary.custrecord_stripe_account_id}||'. For example: https://netsuite-connector.stripe.com/payment/'||{subsidiary.custrecord_stripe_account_id}||'/test/invoice/.

7. On the invoice forms that you want to use to collect payment, add the Stripe Payment Page and Stripe Payment Page GUID transaction body fields.

Validate the payment link

Create a NetSuite invoice, and make sure the payment link appears for Stripe Payment Page.

Validate the payment link’s structure by copying the URL and checking the following:

• The correct Stripe account ID is present.
• The correct mode is present: test or live.
• The URL matches this structure: /payment/acct _ the relevant part of the product _ InternalId .

Enable the integration

In the Stripe Dashboard, go to the connector’s App Settings page.

Under NetSuite invoice payment page, select Enable NetSuite invoice payment page, then click Save.

Click the payment link URL on the NetSuite invoice you created to validate that a Stripe Checkout page automatically creates to collect payment.

See also

• Stripe Connector for NetSuite invoice payment link
• Troubleshooting