Resolve Tax Payment Errors

The following provides an example of the typical errors that can occur on a Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint., and how to resolve them. It's important to take corrective action on the user’s behalf before the IRS payment deadline so that a new Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint. can be submitted before the payment deadline.

User Errors

There are circumstances where an error occurs, and we are unable to submit a payment for your UserUser - A single end-user of your application. Each user has a unique userId, which should be stored in your database and used to make API requests on behalf of this individual.. This is usually due to an invalid Social Security Number (SSN) or a mismatch between SSN and legal name. The following provides a timeline for a Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint. that failed due to a userError:

  1. Create a Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint., status = "created"
  2. A UserUser - A single end-user of your application. Each user has a unique userId, which should be stored in your database and used to make API requests on behalf of this individual. experiences a mismatch between legal name and SSN, status = "error", errorMessage = "userError"

To resolve a Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint. with a userError, you should update the user's information with the corrected social security number and/or legal name by calling the PUT /users/{userId} API endpoint. Once you’ve done this, you can create a new Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint., and Abound will reattempt the payment.

Payment Method Errors

A paymentMethodError errors occur when the account and routing numbers provided is invalid, inactive, or the payment did not go through. The following provides a timeline for that scenario:

  1. Create a Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint., status = "created"
  2. Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint. is submitted to the IRS, status = "pending"
  3. IRS is unable to process the Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint. due to invalid account and routing information, status = "error", errorMessage = "paymentMethodError"

To resolve a Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint. with paymentMethodError, create a new Payment MethodPayment Method - A bank account (checking or savings) from which your user's withholding transfers are pulled, or withdrawal transfers are returned. Each payment method has a unique paymentMethodId. with valid account and routing numbers combination using the POST /user/{userId}/paymentMethods API endpoint. Once you’ve created a new Payment MethodPayment Method - A bank account (checking or savings) from which your user's withholding transfers are pulled, or withdrawal transfers are returned. Each payment method has a unique paymentMethodId., you can create a new Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint. and Abound will reattempt the payment.

Timing Errors

A timingError occurs when the Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint. was created after the payment deadline for the quarter. The following provides a timeline for that scenario:

  1. Create a Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint., status = "created"
  2. The Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint. is submitted too late, status = "error" and errorMessage = "timingError"

To resolve a Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint. with timingError you will need to contact Abound support – it is vital that you understand the Dates & Deadlines for submitting a Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint. so this error never occurs.

For both a successful and failed quarterly tax payments, it’s important that you be notified when there is an update to the status of your Quarterly Tax PaymentQuarterly Tax Payment - A non-reversible IRS tax payment that Abound submits. Quarterly tax payments are initiated by calling the Tax Payments API endpoint.. Abound uses Webhooks to communicate with your servers when a relevant event occurs.

Read more about how to set up and utilize Webhooks in the Webhooks guide.


Did this page help you?