Skip to main content

Gift Card Activity

What Gift Card Activity is in iPaaS.com: the event ledger behind a card's balance, why deriving balance from activities is safer, and its inline-write / read-only-endpoint behavior.

How iPaaS.com Thinks About Gift Card Activity

A Gift Card Activity is a single event in a gift card's history - an activity type (Issue, Redeem, Void, Reinstate, Adjust), a timestamp, an amount, and the location where it happened. Other systems call it Card History, an Activity Log, a Transaction Ledger, or a Balance Event.

Activities are the ledger behind a card's balance - the event-level source of truth for every balance change. When two systems each keep their own running balance, replaying activities (issuance, redemption, reload) is safer than overwriting a single total, because the balance can be derived from the events. The location on an activity is where that event occurred, which is the native home for "redemption location."

Written with the card, read on its own. Activities are created inline on the gift card (as part of the card's activity list); the dedicated activity endpoints are read-only, so you read history through them but don't write activities directly.

Related concepts: Gift Cards.

Did this answer your question?