如何创建可用于Shopify结账与GraphQL的自定义手动折扣函数

一、排查折扣创建界面跳转失效问题 #

1. 检查扩展配置的入口链接 #

• 确认shopify.extension.toml中ui字段的url指向正确的折扣创建页面，配置示例：

  [[ui.extension_points]]
  target = "discounts.discount_application.create"
  url = "/discount-create" # 对应应用内的创建页面路由
  

• 确保应用已配置write_discounts和read_discounts的OAuth权限，缺失权限会导致无法加载折扣管理界面。

2. 验证扩展部署状态 #

• 运行shopify extension status查看扩展是否已关联目标店铺且状态为Active。
• 若状态异常，重新执行部署命令并指定店铺：shopify extension deploy --store=your-store.myshopify.com

二、实现适配cartDiscountCodesUpdate及结账页的自定义折扣 #

1. 调整Shopify Functions逻辑（cart_lines_discounts_generate_run.js） #

• 确保函数支持折扣码触发，返回符合Shopify规范的折扣结构：

  export function run(input) {
    const { cart, discountCode } = input;
    // 仅匹配指定折扣码时生效
    if (discountCode?.code !== "CUSTOM10OFF") return { discounts: [] };
  
    const discounts = cart.lines.map(line => ({
      message: "自定义商品10%折扣",
      targets: [{ line: { id: line.id } }],
      value: { percentage: { value: 10 } }
    }));
  
    return { discounts };
  }
  

• 在shopify.function.toml中配置触发条件，支持折扣码和结账场景：

  type = "cart_lines_discounts"
  triggers = [
    { type = "discount_code", code = "CUSTOM10OFF" },
    { type = "checkout" }
  ]
  

2. 关联折扣码与Functions #

• 通过GraphQL创建折扣码并绑定你的Function，$functionId可通过shopify extension list获取：

  mutation CreateDiscountCode($functionId: ID!) {
    discountCodeCreate(
      discountCode: {
        code: "CUSTOM10OFF",
        discountApplication: {
          functionId: $functionId
        }
      }
    ) {
      discountCode { id }
      userErrors { message field }
    }
  }
  

3. 适配React Native应用的GraphQL调用 #

• 在cartDiscountCodesUpdate请求中传入自定义折扣码，验证折扣应用：

  mutation CartDiscountCodesUpdate($cartId: ID!, $discountCodes: [String!]!) {
    cartDiscountCodesUpdate(cartId: $cartId, discountCodes: $discountCodes) {
      cart {
        id
        discountApplications {
          description
          value { ... on PercentageDiscountValue { percentage } }
        }
      }
      userErrors { message field }
    }
  }
  

• 调用时传入参数["CUSTOM10OFF"]，确认购物车折扣计算正确。

4. 测试结账页兼容性 #

• 在Shopify后台启用该折扣码，通过默认结账页测试：添加商品后输入折扣码，检查折扣是否正常显示并计算。
• 若结账页无折扣，检查函数权限配置，确保已授予read_cart和write_cart权限。

三、常见问题排查 #

• 折扣未生效时，查看Shopify Functions日志：后台「设置」→「应用和销售渠道」→「你的扩展」→「日志」，定位错误信息。
• 确认函数返回的折扣类型（百分比/固定金额）与商品类型兼容，部分数字商品可能不支持特定折扣类型。

内容的提问来源于stack exchange，提问作者phreq