Skip to main content

Selecting Gift Cards for a Campaign

How to choose the right gift cards for a payout campaign — from the dashboard or the API catalog.

The gift cards you select for a campaign are exactly what recipients see in the redeem page catalog. Choosing the right mix — by country, currency, and recipient preference — is what makes a payout land cleanly. This article covers selecting brands in the dashboard and the catalog model behind it.

Selecting brands in the dashboard

During campaign creation, the Select brands step lets you choose from your available brand catalog. You can filter by country, filter by currency, or search by name. The brands and currencies you pick here are the options recipients choose from at redemption.

Brand selection is locked once a campaign is Active — you can edit text fields on an active campaign, but to change the brand mix, you'd create a new campaign (or edit while still in Draft).

How the catalog is structured

The catalog is the source of truth for what you can send. Two levels matter:

  • Brands carry stable slugs (for example amazon, adidas). Brand-level fields are for browsing only.

  • Product options carry the actual constraints — country availability, currency, denomination range, and any discount or fee. Always validate amount, country, and currency at the product level before committing.

What to check when choosing brands

  • Country and currency coverage. Make sure the brands you pick cover every recipient country and currency you plan to dispatch in. (See currency mix and cross-currency redemption for the details.)

  • Denomination range. Per-product min_face_value / max_face_value tells you whether a brand is a fixed denomination or supports a variable amount. Match this to the payout amounts you intend to send.

  • Discount vs fee. Per-product discount can be positive (a discount you receive) or negative (a fee you pay). Treat negative values explicitly as fees.

  • Stock. stock_count may be null when stock is dynamic. Don't assume availability — re-validate at order time.

Browsing the catalog via the API

The same catalog is available programmatically with GET /api/products — a paginated list of brands and their product options. Use it to build a brand picker in your own product or to automate campaign setup.

Good to know

  • Curate for choice, not clutter. Recipients pick one brand from the list you set; a focused, relevant mix redeems better than an exhaustive one.

  • Worldwide brands need currency alignment. If you include worldwide (WW) brands, confirm each recipient's currency is covered by the campaign's brand mix.

Related Articles
Did this answer your question?