Introduction
This guide outlines the process for linking your Braintree account with Anrok. This will allow you to automatically synchronize transactions and update sales tax to your Braintree invoices.
Content preview:
- Invite Anrok to your Braintree account
- Generate a new Braintree API key
- Connect to Braintree
- Add your Braintree products as product IDs
- Import your Braintree transactions
Before you begin, take a look at how the Anrok & Braintree integration works 👉
Integration architecture
From a high-level perspective, Anrok is a tool used to determine the taxability of a transaction and appends the local sales tax rate to the transaction if applicable. In addition, the platform helps track nexus exposure by aggregating all transactions in a given jurisdiction and comparing it against the relevant state thresholds. Other benefits include managing registration, returns, and remittance.
The diagrams below depict the key Anrok integration touchpoints in a typical transaction initiated in Braintree.
First subscription transaction example
- Fetch sales tax: In your self-serve checkout flow, you will fetch the sales tax for the subscription using the Anrok API, based on the customer and products info.
- Create subscription: You will then create a subscription on Braintree with an additional add-on called sales-tax and provide the sales tax amount returned from the Anrok API.
- Transaction charged: Anrok polls Braintree for transactions that were created or updated in the last 2 hours and will attach the transaction to the appropriate tax return. Anrok will also update the sales tax on its corresponding subscription if necessary (to match current tax rates and remittance status).
Future subscription transaction example
Anrok polls Braintree every 2 hours for subscriptions that will be billed within the next day and updates sales tax on it if necessary.
This will ensure that the sales tax is correct when the subscription is charged.
Checklist
Below is a checklist of steps that should be followed during the Anrok integration process.
- Provide Anrok with the Product IDs, API key, and merchant ID for the integration.
- Test the integration.
Step 1 — Invite Anrok to your Braintree account
To import your product catalog and ingest your historical transactions, Anrok requires you to create a new Braintree API key.
Note: Since Braintree's API credentials are tied to a user account, If the Braintree user who owns the key is removed or deactivated, the API key will no longer work. For this reason, it's recommended that you create a new user account specifically for Anrok or invite Anrok to your account.
Try Inviting Anrok to your Braintree account in the demo above ☝️
- In the Braintree app
, click the gear button
> Team.
- Click + New User, then under Email, enter
billing-integration-support@anrok.com
. - Under API Access, click the checkbox
next to API Access (if not already selected).
- Under Roles, click the checkbox
next to Account Admin.
- When you are finished, click Create User.
Step 2 — Generate a new Braintree API key
Once you’ve invited Anrok to your Braintree account (or created an account made specifically for Anrok’s API key) you can begin the process of creating a new Braintree API key under that account.
Try generating a Braintree API key in the demo above ☝️
- In the Braintree app
, click the gear button
> API.
- Click + Generate New API Key.
- Navigate to the new API key, then click View.
- Record the Public Key, Private Key, Environment, and Merchant ID information listed.
Step 3 — Connect to Braintree
The first step of integrating with Braintree will be connected directly to your account within Anrok. During this process, you will be required to align your accounting time zone and provide the necessary credentials associated with your Braintree account.
Try connecting with Braintree in the demo above ☝️
- In the Anrok app
, go to Data sources. Take me there!
- Select Integrate system, then under Accounting time zone, select the time zone that matches your Braintree account (or select UTC if you don't know which time zone to select).
- Under Data source, select Braintree, then enter the Public Key, Private Key, Environment, and Merchant ID listed on your Braintree API key.
- When you are finished, click Connect.
Step 4 — Add your Braintree plans as product IDs
In Anrok, your Braintree plans will be called “product IDs". These product IDs are the key driver 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 Braintree plans in the demo above ☝️
- Under New products detected, select a corresponding Product type and Tax category for each product detected. See What tax configuration should I select?
- If you'd like to assign a Product type and Tax category to multiple products at once, click the checkbox
next to each product, then select Batch assign.
- When you are finished, scroll down and click Add products.
Step 5 — Import your Braintree transactions
Now that you've assigned all of your product IDs, you can now begin importing your historical transaction from Braintree into Anrok.
Try importing your Braintree transactions in the demo above ☝️
- 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 economic nexus exposure to date.
- 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.
- Select Import transactions (or Mark as finished depending on your previous selection).
- When your transactions have finished importing, select Mark complete.
Before you begin creating and editing invoices, you will need to make sure your Braintree account has been properly configured for tax calculation. Check out how to configure your Braintree account.