Sandbox Testing
Below are a list of test tin
values you can use in the Sandbox environment to mimic real-world scenarios.
Simply pass the tin
values below in a POST /tin-verification
API call to experience the corresponding scenario. Webhooks fire for all status changes.
Test Scenarios
tin | Scenario | Description |
---|---|---|
000000000 | Synchronous MATCH of an INDIVIDUAL | This scenario will return a synchronous response with a status of MATCH and a tinType of INDIVIDUAL (i.e. SSN, ITIN). |
111111111 | Synchronous MATCH of an BUSINESS | This scenario will return a synchronous response with a status of MATCH and a tinType of BUSINESS (i.e. EIN). |
222222222 | Synchronous MATCH of an unknown tinType | This scenario will return a synchronous response with a status of MATCH and a missing tinType . Although rare, in this scenario we were unable to detect the tinType . |
333333333 | Synchronous MISMATCH | This scenario will return a synchronous response with a status of MISMATCH . |
444444444 | Asynchronous MATCH of an INDIVIDUAL | This scenario will return a synchronous response with a status of PENDING . Shortly after the status will update to MATCH paired with a tinType of INDIVIDUAL and send a TIN_VERIFICATION_MATCH webhook. |
555555555 | Asynchronous MATCH of an BUSINESS | This scenario will return a synchronous response with a status of PENDING . Shortly after the status will update to MATCH paired with a tinType of BUSINESS and send a TIN_VERIFICATION_MATCH webhook. |
666666666 | Asynchronous MATCH of an unknown tinType | This scenario will return a synchronous response with a status of PENDING . Shortly after the status will update to MATCH and send a TIN_VERIFICATION_MATCH webhook. |
777777777 | Asynchronous MISMATCH | This scenario will return a synchronous response with a status of PENDING . Shortly after the status will update to MISMATCH and send a TIN_VERIFICATION_MISMATCH webhook. |
888888888 | Ever-living PENDING | Although not a real-world scenario, we provide this test value as a helpful way to test asynchronous cases without it immediately resolving to a MATCH or MISMATCH . |
Any value other than the test values above will result in a MISMATCH
.
Updated about 2 months ago