To ensure that Stripe Tax correctly calculates liabilities within NetSuite, your NetSuite Nexuses must be synchronized with your Stripe Tax Registrations.

PayPack automates this process using a built-in Map/Reduce script that imports your active registrations from Stripe and creates the corresponding records in NetSuite.

Watch the video below to learn how to automate the synchronization of your Stripe Tax Registrations with NetSuite Nexuses.

Create Registration in Stripe

Before running the import in NetSuite, you must define your tax footprint in the Stripe Dashboard.

1. Log in to your Stripe Dashboard.

2. Navigate to Settings (Gear Icon) > Tax > Registrations.

3. Click + Add Registration.

4. Select the Country and State/Province where you are registered to collect tax.

5. Enter the Effective Date and your Tax ID (if applicable).

6. Click Save.

Repeat this for every jurisdiction where you have a legal or economic obligation to collect tax.

Import Registration into NetSuite

Once your registrations are live in Stripe, use the PayPack Map/Reduce script to bring them into NetSuite.

1. In NetSuite, navigate to Lists > Scripting > Scripts.

2. Locate the script titled: PayPack Stripe Tax Registrations Sync MR.
   

3. Click View next to the script, then navigate to the Deployments subtab.

4. Click the link for the Script Deployment (usually labeled PayPack Stripe Tax Registrations Sync MR Deploy).

5. On the Deployment record, click Edit, then select Save and Execute when status is testing from the blue save button dropdown.

6. Status Check: You will be redirected to the Map/Reduce Status page. Wait until the "Status" column shows Complete.

What this script does: It queries your Stripe account via the PayPack API and creates a custom Nexus record for you to validate and trigger Nexus creation if approved.

Deploy Scheduled Script

Schedule the script to run once per day by setting the script deployment status to scheduled.

Finalize Configuration (Legacy vs. SuiteTax)

Depending on which tax engine your NetSuite account uses, you must perform one final manual step to link the newly imported nexuses to Stripe.

Option A: If you are on SuiteTax

SuiteTax requires you to explicitly assign a "Tax Engine" to each registration on the Subsidiary record.

1. Navigate to Setup > Company > Subsidiaries.

2. Click Edit next to the Subsidiary associated with these nexuses.

3. Click the Tax Registrations subtab.

4. The script will have added the nexuses here. Ensure the following:

   • Tax Engine: Select Stripe from the dropdown for each new registration.
   • Effective From: Ensure this matches your Stripe registration date.

5. Click Save.

Option B: If you are on Legacy Tax

Legacy tax (Advanced Taxes) uses a flatter structure. The script creates the Nexus, but you must ensure the subsidiary is linked.

1. Navigate to Setup > Accounting > Nexuses.

2. Confirm the new Nexuses appear in the list.

3. Navigate to Setup > Company > Subsidiaries.

4. Click Edit on your Subsidiary and go to the Nexuses subtab.

5. Ensure the newly imported nexuses are listed. If not, add them manually and click Save.

6. Note: In Legacy Tax, PayPack handles the API call logic based on the "Enable Stripe Tax" checkbox in your PayPack Configuration, rather than a "Tax Engine" dropdown on the Nexus itself.