Set up the NetSuite Customer Payment Page

Learn how to configure the Customer Payment Page in the Stripe Connector for NetSuite (SCN).

Warning

If you’re migrating from SuiteSync to the Stripe Connector for NetSuite, use the migration instructions.

The NetSuite Customer Payment Page supports global payment methods and ACH functionality, including Stripe Financial Connections.

Obtain your Stripe account ID

Locate and note 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 and configure the Stripe Customer Payment Page bundle

1. In your NetSuite account, go to Customization > SuiteBundler > Search & Install Bundles .

2. Search for 497039 to find and install the Stripe Customer Payment Page bundle.

3. (Optional) To use the payment page with multiple NetSuite subsidiaries and Stripe accounts, you must also search for 218349 to find and install the Stripe Subsidiary Account ID bundle. After installation, this bundle applies a custom entity field named Stripe Account ID to each subsidiary, where you can hardcode the appropriate Stripe account ID. Note The SCN app also uses this bundle for the Invoice Payment Page and Sales Order Payment Page.

4. After installing the Stripe Customer Payment Page bundle, go to Customization > Lists, Records, & Fields > Entity Fields.

5. Edit the Stripe Customer Payment Page field with the custentity_customer_payment_page_link ID.

6. On the Validation & Defaulting tab, update the Default Value field as follows: Default Value formula for a single Stripe account the related setting the related setting {custentity_customer_payment_page_guid} is NULL the related setting 'https://netsuite-connector.stripe.com/payment/ acct_1M6zZFLzNi11nE9A /test/customer/'||{id}||'/'|| (to_number(({datecreated} - to_date('01-JAN-1970','DD-MON-the related setting')) * (86400))) the related setting 'https://netsuite-connector.stripe.com/payment/ acct_1M6zZFLzNi11nE9A /test/customer/'||{id}||'/'||{custentity_customer_payment_page_guid} END Default Value formula for multiple Stripe accounts the related setting the related setting {custentity_customer_payment_page_guid} is NULL the related setting 'https://netsuite-connector.stripe.com/payment/ '||{subsidiary.custrecord_stripe_account_id}||' /test/customer/'||{id}||'/'|| (to_number(({datecreated} - to_date('01-JAN-1970','DD-MON-the related setting')) * (86400))) the related setting 'https://netsuite-connector.stripe.com/payment/ '||{subsidiary.custrecord_stripe_account_id}||' /test/customer/'||{id}||'/'||{custentity_customer_payment_page_guid} END The formula has two instances of the Stripe account value and two instances of the test or live identifier. Use the same values for both. The formula has conditional logic to make sure the URL has a random value. For customer records created after you install the bundle, a globally unique identifier (GUID) is added automatically by the hidden customer record Stripe Payment Page GUID field with a custentity_customer_payment_page_guid ID. For customer records created before you installed the bundle, the creation date generates the identifier within the URL.

• For a single Stripe account using the Customer Payment Page, replace the acct _ the related setting _ ME placeholders with the appropriate Stripe account ID, as shown below. Verify that the test or live values match the environment where you’ll use this formula.
• (Optional) For multiple Stripe accounts using the Customer Payment Page, replace the acct _ the related setting _ ME placeholders with the dynamic Stripe account value '||{subsidiary. custrecord _ stripe _ account _ id}||' , as shown below. Verify that the test or live values match the environment where you’ll use this formula.

4. In the Stripe Customer Payment Page field settings, make sure to uncheck the Store Value checkbox ( false) and configure the Type field to Hyperlink. After verifying the configuration, click Save.
5. On the customer forms that you want to use to collect payment, add the Stripe Customer Payment Page and the Stripe Customer Payment Page GUID entity fields.
6. (Optional) If you previously installed the Stripe Subsidiary Account ID bundle with ID 218349, edit each subsidiary record that uses the Customer Payment Page, and add the Stripe account ID that corresponds to the subsidiary in the Stripe Account ID field. Note The SCN App also uses this bundle for the Invoice Payment Page and Sales Order Payment Page.

Turn on Customer Payment Page creation

1. Go to the SCN App Settings > Payments tab.
2. Under the NetSuite Initiated Payments section, turn on the NetSuite customer payment pages setting.
3. Click Save for that section.

Validate the payment link

1. Create a NetSuite customer or use an existing one. Make sure the payment link appears in the Stripe Customer Payment Page field. The Stripe Customer Payment Page GUID field is hidden by default, and you can keep it hidden.
2. 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: /the relevant part of the product. For example: https://netsuite-connector.stripe.com/payment/acct_1NO668BmS92eSDlM/test/customer/732755/35A95C3035F7ECDFE063D61A000A917D

3. Click the URL and verify the Checkout Session opens with the correct customer balance information.

Configure optional settings

Follow these instructions to configure optional settings:

• Configure the payment methods you want to support.
• Save payment methods for future use .
• Customize your branding settings .
• Add a Pay Now button to your customer statement PDF files.
• Send email receipts for payments.

See also

• Customer Payment Page
• Troubleshooting