ObligationIssued

An obligation is a debt the business owes a collaborator as a result of a conversion. When that record is created, Siren fires ObligationIssued to signal that a new payment commitment exists. This is the bridge between the conversion pipeline and the payout pipeline.

The event is identified as obligation_issued and lives in Siren\Obligations\Core\Events\ObligationIssued.

What does this event carry?

The event provides the Obligation model and an optional conversionId. The conversion ID links the obligation back to the conversion that caused it. It is optional because some obligation creation paths, like manual adjustments, may not originate from a conversion at all.

use Siren\Obligations\Core\Events\ObligationIssued;

public function handle(Event $event): void
{
    $obligation = $event->getObligation();
    $conversionId = $event->getConversionId();

    $collaboratorId = $obligation->getCollaboratorId();
    $value = $obligation->getValue();
}

What happens when it fires?

The primary downstream listener is BindObligationToConversion, which writes the obligation’s ID back to the conversion record. This closes the two-way link between the conversion and the obligation, so either record can locate the other.

Other listeners might use this event to update running totals, notify collaborators that a commission has been earned, or sync obligation data to external accounting systems.

Once the obligation is eventually settled through a payout, the system fires ObligationCompleted.

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