Styxis
Company
Knowledge

Shopify local-currency gift cards: testing issuance settings against redemption strategy

Before comparing amounts in a multi-currency experiment, verify the issuance-currency and redemption-policy combination fixed at creation.

Shopify local-currency gift cards: testing issuance settings against redemption strategy

A gift card's conversion strategy is the result of its creation-time currency policy, not an isolated display code. Interpreting it requires both whether the issuance currency is fixed and whether cross-currency use is permitted. Preserve immutable creation settings separately from later revisions to reference tables. [1, 2, 3]

What the primary source establishes

Shopify announced gift-card support with issuance currency and cross-currency redemption settings in API 2026-07. Those settings cannot be changed after creation, and their combinations determine NONE, MARKET_FX, or SPOT_FX strategy. [1]

The handover decision

Test the issuance-currency and cross-currency combinations before creating the product. Compare the returned strategy with the approved table. Retain issuance_currency_present, cross_currency_redeemable, and returned_strategy so a later UI label cannot obscure an immutable creation choice. [1, 3]

A reference defined before the output

The illustrative product has a fixed issuance currency and allows cross-currency redemption. The announcement's combination requires SPOT_FX. SPOT_FX is normal; MARKET_FX is the counterexample for this particular configuration. A product without a fixed issuance currency has a different expectation. [1, 3]

The scoped Truthound check

Truthound Core 3.3.2 can compare a normalized configuration-combination key and returned_strategy against an approved pair table using ColumnPairInSetValidator. It does not calculate exchange rates or converted amounts. Preserve the product's creation record rather than retroactively rewriting immutable settings through a revised table. [1, 2, 3]

Limits and alternative choices

Matching a strategy code does not establish exchange-rate, fee, or settlement accuracy, and creation settings cannot be arbitrarily edited afterward. If different policies are required, decide product settings and supported selling markets separately before creation. Without a fixed issuance currency, the expected strategy for cross-currency redemption changes. [1, 3]

Application conditions

Prepare the creation-time currency-policy combination and returned strategy for the same gift-card product.

Alternatives

If different policies are required, decide product settings and supported selling markets separately before creation.

Limitations

  • Matching a strategy code does not establish exchange-rate, fee, or settlement accuracy, and creation settings cannot be arbitrarily edited afterward.

Evidence

Event checked
Subject checked
Modified