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 accountNumber 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 accountNumber = "333".

Status	Description	Testing Values
`created`	Form 1099 is created – this is the default status	Any other amount not listed below
`verifying`	Form 1099 has started the SSN verification process	`"888"`
`pending`	Form 1099 has started the filing process with the tax authority	`"111"`
`done`	Successful Form 1099 filing	`"222"`
`error`	`message: "userError"`	`"333"`
`error`	`message: "payerError"`	`"444"`
`error`	`message: "documentError"`	`"555"`
`error`	`message: "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`