Fulfillments

Track the outcomes of tax liability adjustments resolved by Check on behalf of an employer.

🚧

This feature is currently under development

The Fulfillments API provides visibility into how Check resolves tax liability adjustments on behalf of an employer. A Fulfillment is created whenever Check reconciles tax liabilities and determines the outcome — whether that results in a direct transaction with the employer, an agency refund reclaimed from a tax authority, a write-off, or some combination.

Fulfillments are generated when Check resolves tax liability adjustments on behalf of an employer. Today this includes period-end tax balancing (read more in the Help Center article here) and unremittable tax refunds (read more here). Over time, additional scenarios — such as tax corrections and void-related adjustments — will also produce Fulfillment objects.

In the balancing use-case, fulfillment objects become available after a balancing payroll is approved and fulfilled. Each fulfillment is associated with a company and, if the reconciliation identified adjustments that require a transaction, a payment. The associated payroll links back to the fulfillment via its fulfillment field.

For unremittable tax refunds, fulfillment objects become available when Check schedules a refund of taxes that could not be remitted to tax agencies. These fulfillments have type set to unremittable_tax_refund and are associated with the refund's company. If a refund transaction is required, a payment is also linked.

Webhooks

Check sends webhooks for fulfillment lifecycle events with the fulfillment topic:

EventDescription
createdA fulfillment was created
deletedA fulfillment was deleted