Guides / Integration guides

Refund Option

Maximize your campaign ROI by enabling the Refund Option — receive a portion of unredeemed funds back to your account when gift cards expire, using a 30/60/90-day window.

What is the Refund Option?

The Refund Option is controlled by two fields. Set refundOption to true to shorten the gift card expiration period from the default 180 days, then use refundOptionDays to pick the window (30, 60, or 90 days). In return, a portion of the unredeemed face value is credited back to your account upon expiration. Choose the window that balances redemption time against recovered budget:

refundOption: false (default, or omit the field) — no refund, 180-day expiry.
refundOption: true, refundOptionDays: 30 — 30-day expiry, 50% of unredeemed face value refunded.
refundOption: true, refundOptionDays: 60 — 60-day expiry, 40% refunded.
refundOption: true, refundOptionDays: 90 — 90-day expiry, 30% refunded.

Default window: Sending refundOption: true on its own — with no refundOptionDays — defaults to a 30-day expiry with a 50% refund, matching the legacy behavior.

Example: With refundOption: true and refundOptionDays: 30, if a $100 gift card expires unredeemed, $50 is credited back to your account automatically.

Validation: refundOptionDays is only valid when refundOption is true, and must be 30, 60, or 90 — any other value returns HTTP 400 (REFUND_OPTION_DAYS_INVALID).

How it works

Setting	Expiration	Unredeemed refund
`refundOption: false` (default)	180 days	None
`refundOption: true` (no days)	30 days	50% of face value credited to account
`refundOption: true`, `refundOptionDays: 30`	30 days	50% of face value credited to account
`refundOption: true`, `refundOptionDays: 60`	60 days	40% of face value credited to account
`refundOption: true`, `refundOptionDays: 90`	90 days	30% of face value credited to account

Giftronaut returns the unredeemed funds to your account balance automatically upon expiration. No manual claim is required.

Where to use it

The refundOption field is available on the following APIs:

Create branded card order
Create choice card order
Create campaign
Update campaign — applies to future orders from that campaign

{
  "productId": "CHOICE-GLOBAL-USD",
  "recipients": [ ... ],
  "emailSetting": { ... },
  "refundOption": true,
  "refundOptionDays": 30
}

Best suited for

Consumer promotions and limited-time campaigns where redemption windows are naturally short
Campaigns where you want to reduce wastage and recover budget from recipients who don't redeem
High-volume sends where even a small unredeemed percentage represents significant value

Shorter expiration: Refund presets reduce the redemption window (30 / 60 / 90 days instead of 180). Make sure your campaign communication clearly conveys the expiration date so recipients don't miss out.