Abound Docs

Documentation Overview

Abound is the tax API for companies who serve 1099 income earners. We've made it simple to build the right experience for your users by dividing our offering into several core products: Tax Calculations, Income & Deduction Finder, Quarterly Tax Payments, Tax Documents. All of products can be consumed a la carte or in any combination.

Get Started    Guides

Abound's Unit integration allows you to associate your Abound user to a special purpose Tax Withholding Account at Unit.

Setting up your Abound-Unit integration

Contact your Abound account manager and let her know you'd like to leverage the Abound-Unit Integration. They will be able to get you set up in 1-2 days.

Opening a Unit Tax Withholding Account

1. Creating a User
If you have not already done so, create a user using Abound's POST /users API endpoint, passing all of the required profile information. The response will contain a unique userId. Be sure to store the userId in your database, as it will be used in opening a unit tax withholding account.

2. Open Unit Tax Withholding Account
To open this special purpose tax withholding account, you will need to call Unit's POST /accounts API, ensuring that you pass in the following two "tags":

  • {"purpose" : "tax"}
  • {"aboundUserId: "REPLACE_WITH_ABOUND_USER_ID"}

Creating a Tax Withholding

The Abound-Unit Integration automates updating your users' tax liability after each tax withholding.

1. Identify your withholding rate
First use Abound's GET user/{userId}/taxes/{year} API endpoint to retrieve your user's current smartTaxRate. The smartTaxRate represents the effective tax rate on new income. Although you're not required to use this rate, it will ensure your users are setting aside enough to cover their overall tax liability for that year.

2. Initiate money transfer into your Unit Tax Withholding account
Once you have determined the amount for your user's tax withholding, it's time to initiate the money transfer. Use Unit's API to originate an ACH or make a book transfer into your Unit Tax Withholding Account.

3. Tax Update
Once that money settles, Unit will update your user's taxes automatically. The notice of this update comes in the form of an Abound webhook.

Making a Quarterly Tax Payment

The Abound-Unit Integration automates the identity verification, enrollment, and money transfer required to pay a government entity (i.e., the IRS or state authority) and automates updating your users' tax liability after each tax payment.

1. Identify your payment amount
First, you want to calculate the amount of the tax payment. Use the Abound GET user/{userId}/taxes/{year} API endpoint and your user's current balance in their Unit Tax Withholding Account to calculate the amount your user should pay on the next quarterly tax payment deadline.

2. Grab your user's Abound payment methods
Second, you want to find the Abound paymentMethodId assigned to your Unit Tax Withholding Account. To do this, use the Abound GET /user/{userId}/paymentMethods API endpoint and locate the paymentMethodId for the payment method with a displayName equal to "Unit Tax Withholding".

📘

Note: the payment method associated with your Unit Tax Withholding Account will only show up after the first successful tax withholding.

3. Initiating the tax payment
Using the Abound POST /user/{userId}/taxPayment API endpoint, create a new tax payment with the amount from step 1 and the paymentMethodId from step 2.

Once initiated, changes in the tax payment's status will be communicated via Abound webhooks. You may also directly look up this payment using the Abound GET /user/{userId}/taxPayment/{taxPaymentId} API endpoint.

4. Tax Update
Important updates about your tax payments will be communicated via Abound webhooks.

Updated 16 days ago

Unit


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.