gift-cards

礼品卡

概述

礼品卡让客户可以购买店铺余额，作为礼物赠送或留给自己使用。礼品卡可在结账时用作一种付款方式：客户可以用礼品卡支付部分订单金额，再用信用卡支付剩余金额；未用完的余额会保留在卡上。所有主流电商平台都提供原生礼品卡功能；只有无头店面或有非常具体的会计需求时，才需要自定义实现。

何时使用此技能

• 将礼品卡添加为可购买的商品，让客户可以送给他人
• 将店铺余额用作退款方式，替代现金退款
• 为 B2B 客户构建批量企业礼品卡计划
• 允许客户在结账时使用礼品卡和信用卡组合付款
• 需要完整的余额历史记录，以便进行会计对账或提供客户支持

核心说明

步骤 1：确定商家的平台并选择合适的工具

平台	建议	备注
Shopify	使用 Shopify 内置的礼品卡（除 Basic 外，所有套餐均可用）	原生集成结账、余额跟踪和邮件发送，无需应用
WooCommerce	WooCommerce Gift Cards 插件（官方，约 $49/年）或 YITH WooCommerce Gift Cards（约 $80/年）	WooCommerce 核心功能不包含礼品卡；这些插件维护良好且广泛使用
BigCommerce	BigCommerce Gift Certificates（内置，所有套餐均可用）	原生支持，可在管理面板中创建、销售和兑换礼品券
Custom / Headless	使用基于账本的余额跟踪方式构建	请参阅下方的 Custom 部分

步骤 2：在平台上设置礼品卡

---

Shopify

Shopify 礼品卡适用于 Shopify、Advanced 和 Plus 套餐（不适用于 Basic）。礼品卡以商品形式发行，并在结账时使用 16 位代码兑换。

启用并创建礼品卡：

1. 在 Shopify 管理后台中，前往 Products → Gift cards
2. 点击 Add gift card product
3. 设置面额（例如 $25、$50、$100），每种面额对应一个商品变体
4. 为礼品卡商品添加标题、描述和图片
5. 点击 Save

向客户发放礼品卡：

• 通过销售发放：客户购买礼品卡时，Shopify 会自动生成唯一代码，并通过邮件发送给收礼人
• 手动发放：前往 Customers → 找到客户 → Gift cards 选项卡 → Issue gift card；设置金额和到期日期

设置到期日期：

1. 前往 Settings → Gift cards
2. 启用礼品卡到期设置，并设置默认有效期
3. 注意：某些司法管辖区禁止礼品卡设置有效期（启用前请查阅当地法律）

为 B2B 或营销批量创建礼品卡：

1. 前往 Products → Gift cards → Export，下载现有代码
2. 使用 Shopify Admin API（POST /admin/api/2024-04/gift_cards.json）以编程方式批量创建礼品卡
3. API 响应中包含代码，可通过邮件平台发送

将店铺余额用作退款： 退款时，Shopify 允许将退款退至礼品卡，而不是原付款方式：

1. 前往 Orders → 打开订单 → Refund
2. 在“Refund to”下，选择 Gift card 并指定金额
3. Shopify 会创建一张新的礼品卡，并通过邮件将代码发送给客户

---

WooCommerce

安装 WooCommerce Gift Cards 扩展（来自 WooCommerce.com）或 YITH WooCommerce Gift Cards。这两款都是功能最全面的选项。

使用 WooCommerce Gift Cards 设置：

1. 安装并启用插件
2. 前往 Products → Add New，将产品类型设为 Gift card
3. 在 Gift card data 下：
   • 设置交付类型：通过电子邮件交付（数字礼品卡）或提供印刷卡片
   • 设置可选金额，或允许自定义金额
   • 配置用于向收件人发送礼品卡代码的电子邮件模板
4. 发布产品

兑换： 插件会在结账页面添加一个“礼品卡”字段。客户输入代码后，余额会从订单总额中扣除。支持部分兑换——剩余余额会保留在礼品卡上。

以退款形式发放店铺余额：

1. 打开订单 → Refund
2. 插件会添加一个“退款至礼品卡”选项
3. 系统会生成新的礼品卡代码并通过电子邮件发送给客户

查询余额： WooCommerce Gift Cards 和 YITH 都提供可添加到页面的余额查询短代码：[woo_gift_card_balance_check]

---

BigCommerce

BigCommerce 将这类礼品卡称为“Gift Certificates”，并原生提供此功能。

创建和销售礼券：

1. 前往 Marketing → Gift Certificates → Create Gift Certificate
2. 填写：
   • To（收件人姓名和电子邮件地址）
   • From（发送人姓名和电子邮件地址）
   • Amount：固定金额
   • Expiry date（可选）
3. BigCommerce 会通过电子邮件将礼券代码发送给收件人

将礼券作为产品销售：

1. 前往 Products → Gift Certificates
2. 启用礼券产品页面
3. 客户可以直接在店铺中购买自定义金额或固定金额的礼券

兑换： 礼券代码会在结账时显示为付款选项。支持部分兑换——剩余余额会保存在礼券代码中。

---

自定义 / Headless

对于无头店铺，请实现基于账本的礼品卡系统。账本模式会将每笔借记和贷记记录为不可变的交易行——切勿直接更新余额列。

CREATE TABLE gift_cards (
  id           UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  code         VARCHAR(32) NOT NULL UNIQUE,
  initial_value_cents INTEGER NOT NULL,
  currency     VARCHAR(3) NOT NULL DEFAULT 'USD',
  issued_to    VARCHAR(255),
  expires_at   TIMESTAMPTZ,
  is_active    BOOLEAN NOT NULL DEFAULT true,
  created_at   TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

CREATE TABLE gift_card_ledger (
  id         UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  card_id    UUID NOT NULL REFERENCES gift_cards(id),
  amount_cents INTEGER NOT NULL,  -- positive = credit, negative = debit
  type       VARCHAR(16) NOT NULL CHECK (type IN ('issue', 'redeem', 'refund', 'void')),
  order_id   UUID,
  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

余额计算 — 始终从账本推导，而不是读取存储列：

async function getBalance(cardCode: string): Promise<number> {
  const card = await db.giftCards.findByCode(cardCode.toUpperCase());
  if (!card || !card.is_active) throw new Error('CARD_NOT_FOUND');
  if (card.expires_at && card.expires_at < new Date()) throw new Error('CARD_EXPIRED');

  const result = await db.raw(
    'SELECT COALESCE(SUM(amount_cents), 0) AS balance FROM gift_card_ledger WHERE card_id = ?',
    [card.id]
  );
  return Math.max(0, parseInt(result.rows[0].balance, 10));
}

使用行级锁进行部分兑换，以防止并发超额兑换：

async function redeemGiftCard(code: string, orderId: string, orderTotalCents: number) {
  return db.transaction(async tx => {
    // Lock the card row to prevent concurrent redemptions
    const card = await tx.raw(
      'SELECT * FROM gift_cards WHERE UPPER(code) = ? FOR UPDATE',
      [code.toUpperCase()]
    ).then(r => r.rows[0]);

    if (!card || !card.is_active) throw new Error('CARD_NOT_FOUND');

    const balance = await getBalance(code);
    const appliedCents = Math.min(balance, orderTotalCents);
    if (appliedCents === 0) throw new Error('ZERO_BALANCE');

    await tx.giftCardLedger.insert({
      card_id: card.id,
      amount_cents: -appliedCents,
      type: 'redeem',
      order_id: orderId,
    });

    return { appliedCents, remainingBalance: balance - appliedCents };
  });
}

最佳实践

• 使用仅追加的账本 — 切勿更新余额列；将每笔借记和贷记记录为交易行，以保留完整的审计跟踪（这是进行会计对账的必要条件）
• 生成不含易混淆字符的代码 — 从字符集中排除 0、O、1、I，避免客户从电子邮件中读取代码时产生混淆
• 切勿在 URL 或日志中暴露完整礼品卡代码 — 部分遮蔽（ABCD-xxxx-xxxx-MNOP）可安全用于显示；完整代码只能出现在发卡邮件中
• 在发卡时设置会计负债 — 礼品卡余额在兑换前属于递延收入负债；请确保会计集成能正确记录
• 设置到期日期前，先确认当地法规 — 美国许多州及其他司法管辖区会限制或禁止礼品卡设置有效期；启用前请核实
• 测试退款至礼品卡的流程 — 这是常见的客户服务场景；正式上线前，请确保新发放的礼品卡可以正常访问和兑换

常见问题

问题	解决方案
使用同一张卡同时结账两次，均成功	在数据库事务中读取余额前使用行级锁（SELECT ... FOR UPDATE）（自定义构建）；平台会原生处理此问题
分拆付款时因舍入导致余额为负	使用 Math.min(balance, orderTotal)——应用金额不得超过当前余额
退款后余额重新计入礼品卡，客户却找不到卡	退款至礼品卡后，如果该卡之前已耗尽并停用，请确保重新激活
礼品卡代码出现在服务器访问日志中	切勿将代码作为 URL 路径参数；请使用 POST 请求体或经过哈希处理的查找令牌
礼品卡已购买，但代码未送达	平台原生礼品卡会自动发送；对于自定义实现，请使用带有送达跟踪功能的事务性电子邮件，并在客户服务面板中提供重新发送选项

相关技能

• @coupon-management
• @loyalty-points-system
• @stripe-integration
• @returns-management
• @checkout-flow-optimization