recipient.partially

Triggered when the recipient redeemed part of their entitlement and a balance remains.

Body

The GIFQ envelope plus the wallet balance. subject_type is "recipient" and status is "partially_redeemed".

📘
Fires once, not once per redemption
The event marks the transition, so re-entering the same status does not re-emit. A recipient redeeming three gift cards in a row while balance remains produces one recipient.partially_redeemed, not three.
For per-card granularity use payout.fulfilled, which fires every time.

Example

£25 of £75 spent:

{
  "event": "recipient.partially_redeemed",
  "payout_order_uuid": "11111111-2222-3333-4444-555555555555",
  "recipient_email": "[email protected]",
  "recipient_uuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "recipient_name": "Alice Doe",
  "subject_type": "recipient",
  "status": "partially_redeemed",
  "updated_at": "2026-05-21T10:05:00Z",
  "payout_type": "gift_cards",
  "initial_amount": 75.0,
  "remaining_amount": 50.0,
  "currency": "GBP",
  "sent_at": "2026-05-20T09:00:00Z",
  "viewed_at": "2026-05-21T10:00:00Z",
  "expires_at": "2026-08-20T09:00:00Z"
}

What to do on receipt

Update the balance you display for this recipient. remaining_amount is authoritative as of updated_at.
This is not terminal. More redemptions may follow, ending at recipient.redeemed or recipient.expired.
Because this fires only on the first partial redemption, do not use it to count redemptions. Count payout.fulfilled events instead.
Do not reconcile remaining_amount against gift-card amount values by subtraction. FX means card denominations and wallet balance can be in different currencies.