Redemption
Issue a redeemable instrument and redeem it later — under principal authority, so a redeemer may only draw what they own or were granted.
Redeem a value instrument
Redemption draws from a pool — a denominated instrument (a gift card, reward points) — resolved under principal authority. The principal (the portal-asserted identity) may only redeem what they own or were granted; the request body carries only what to redeem, never whose — a redeemer cannot draw a pool by naming one they do not own.
Redeem from an owned pool
POST /redeem
The owner draws their own pool. The pool and the amount are in the body; the principal is asserted by the perimeter and must own the pool, or the draw is denied.
Redeem a claim
POST /redeem/claim
Redeem a claim — where the buyer is not the redeemer (a gift or an award). The instrument was issued to a recipient; only that recipient (the asserted principal) can retrieve and redeem it. This is the gift/reward path: someone buys, someone else redeems, and only the intended redeemer can.
Retrieve a redemption
GET /redemption/{reference}
Read a redemption by reference — recipient-scoped: it returns only the intended redeemer's own code. It is not retrievable by anyone holding the reference; the asserted principal must be the redeemer, or it is not found.
Denomination
A redemption draws its instrument (points, a gift card) at its own rate against the same funding source a naira vend uses. The instrument is the denomination; the draw against the funding position is the same proven path.