故障排除¶
使用目录跳转到您的问题，或搜索关键词。
礼品卡邮件问题¶
收件人没有收到礼品卡邮件¶
请按以下顺序检查：
-
垃圾邮件/广告邮件文件夹 — 请收件人检查，包括“促销”和“更新”标签页。礼品卡邮件偶尔会触发垃圾邮件过滤器。
-
邮箱地址拼写错误 — 在 Gift cards sending queue 中找到该卡（参见故障排除：礼品卡丢失），检查地址。一个字符错误，邮件就会发到别处。Gift Card Hero 无法检测地址是否有误，因此拼错的地址仍会显示 Sent。
-
队列状态 — 队列会显示 Scheduled（等待发送日期）、Sending（发送中）、Sent（已发送）或 Failed（发送失败）。Failed 表示 Gift Card Hero 经过多次尝试后已放弃发送。点击邮箱地址修正后保存，即可重新发送该卡。
-
定时发送 — 如果买家选择了未来的发送日期，状态会显示为 Scheduled，在该日期之前不会发送任何邮件。
-
发件域名 — 如果您使用自己的域名发件，请检查其 SPF 和 DKIM 记录。记录配置有误可能导致邮件进入垃圾箱或被丢弃。如果提醒或兑换通知通过您自己的邮件服务器发送，请在 Settings → Integrations 中检查其连接。
-
重新发送 — 在 Shopify 后台（Products → Gift cards）打开该礼品卡，使用 Gift Card Management 模块中的 Resend Gift Card。您可以发送给客户、收件人、店铺管理员或您输入的任意地址。参见礼品卡后台模块。
礼品卡邮件显示异常（样式问题）¶
- 邮件客户端通常默认屏蔽外部图片。如果只是图片不显示，收件人可以选择显示图片。
- 在 Settings → Email template 中重新生成模板，并检查打开的预览。如果预览正常，但在 Gmail 或 Outlook 中显示异常，问题出在邮件客户端。自定义 HTML 请保持简单，避免使用 CSS 背景图片，改用
<img>标签。 - 如果您已将模板粘贴到 Shopify 的礼品卡通知中（Settings → Notifications → Customer notifications → Gift card created），请用新生成的模板替换原内容。参见电子邮件模板。
邮件中显示原始代码，例如 {{ gift_card.code }}¶
Shopify 通知编辑器中的模板有语法错误，因此 Shopify 不会替换占位符，而是直接显示出来。常见原因是缺少 }} 或 %}，或粘贴时文本被截断。请在 Settings → Email template 中重新生成模板，复制后替换 Shopify 中的整个通知模板。
礼品卡丢失¶
如果客户说没有收到礼品卡，请按照故障排除：礼品卡丢失中的步骤操作。简而言之：
- 在 Shopify admin → Products → Gift cards 中确认该卡存在。
- 在 Gift cards sending queue 中查看其状态（首页 → Recent gift card queue → View full report）。
- 修正地址并保存，或在 Gift Card Management 模块中重新发送。
- 如果无法重新发送，请使用 Issue e-Gift card 补发一张新卡。
余额查询组件¶
组件没有出现在我的店面上¶
-
应用嵌入已关闭 — 在首页查看 App Blocks Status。如果您的正式主题显示 Disabled，请点击 Activate app embed，在主题编辑器中开启 Gift Card Hero，然后点击 Save。参见安装与设置。
-
组件已关闭 — 在左侧导航中打开 Balance widget。如果页面显示 Gift card balance widget is Disabled，请点击 Enable。（部分店铺看到的页面较简略，没有这个开关；此时组件仅由应用嵌入控制。）
-
位置不对 — 组件位于您的余额查询页面（
https://[your-store].myshopify.com/a/gifthero/balance），或您添加了<div class="sc-hero-checker-container"></div>的任意页面。将该代码添加到页面时，请使用编辑器的 HTML 模式（<>按钮），否则标签会被转义。参见余额查询组件。 -
缓存 — 强制刷新店面（Windows 按 Ctrl+Shift+R，Mac 按 Cmd+Shift+R）。
-
旧版主题 — 对于早于 Online Store 2.0 的主题，Gift Card Hero 会显示 We support only manual install for Shopify theme 1.0。点击 Contact support，我们会协助您手动安装。
余额查询提示找不到我的卡¶
余额查询只按完整代码查找。输入末尾四位字符或部分代码都无法查到结果。请让客户输入邮件中的完整代码。
组件显示的余额或状态有误¶
如果客户刚刚用完礼品卡，请刷新页面重新查询。已过期的卡会显示 Expired on 加日期，而不是“Active”。如果余额始终相差固定金额，请联系支持团队。
礼品卡代码问题¶
结账时提示“Invalid gift card code”¶
-
输入错误 — 代码不区分大小写，但每个字符都必须正确。注意区分数字
0（零）和字母O（欧），以及数字1（一）和字母I（艾）。 -
卡已停用 — 礼品卡可能已被停用。请在 Shopify admin → Products → Gift cards 中查看其状态。
-
卡已过期 — 请检查卡上的到期日期。过期的代码无法使用。
-
卡来自其他店铺 — 来自其他 Shopify 店铺、且不在您的多店铺网络中的卡，无法在您的结账中使用。
-
余额为零 — 已完全用完的卡没有可用余额。
-
货币 — 以其他货币发行的卡可能无法在您的店铺中使用。请在 E-Gift cards 标签页中检查 Cross-currency redemption。参见常见问题。
礼品卡在 POS 上被拒绝，但在线上可以使用¶
请在 POS tools → Shopify POS 中检查 POS 设置。如果开启了 Allow only redeeming gift cards in POS，员工只能用礼品卡付款，不能为其充值。另外，请按上文所述确认该卡未过期，且不是来自其他店铺。
POS 问题¶
Shopify POS 中缺少 Gift Card Hero 图块¶
该图块不会自动添加。在 Shopify POS 应用中：
- 点击 Add tile。
- 进入 Apps。
- 选择 Gift Card Hero。
- 点击 POS UI Extension。（App link 选项仍然存在，但已弃用。）
- 点击 Done。
Gift Card Hero 的 POS tools → Shopify POS 页面中也有相同的步骤。如果列表中没有该应用，请将 Shopify POS 应用更新至最新版本；如果使用 iPad，请强制关闭后重新打开。参见POS 集成。
POS 中无法充值或登记¶
在 POS tools → Shopify POS 中，检查 Disable balance reload functionality in Shopify POS app 和 Disable gift card registration in Shopify POS app。如果其中任一项已开启，员工将无法看到对应操作。
POS 图块显示“Failed to load”错误¶
这通常表示 POS 设备无法连接到 Gift Card Hero。请检查：
- 设备是否已连接互联网？
- 防火墙或内容过滤器是否阻止了外发连接？
- 从 Wi-Fi 切换到蜂窝网络（或反过来）后是否可以正常使用？
如果使用第三方 POS，请参见第三方 POS 上的礼品卡（PWA）。
批量操作¶
批量任务似乎卡住了¶
大型任务在后台运行，耗时长短取决于 Shopify 的速率限制。
- 从 Bulk actions 打开该任务，并在结果页面勾选 Autorefresh import jobs。
- 每一行都有状态：Pending 和 In progress 表示仍在处理，Retrying 表示遇到临时错误，Gift Card Hero 会再次尝试，Success 表示已完成，Failed 表示 Gift Card Hero 已放弃。点击 Failed 可查看错误信息。
- 运行中的任务无法暂停或取消。如果长时间没有进展，请附上任务链接联系支持团队。
批量发送中的行显示“Failed”¶
点击该行的 Failed 标记查看错误。对于 Mass send，Gift Card Hero 会在开始前检查地址，并告诉您哪些地址无效。对于 CSV 文件，常见原因是邮箱列中有多余空格或隐藏字符，这通常是 Excel 造成的。请用文本编辑器打开文件，修正后只重新上传失败的行。使用 Download results (csv) 可下载完整结果列表。
批量发送已完成，但部分收件人说没有收到邮件¶
- 查看结果。标记为 Success 的行已发送；请提醒这些收件人检查垃圾邮件。
- 企业邮件服务器通常会过滤来自新发件人的批量邮件。
- 如果您同时发送大量邮件，请确保发件域名已正确设置 SPF 和 DKIM 记录。
分析¶
我的仪表板所有指标都显示 $0¶
- 权限 — 分析功能需要访问您全部的订单历史。如果看到 Additional permissions required，请点击 Give the app additional scope，并在 Shopify 中批准。
- 同步 — 分析数据基于已同步的数据生成。在 Analytics 页面点击 Sync Data，然后选择 Sync for period 或 Sync for all time。横幅会显示进度。如果同步停滞，可以点击 Cancel sync 后重试。
- 日期范围 — 检查页面顶部的日期范围。
销售提升显示为 0 或很低¶
销售提升是指客户在礼品卡面值之外多花的金额。如果每张卡都支付了整个订单，就没有额外金额可以计算。对于低价订单或高面值礼品卡，这种情况属于正常现象。
礼品卡分析不包括我的忠诚度店铺余额¶
忠诚度店铺余额会单独显示在分析页面的 Loyalty & promotions 标签页中，而不计入礼品卡总额。参见忠诚度分析。
联系支持团队¶
如果以上方法都无法解决您的问题，请点击首页上的 Get help，或点击任意页面底部的 Contact us，并提供以下信息：
- 您的店铺域名（
.myshopify.com） - 您预期的结果与实际发生情况的描述
- 礼品卡的末尾四位字符，或批量任务的链接（如适用）
- 错误信息的截图
通常会在 1 个工作日内回复。