Testing 1099 Documents in Sandbox

Form 1099 documents will not be filed to the tax authority in your sandbox environment, so it’s the best way to test your integration before going to production. You can force a 1099 document to resolve to a specific status in your sandbox environment to test various scenarios by passing the federalIncomeTaxWithheld specified in the table below. This is especially useful when testing Webhooks for different statuses.

For example, if you want to test a Form 1099 in which the final status = "error" and message = "userError", you would create a Form 1099 with federalIncomeTaxWithheld = 333.

StatusDescriptionTesting Values
createdForm 1099 is created – this is the default statusAny other amount not listed below
verifyingForm 1099 has started the SSN verification process888
pendingForm 1099 has started the filing process with the tax authority111
doneSuccessful Form 1099 filing222
errormessage: "userError"333
errormessage: "payerError"444
errormessage: "documentError"555
errormessage: "ssnVerificationError"999

For TIN Verification:

Status

Description

Testing Values

unverified

Unverified

999999999

verified

Successful Tin Matching

000000000

mismatch

TIN and name do not match.

333333333

error

This is a system-failure error and should rarely,
if ever, occur.

111111111

lockedOut

Verification for user locked for 24-hours.

555555555


Did this page help you?