# Embedded component response

Source: https://developer.avalara.com/products/avalara-1099-and-w9/integration-guides/1099-and-w-9/seo9735289215714/

Guide: 1099 & W-9

# Embedded component response

Review the JSON response from the embedded W-9 component, understand TIN match statuses, and test sandbox TIN values.

When a W-9 form is submitted through the embedded component, the system returns a JSON response with details about the completed form.

This response is available in the browser console and through your API integration. It includes information such as the form type, reference ID, submission timestamp, and TIN match status.

{
  "id": "01010101-0101-0101-0101-010101010101",
  "type": "form\_request",
  "attributes": {
    "form\_type": "W-9",
    "company\_id": 505505505,
    "company\_name": "My Company Name",
    "company\_email": "my\_email@email.com",
    "reference\_id": "V-100000",
    "form\_id": 909909909,
    "signed\_at": "2024-09-05T15:54:15.956-04:00",
    "tin\_match\_status": "matched",
    "expires\_at": "2024-09-05T16:24:15.984-04:00"
  },
  "links": {
    "signed\_pdf": "https://www.track1099.com/api/v1/public/form\_requests/01010101-0101-0101-0101-010101010101/download\_signed"
  }
}

Use this response to:

-   Identify the submitted form (`id`, `reference_id`).
-   Track when the form was signed (`signed_at`).
-   Verify the TIN match result (`tin_match_status`).
-   Provide access to the signed PDF (`signed_pdf`).

The `signed_pdf` value is a temporary URL that provides access to the signed form. This link expires at the same time as the `form_request` (approximately 3,600 seconds).

Note

Treat the format of the `signed_pdf` URL as opaque and don’t rely on its structure, as it may change in future versions.

## Embedded component response statuses

After a W-9 form is submitted, the `tin_match_status` field indicates the result of TIN validation.

-   **matched**, the name and TIN combination matches IRS records.
-   **rejected**, the TIN validation failed.
-   **pending**, the validation request is in progress or will be retried.

The **pending** status can occur if:

-   There was an issue performing TIN matching.
-   The user entered multiple TIN values during the same session.

In these cases, the system retries TIN matching in the background, typically within 24 hours.

Note

In sandbox environments, TIN matching is simulated and doesn’t validate against the IRS.

## Sandbox TIN test values

Use these TIN values in a sandbox to simulate different validation outcomes.

## Simulate successful validation (matched)

Use TINs ending in **0** to test successful validation scenarios.

-   **123-45-6780** - IRS confirms name and SSN match.
-   **987-65-4320** - Valid taxpayer information.
-   **555-12-3450** - Verification successful.

## Simulate failed validation (rejected)

Use TINs ending in **2** or **3** to test validation failures and error handling.

-   **123-45-6782** - SSN not currently issued by the IRS.
-   **987-65-4323** - Name and SSN combination doesn’t match IRS records.
-   **555-12-3452** - Invalid or nonexistent SSN.

## Simulate invalid or unknown results

Use TINs ending in **1, 4, or 5** to test invalid input and processing error scenarios.

-   **123-45-6781** - Missing or invalid SSN format.
-   **987-65-4324** - Invalid request format, such as unsupported characters.
-   **555-12-3455** - Duplicate request.