Once a payout order is dispatched, you can track progress at the recipient level. This article explains where to find payout orders and what each status means.
Where to find payout orders
The dashboard lists all payout orders with the following columns: recipient email, amount, currency, status, campaign, and created-at timestamp. Use it to monitor delivery and redemption across every dispatch.
Recipient statuses
Pending — the recipient record is created but the Redeem email has not been sent yet.
Sent — the Redeem email has been delivered to the recipient's mail provider.
Viewed — the recipient opened the Redeem link (a
viewed_attimestamp is set).Partially Redeemed — the recipient redeemed some, but not all, of their balance.
Redeemed — the full amount has been redeemed. This is a terminal state.
Expired — the Redeem link expired before full redemption. Any remaining balance is automatically refunded to your company balance.
How a recipient moves through the statuses
Typical path: Pending → Sent → Viewed → Redeemed. A recipient who claims only part of their balance sits at Partially Redeemed until they return and finish, or until the link expires. Expired and Redeemed are end states.
Tracking via the API
The same data is available programmatically:
GET /api/payout-orders— list and track payout batches.GET /api/payouts— individual payouts and their statuses, filterable by status, campaign, and recipient.
List endpoints are paginated (page query parameter, default limit 10, max 20) and return current-page, page-items, total-count, and total-pages headers.
Good to know
Refunds on expiry are automatic. You don't need to reclaim expired balances manually — they return to the company balance.
Status reflects the recipient, not just the email. "Viewed" means the link was opened; it does not mean the gift card was claimed.
