Skip to content
HeartBadge docs

Gift Code Lifecycle

Live

Designing a gift code flow end-to-end: issuance, distribution, redemption, and expiration.

A complete gift flow covers issuance (often bulk), distribution (email, print, QR), redemption, and edge cases like expiration and revocation. This guide walks through building each piece on top of the gift APIs.

This page is being written.

The structure is fixed. The prose is being drafted from the source material and reviewed by HeartChain Labs before publication. If you need this information urgently, email docs@heartbadge.com .

What this page will cover

  • Designing your gift product (single-use, open, restricted)
  • Bulk issuance patterns
  • Distribution: embedding codes in email, paper, apps
  • Redemption flow and error handling
  • Expiration and revocation policies
  • Reporting on redemption rates