payout.status_changed

Triggered when a non-terminal status change occurs on the underlying send. You may see one or more of these between payout.quote_created and payout.terminal_state. Treat occurred_at as authoritative for ordering.

Envelope

Carries the standard event envelope. Payout identifiers: payout_order_uuid, recipient_email, external_send_id (see Payout events → Identifiers).

Event-specific fields

None. data is omitted on this event. The status is one of the non-terminal payout status values (in_progress, processing).

Example

{
  "event": "payout.status_changed",
  "status": "processing",
  "occurred_at": "2026-05-25T10:01:32Z",
  "recipient_email": "[email protected]",
  "external_send_id": "123456",
  "payout_order_uuid": "11111111-2222-3333-4444-555555555555"
}

What to do on receipt

  • Advance your local state machine for this external_send_id, but never treat the payout as final.
  • Resolve out-of-order arrivals using occurred_at.
  • A non-terminal event may be superseded — once a payout.terminal_state is sent for this external_send_id, any pending payout.status_changed for it is dropped.