Redeem Gift

Live

POST /gifts/redeem — redeem a gift code for a recipient.

Called when a member redeems a gift code. Validates the code, checks any restrictions, and either mints the badge or credits the reward to the recipient's wallet.

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 and redemption flow
Validation rules and error codes
Atomic semantics: no partial redemption
Anti-fraud protections
Webhook events on successful and failed redemption