Integrate Anrok & Stripe

Introduction

This guide outlines the process for linking your Anrok account with Stripe. This will allow you to automatically synchronize invoices and credit notes for tax returns filing and update sales tax to your Stripe invoices.

The Anrok Stripe integration is a native-to-Stripe integration that has full feature support across Stripe billing workflows including Checkout, Elements, Stripe API, Invoices, Subscriptions, Quotes, Customer Portal, and Payments Links. These workflows are supported out-of-the-box with our no-code setup guide below. 

 

Click here to take a look at how the Anrok & Stripe integration works

Integration architecture

Diagram_ Stripe integration (2.0).png

  1. Customer initiates checkout - the customer initiates a transaction in Stripe using any Stripe invoicing workflow. In this example, we will show a checkout session. 
  2. Seller collects customer and product information - During checkout, sellers collect relevant payment data from the customer, including the customer address, line item amounts, product IDs, and any relevant customer tax IDs depending on the jurisdiction.
  3. Invoice preview - During checkout, as checkout or customer data is updated, tax is refreshed dynamically in real-time showing a new invoice or subscription preview. 
  4. Validate information and calculate tax - When Stripe receives new checkout information, Stripe calls Anrok in the background to validate the relevant information for tax calculation – including the tax categories of products sold, the customer address, and any tax exemption data. Anrok calculates the relevant tax amount and provides it back to Stripe. 
  5. Stripe finalizes the invoice with tax and collects payment - Upon customer checkout submission, Stripe will validate the payment details and finalize the Stripe invoice with tax if applicable. 
  6. Invoice finalized and recorded for filing - once the invoice is finalized in Stripe, Anrok is notified through an asynchronous webhook process. The invoice is recorded and associated to the relevant Anrok tax return for automated filing.
  7. Anrok continues to monitor for downstream invoice adjustments - After invoice finalization, Anrok continues to monitor for downstream billing updates using webhooks, including invoice credit notes, invoice voids, uncollectible invoices, retroactive exemptions, and subscription prorations. When necessary, Anrok will create tax-only credit notes in Stripe to align tax calculations and deduct equivalent tax due on current period returns.

 


 

Step 1

Connect with your Stripe account

The first step to integrate Anrok with Stripe is connecting your Stripe account through the Anrok data sources dashboard. During this process, you must align your accounting time zone and provide the credentials associated with your Stripe account.

Try connecting with Stripe in the demo above ☝️

  1. In the Anrok app CleanShot 2023-07-20 at 12.02.21@2x.png, go to Data sources. Take me there!
  2. Select Integrate system, then under Accounting time zoneselect the time zone that matches your Stripe account.
  3. Under Data source, select Stripe.
  4. Under Environmentselect whether you are connecting your Live or Test Stripe environment.
  5. Click Connect with Stripe, then sign in with your Stripe credentials.
  6. Select the account you’d like to connect to Anrok, then click Connect →.
  7. Once you see "anrok_connect_checkmark.png You are now logged into Stripe”, click Connect.

 


 

Step 2

Add your Stripe products as product IDs

In Anrok, your Stripe products will be called product IDsProduct ID
They describe the specific product or service that was sold to your customer. Product IDs are passed to Anrok from your billing system as the product(s) you are including on the invoice.
CleanShot 2023-08-17 at 11.17.48@2x.png
Each product ID you sell must be mapped to a corresponding tax configuration in Anrok, which signals what taxability ruleset to apply to the product.
. These product IDs are the key drivers for calculating taxability. It's important that you add your current and previous Stripe products into Anrok. See What are product IDs?

Try adding your Stripe products in the demo above ☝️

  1. Under New products detected, select a corresponding Product type and Tax category for each product detected. See Select a tax configuration.
  2. If you'd like to assign a Product type and Tax category to multiple products at once, click the checkbox  anrok_checkbox.png  next to each product, then select Batch assign.
  3. When you are finished, scroll down and click Add products.

 


 

Step 3

Import your Stripe transactions

Now that you've assigned all of your product IDsProduct ID
They describe the specific product or service that was sold to your customer. Product IDs are passed to Anrok from your billing system as the product(s) you are including on the invoice.
CleanShot 2023-08-17 at 11.17.48@2x.png
Each product ID you sell must be mapped to a corresponding tax configuration in Anrok, which signals what taxability ruleset to apply to the product.
, you can now begin importing your historical transactions from Stripe into Anrok.

Try importing your Stripe transactions in the demo above ☝️

  1. Under Select transactions to import, select one of the following options:
    • Import all past transactions — all transactions will be imported into Anrok. This will result in a complete picture of your economic nexus exposure.
    • Import transactions from a specific date — some past transactions will not be imported into Anrok. This may result in an incomplete picture of your current economic nexus exposure.
    • Continue without importing past transactions — none of your historical transactions will be imported into Anrok. This may result in an incomplete picture of your economic nexus exposure.
  2. Select Import transactions (or Mark as finished depending on your previous selection).
  3. When your transactions have finished importing, select Mark complete.

 


 

Step 4

Set a default product ID

If you have an automated workflow that can generate new product IDsProduct ID
They describe the specific product or service that was sold to your customer. Product IDs are passed to Anrok from your billing system as the product(s) you are including on the invoice.
CleanShot 2023-08-17 at 11.17.48@2x.png
Each product ID you sell must be mapped to a corresponding tax configuration in Anrok, which signals what taxability ruleset to apply to the product.
in Stripe, we recommend creating a default product ID. When a default product ID has been set, Anrok will apply its tax configuration whenever a Stripe product hasn't been configured in Anrok. See Set up a default Product ID.

Try setting a default product ID in the demo above ☝️

  1. In the Anrok app CleanShot 2023-07-20 at 12.02.21@2x.png, go to Data sources. Take me there!
  2. Under Integration sources, click the Options menu button anrok_option_menu.png next to Stripe, then select Configure new products.
  3. Under Default product, click Set default product.
  4. Select a corresponding Product type and Tax category for each product detected. See Select a tax configuration.
  5. When you are finished, click Add products.

 


 

Step 5

Turn on Stripe Automatic Tax with Anrok 

The final step to enabling Anrok automatic tax for your go-forward Stripe dashboard billing workflows is to set Anrok as your tax provider in Stripe and turn on Stripe automatic tax. This will allow you to calculate tax using the Stripe dashboard for Invoices, Subscriptions, Quotes, and dashboard-created Payment Links.

Important CleanShot_2024-05-03_at_20.22.03_2x-removebg-preview.png

Enabling Stripe Automatic Tax with Anrok is available for Stripe integrations created after April 2025. If your Stripe integration was created prior to April 2025, before enabling Stripe Automatic Tax with Anrok, please reach out to Anrok Technical Solutions (technicalsolutions@anrok.com) to assist with migrating your integration version to support Automatic Tax. 

Try connecting with Stripe in the demo above ☝️

  1. In the Stripe app CleanShot 2023-07-19 at 13.03.46@2x.png, navigate to your Stripe tax integration settings. Take me there!
  2. Under Tax calculation: set Anrok as your tax provider.
    • Click Manage and follow the setup steps to choose CleanShot 2023-07-20 at 12.02.21@2x.png Anrok and install the Anrok Stripe app. 
  3. Under Dashboard transactions: toggle Use automatic tax on CleanShot 2024-09-16 at 11.21.18@2x.png 
    • Anrok is now enabled and will apply tax to new transactions initiated from your Stripe dashboard. 
  4. If using Payment Links, ensure that your Payment Links are configured to create invoices by setting Create an invoice PDF in the Payment Link After payment section. 

 


 

Step 6

Modify your existing Stripe API calls

Note CleanShot_2024-04-30_at_16.01.40_2x-removebg-preview.png

Modifying your API calls is only necessary when using Stripe API flows, including Checkout Sessions, Invoices, Subscriptions, Quotes, or Payment Links created via the Stripe API.

  1. Update your API calls to include the automatic_tax[enabled]=true parameter. Make this change for all codepaths where you create Checkout Sessions, Invoices, Subscriptions, Quotes, or Payment Links via the Stripe API.
  2. Ensure that your Stripe Checkout Sessions and Payment Links are configured to create invoices by setting the invoice_creation[enabled]=true parameter in your Stripe API calls (Checkout, Payment Links). This parameter is only required for non-subscription billing flows since Stripe subscriptions always create invoices. 
  3. If you are planning to support non-US jurisdictions with Stripe Checkout, also ensure that your Stripe Checkout Sessions are configured to collect customer tax IDs by using the tax_id_collection[enabled]=true parameter. 

 


 

Step 7

Migrate your pre-existing Stripe subscriptions to use Automatic Tax

When using Anrok Automatic Tax in Stripe, we recommend ensuring that all pre-existing Stripe subscriptions also have automatic tax enabled. Stripe provides a helpful migration tool to migrate your existing subscriptions to use Automatic Tax.  

  1. In the Stripe app CleanShot 2023-07-19 at 13.03.46@2x.png, go to your subscriptions migration tool. Take me there!
  2. If you need to take action to migrate any subscriptions, Stripe will alert you in the migrations dashboard. Click Start update to begin your subscriptions migration if necessary. 

 

Note CleanShot_2024-04-30_at_16.01.40_2x-removebg-preview.png

Before you begin creating and editing invoices, you must ensure your Stripe account has been properly configured for tax calculation. Check out how to configure your Stripe account.

Can't find what you're looking for?

Submit a request to our customer care team!