PayoutPaid

PayoutPaid is the terminal event in Siren’s payment pipeline. It fires when a payout record is marked as disbursed, meaning the money has been sent (or at least recorded as sent) and the payout’s status reflects that. Everything upstream, from the original commerce event through conversion, obligation, fulfillment, and payout creation, has led to this point.

The event is identified as payout_paid and lives in Siren\Fulfillments\Core\Events\PayoutPaid.

What does this event carry?

The event provides the Payout model, which contains the collaborator ID, disbursement amount, and currency.

use Siren\Fulfillments\Core\Events\PayoutPaid;

public function handle(Event $event): void
{
    $payout = $event->getPayout();
    $collaboratorId = $payout->getCollaboratorId();
    $amount = $payout->getValue();
}

When would you use it?

This is the right event for anything that should happen after money changes hands. Listeners commonly use it to trigger payment gateway confirmations, send receipt emails to collaborators, or push completed payment records to external accounting systems.

Because this event represents the end of the payment flow, it is also a natural point for reconciliation logic that verifies the payout amount matches what was expected from the obligation.

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