Changelog — Giftronaut API

2026-Q3 — Ledger parity with the portal

Balance ledger now matches the portal. GET /api/v1/balance/ledger (and the giftronaut_get_ledger MCP tool) previously read only two transaction sources, so promotions, reward refunds, and branded/choice order movements were missing. It now returns the same rows as the Account Balance page: reward, transfer, funding, branded, and choice.
New response fields — each ledger row now carries source, status, statusLabel, and signedAmount alongside the existing fields. The coarse type field and amount are unchanged, so existing integrations keep working.
New signedAmount field — encodes direction: outflows (Balance Used, transfer sent) are negative, inflows are positive. Use it to sum a running balance. The existing amount field keeps its original value and meaning.
Pending and unapproved top-ups are now included with statusLabel of Pending / Unapproved. These have not been credited to your balance yet — filter them out if you only want settled movements.
Ordering and pagination changed. Rows are now ordered the same way as the portal, so page boundaries differ from before. Re-page from the first page rather than reusing cached offsets.
Sandbox limitation. The reward and funding sources have no sandbox tables, so sandbox credentials return only order-related rows plus the cash leg of transfer.

Balance API — inspect available and pending balance
Campaign API — full campaign lifecycle management
Email Template API — create and manage reusable delivery email templates
Tax/W-9 processing — automatic US W-9 collection applied to qualifying orders
Webhook delivery — real-time HTTP notifications with HMAC-SHA256 signing and retries