FulfillmentCreated

A fulfillment represents a single payout run that groups obligations together for disbursement. When Siren creates one of these batches, it fires FulfillmentCreated to notify the system that a new payout cycle has begun.

The event is identified as fulfillment_created and lives in Siren\Fulfillments\Core\Events\FulfillmentCreated.

What does this event carry?

The event provides the Fulfillment model, which contains the batch’s ID, status, and associated metadata.

use Siren\Fulfillments\Core\Events\FulfillmentCreated;

public function handle(Event $event): void
{
    $fulfillment = $event->getFulfillment();
    $status = $fulfillment->getStatus();
}

What happens next?

After the fulfillment is created, the system generates individual payout records for each collaborator who is owed money. Each of those records fires a PayoutCreated event. As the fulfillment moves through its lifecycle, status transitions fire FulfillmentStatusChanged.

Listeners might use FulfillmentCreated to log the start of a payout run, notify administrators, or prepare external payment gateway connections before the individual payouts begin processing.

See the Payment Events overview for how this event fits into the full payment pipeline.