Fulfillment: Tasks & Retries

Fulfillment: Tasks & Retries

When an order is confirmed, the Fulfillment module creates one typed task per order item — a physical shipment, a software-access license, a digital download, a subscription activation, a service project, and so on — and dispatches each to the handler registered for that type.

Monitoring Tasks

Open Fulfillment → Tasks and filter by status: Pending, Processing, Fulfilled, Failed, Canceled, or Reversed. Click a task to see its handler, the related order, the full attempt history, and the last error message if it failed.

Retrying a Failed Task

From the task detail page, click Retry. The system checks the task hasn't already reached its maximum attempt count, marks it back to processing, logs a new attempt, and re-runs the handler. This is the normal way to recover a task that failed because of a transient issue (e.g., a courier API timeout).

Canceling a Task

Click Cancel on a task that is still in a cancelable status. Tasks that already reached a terminal status (fulfilled, failed with no retries left, or already canceled) cannot be cancelled.

Reverse Fulfillment

When a payment is refunded, Fulfillment automatically creates reversal tasks for every already-fulfilled item on that order — revoking a license, reversing a delivery, or crediting back usage — and dispatches each to its reverse handler. You do not need to do this manually.