Skip to content
HeartBadge docs

Issue Gift

Live

POST /gifts/issue — issue a gift code for a badge or reward credit.

Issues a gift code that redeems to a badge (under your collection) or a reward credit (MNEE). The code can be single-use or configured with a redemption window and recipient restrictions.

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

  • Request body: type, amount, restrictions, expiration
  • Code format and rendering
  • Single-recipient vs. open gift codes
  • Webhook events on issuance and redemption
  • Accounting: when the value is committed vs. when it's delivered