Shopify 知识库 · 概念
礼品卡：发放、余额、有效期与结账使用
说明 Shopify 礼品卡的两种发放方式（礼品卡商品与后台创建）、面值上限、币种与跨币种兑换、有效期、结账使用限制，礼品卡页面模板与 Liquid、API 入口，以及它与店铺储值（store credit）的区别。
礼品卡是顾客预付、之后在同一家店铺用来抵付订单的余额凭证。Shopify 有两条发放路径：把礼品卡做成商品出售，或由商家在后台直接创建；顾客持 16 位兑换码在结账时使用。本文说明这套机制的对象、限制与入口，不解决礼品卡的税务与有效期法规问题，也不讨论把礼品卡当作促销工具的设计，后者见促销信息。
本库哪些内容依赖它
- 模板类型：
gift_card.liquid是已签发礼品卡的专用模板，只能是 Liquid； - 忠诚与奖励：官方把奖励类计划指向应用、折扣码、礼品卡与店铺储值；
- 促销信息与促销兑现：赠送礼品卡、礼品卡不计入门槛；
- 折扣：折扣码与礼品卡商品的关系；
- 销售计划：礼品卡付订阅只作用于首次付款；
- 退货与退款：退款可回到礼品卡。
本文是该平台机制的权威来源，其他文章只写各自页面语境下的用法。
核心对象与概念
| 对象 | 含义 | 备注 |
|---|---|---|
| 礼品卡商品 | 每个面额是商品的一个变体 | 面额须大于零，上限 10,000 美元或等值本币（概览页与商品页均写明）；顾客不能在店面输入自定义金额 |
| 后台创建的礼品卡 | 在后台指定初始值、顾客、内部备注、可选到期日 | 上限 2,000 美元或等值；更高额度需 Shopify Support 审核（概览页） |
| 币种设置 | 商店币种礼品卡可在任意币种下兑换；本地币种礼品卡须结账币种一致，除非启用跨币种兑换 | 创建后跨币种兑换偏好不可更改；本地币种礼品卡默认不发布到任何 catalog，需要 markets 与 catalog 配好对应币种价目表 |
| 兑换码 | 16 位随机码，不可自定义，兑换时不区分大小写 | 后台只能看到末四位，完整码仅顾客或收件人可见 |
| 礼品卡页面 | 已签发礼品卡的展示页 | 主题中的页面模板；托管在 checkout.shopify.com 域名下 |
| 店铺储值（store credit） | 与礼品卡不同的另一种余额 | 见下文对比 |
概览页写明：礼品卡被视为货币，故只有顾客或收件人能看到完整兑换码；礼品卡与兑换码的值不能从主题自定义；礼品卡只能在发放它的店铺兑换。
在哪里配置
- 入口：Products > Gift cards（商品页、创建页与管理页均以此为起点）。
- 添加或更新礼品卡商品：必填标题、描述、币种、跨币种兑换偏好与至少一个面额；礼品卡是数字商品，实体卡另通过 Shopify Hardware Store 在受支持国家购买，且与 POS 配合使用。
- 后台创建：填初始值、可选顾客与内部备注、可选 Set expiration date；保存后 Send gift card，有邮箱选 Send email，仅有手机选 Send SMS。
- 管理：余额不能在后台直接编辑，只会因兑换、退款或自定义集成而变化；可在详情页停用（永久，不可恢复），可 Edit expiry date，可给原顾客重发更新后的礼品卡；用礼品卡付款的订单退款可退回礼品卡，余额自动更新，已停用的卡不能退款，已过期的卡须先改到期日再退款。
- 设置：帮助页写明默认不过期；启用到期后默认五年，单位可选年、月、日；可启用 Apple Wallet 卡券（邮件中出现 Add to Apple Wallet 按钮）；礼品卡默认在订单付款后自动履约，可改为手动。摘要读取的路径为 Settings > Payments 的支付配置区与 Settings > General 的订单处理区，菜单名未逐字复核。
- 通知：Settings > Notifications > Customer notifications 编辑礼品卡通知；页面写明通知由 HTML、CSS 与 Liquid 组成。
与主题、Liquid 和 API 的连接
| 入口 | 官方页面所写 |
|---|---|
gift_card.liquid | 渲染顾客购买后签发的礼品卡页；不能是 JSON 模板，必须是 templates 目录下的 Liquid 文件；可不套用布局或用 layout 对象指定自定义布局；页面示例含 QR 码脚本，Apple Wallet 需先检查 gift_card.pass_url |
gift_card 对象 | 仅在该模板内可用；含 balance、initial_value、code、last_four_characters、currency、customer、enabled、expired、expires_on（永不过期为 null）、message、pass_url、properties、qr_identifier、recipient、send_on、template_suffix、url、product、variant；金额为币种最小单位 |
| 商品与购物车行 | product.gift_card? 与 line_item.gift_card 判断是否礼品卡 |
| Storefront API | Cart.appliedGiftCards；cartGiftCardCodesAdd 追加、cartGiftCardCodesUpdate 替换全部，码不区分大小写，每次请求最多 250 个 |
| Admin API | GiftCard 含 balance、initialValue、expiresOn、enabled、maskedCode、交易记录；读取需 read_gift_cards；giftCardCreate、giftCardUpdate、giftCardDeactivate（不可逆）、向顾客或收件人发送通知 |
限制、数值与易错点
核验于 2026-09-29，逐条标来源。
- 面值：商品出售最高 10,000 美元或等值，后台创建最高 2,000 美元或等值（概览页）；各币种的等值金额未核验。
- 套餐：概览页写明所有 Shopify 订阅套餐都可用（但 Agentic 套餐页列出“不能销售礼品卡”，官方未说明它是否属于“所有套餐”，见套餐）；已读页面未见地区限制，实体卡仅限受支持国家。使用前须同意 Shopify 的礼品卡服务条款。
- 兑换：可与折扣码同用；一单可用多张；余额不足时顾客须再选一种付款方式；礼品卡不能用来买礼品卡；用礼品卡付订阅只作用于首次付款；余额适用于含税费与运费的订单总额；线上结账与 POS（需 POS 渠道）均可兑换（兑换页）。
- 折扣礼品卡：不要用 Compare-at price 给礼品卡打折，应使用折扣码或自动折扣，也可用买 X 得 Y 赠送；针对指定集合的折扣不作用于集合内的礼品卡商品；折扣后售价与兑换价值不同（如 80 买 100 面值）（折扣页与概览页）。折扣写明礼品卡作为付款不计入最低购买金额。
- 第三方交易费：概览页写明 2025 年 5 月 12 日之后创建的店铺，对用礼品卡支付的金额收取第三方交易费，Shopify Plus 且使用 Shopify Payments 时免除；较早店铺的规则该页未写，未核验。
- 有效期与法规：设置页与创建页均提醒先确认所在国家的礼品卡规则；概览页提醒税务处理与有效期因地区而异，需咨询当地税务与法律人士。本文不给出任何地区的结论，需要合规确认。
- 自定义边界：兑换码与礼品卡价值不能从主题定制；帮助页的“自定义页面与通知”一页未写出文件名
gift_card.liquid，该文件名来自 shopify.dev 模板页，二者并列。
与店铺储值（store credit）的区别
| 维度 | 礼品卡 | 店铺储值 |
|---|---|---|
| 形态 | 兑换码，顾客或收件人持有 | 挂在客户资料上的余额 |
| 使用条件 | 输入码即可，无需登录 | 顾客登录账户或使用 Shop Pay 结账；需新版客户账户，旧版不支持 |
| 到期 | 店铺级设置，默认不过期，可启用默认周期 | 按次设置，无店铺级默认；按店铺时区当天结束计算；多笔储值先用最早到期的 |
| 发放 | 商品出售或后台创建 | Customers > 客户 > Store credit 区编辑 |
| 渠道 | 线上与 POS | 线上、POS 与 Shop；草稿订单与被编辑的订单不可用 |
| 订阅 | 仅首次付款 | 不适用于周期性订阅付款 |
储值页另有单个账户发放上限（摘要读取为低于 15,000 美元）、币种匹配显示等限制，属摘要级，未逐字复核。忠诚奖励类文章使用储值时，以忠诚与奖励已核验的表述为准，并链接到客户账户核对新旧账户差异。
验证一次
- 建一个含两个面额的礼品卡商品，加购、下单并付款，确认礼品卡自动履约、顾客收到通知邮件；
- 打开礼品卡页面，核对余额、末四位、到期日与 Apple Wallet 按钮，确认页面域名为
checkout.shopify.com； - 用礼品卡付一张小于余额的订单与一张大于余额的订单，核对余额变化与额外付款方式；
- 与折扣码同单使用，核对折扣与礼品卡的先后与合计；
- 对本地币种礼品卡，切换结账币种，确认不匹配时是否可用（取决于是否启用跨币种兑换）；
- 把用礼品卡付款的订单退款，确认余额回到礼品卡，再对已停用与已过期的卡各试一次；
- 全程使用测试店铺与测试数据，不要在真实顾客的卡上做停用测试。
待继续完善
- 礼品卡各币种上限的等值金额、较早店铺的交易费规则未核验；
- 设置页的确切菜单路径需在后台核对；
- 礼品卡与 Shopify Payments、POS 的组合行为与各地区法规未验证，需要合规确认；
- 店铺储值细则页只做摘要级读取。