Overview

Your integration path

Four steps take you from credentials to data flowing. Do them in this order, because each depends on the one before it. If you have not read Prerequisites yet, start there.

1. Authenticate your tenant: get a bearer token from your backend with POST /v1/oauth/token. It lasts 24 hours.
2. Set up your filer: create the entity that submits returns. Account owners and accounts cannot be created until the tenant has one.
3. Create account owners and accounts: create a record for each user whose tax data you collect, and an account for their activity.
4. Choose your data path: send transactions for Taxbit to compute, or send form items you compute yourself.

The three things Taxbit does

1. Collect tax documentation. W-9, W-8, DAC7 and MRDP seller data, and CRS/CARF self-certification, collected through the React SDK and validated in real time.
2. Calculate cost basis and gains. Lot-level inventory and realized gains under HIFO, FIFO, LIFO, or LOFO, computed from the transactions you send. See Cost Basis & Gains.
3. Report to tax authorities. 1099 filings with the IRS, DAC7 and MRDP submissions in the EU and UK, and CARF/DAC8 as those regimes come into force. See US Information Reporting, Digital Platform Reporting, and Digital Asset Reporting.

Two objects you need before anything else

Almost every integration problem we see traces back to these two. An account owner is the person or entity whose tax data you are collecting. An account is a container of activity belonging to that owner. Transactions attach to accounts, and tax documentation attaches to account owners. See the Account Owners and Accounts reference.

📘

Create the account owner before you mount the SDK

The SDK authenticates with an account-owner-scoped token, which your backend mints with POST /v1/oauth/account-owner-token using the account owner's ID. The token lasts one hour. The account owner must already exist when the SDK loads, or the SDK cannot load that user's questionnaire. Create the account owner from your backend during signup, not at the moment the user opens the form. This is the most common cause of a questionnaire that fails to load.

Where to go next

Once data is flowing, pick the section for your platform:

• US Information Reporting: collect W-9s and report 1099-K, 1099-NEC, and 1099-MISC for payments platforms and marketplaces.
• Cost Basis & Gains: track cost basis, calculate gains and losses, and deliver tax forms to your users.
• Digital Platform Reporting (DAC7 & MRDP): meet DAC7 and MRDP seller reporting obligations in the EU, UK, and OECD.
• Digital Asset Reporting (CARF & DAC8): prepare for CARF and DAC8 with self-certification and transaction reporting.
• Tax Documentation React SDK: collect W-9, W-8, and self-certification data inside your app.

Questions? Contact your Taxbit implementation manager or [email protected].