Tax

Subscribe to webhook events for tax form verification status changes.

Tax webhook events are in beta and may change in the future. Please contact your Account Manager for more details.

The following webhook events are available for tax form management.

Event	Description
tax.tax_form.tax_id_verification_submitted	A tax form is submitted and pending verification.
tax.tax_form.tax_id_verification_failed	A tax form's (`tax_id`) verification has failed. The recipient should resubmit valid tax information.
tax.tax_form.ready	A tax form's (`tax_id`) verification is successful and is active or ready for submission.
tax.tax_form.expired	A tax form has expired. The recipient should resubmit valid tax information.

Payload examples

Relevant webhook events:

tax.tax_form.tax_id_verification_submitted
tax.tax_form.tax_id_verification_failed
tax.tax_form.ready
tax.tax_form.expired

Payload example:

JSON

1{
2  "id": "evt_EOv7B8HkNfuCuPUYw6hGv4",
3  "name": "tax.tax_form.tax_id_verification_submitted",
4  "account_id": "acct_GkjHq213MgGO5Ell7Rfa4w",
5  "data": {
6    "id": "b7f51132-0ced-45e2-9871-13decc69ec40",
7    "taxpayer_external_identifier": "external-id-1234",
8    "type": "US_W_9" // "US_W_8_BEN_E","US_W_8_ECI","US_W_8_EXP","US_W_8_IMY",
9  },
10  "created_at": "2024-12-16T11:39:48+0000",
11  "version": "2022-12-13",
12  "source_id": "b7f51132-0ced-45e2-9871-13decc69ec40-EXPIRED-1734349188"
13}

Was this page helpful?