帮助
登录

为 Shop Cash 准备系统

在将 Shop Cash 用于发货、会计、对账或退货工作流之前，请确认每个接收订单、支付、交易款项、退款或退货数据的系统均能正确处理 Shop Cash。

Shop Cash 是一种付款方式，而非折扣、礼品卡或商店抵扣额。对于假定每个订单仅支持一种付款方式、每个订单仅对应一个交易款项行或授权值较短的系统，您可能需要先对其进行更新，然后再大规模处理 Shop Cash 订单。

本页内容

集成准备就绪情况清单

在第三方系统上启用 Shop Cash 工作流之前，请确认符合以下要求：

  • 您的 ERP、OMS、发货、会计和退货系统可以在一个订单中接受多种付款方式。
  • 在提供网关值的位置，shop_cash 被映射为付款方式。
  • 系统未将 Shop Cash 视为折扣、礼品卡或商店抵扣额。
  • 授权值存储为至少包含 1024 个字符的不透明可变长度字符串。如果可能，请使用无限制的文本字段。
  • 捕获、作废和退款由交易 ID 而非授权值进行标识。Admin API 捕获和作废操作使用 parentTransactionId，而退款操作使用 parentId。
  • 您的系统不会解析、解码、规范化、散列处理或截断 Shop Cash 授权值。
  • 您的系统可以处理分组的交易款项，即一个 shop_cash_credit 行可以代表多个订单。
  • 您的对账工作流不会假定一个订单等于一个交易款项行。
  • 您的对账工作流可以处理在不同交易款项中结算的 Shop Cash 部分以及卡或 Shop Pay 分期付款部分。
  • 您的退款工作流可以跨卡或 Shop Pay 分期付款和 Shop Cash 处理部分退款。
  • 退款应用可以对 Shop Cash 捕获交易进行退款，但不能对授权交易进行退款。
  • 如果您在 2026 年 1 月之前开展过 Shop Campaigns，您的财务工作流会将历史 shop_cash_campaign_billing_debit 及相关的宣传活动账单行与订单收入分开处理。从 2026 年 1 月起，宣传活动成本将改为记入您的 Shopify 账单。

测试选项和限制

Shop Cash 测试存在限制，因为 Shop Cash 依赖于 Shop 客户账户、Shop Cash 余额、Shopify Payments 和 Shop Cash 结算基础架构。

端到端验证企业级集成的最可靠方法是通过 Shop 下一个低金额的生产订单，然后对其进行退款。这会创建类似于生产环境的订单交易、捕获数据、交易款项活动、退款交易和退款扣款活动，这些活动将流经 Shopify 后台、Admin API 数据、交易款项导出和交易款项 API 数据。

开发商店有助于验证某些 API 字段形式和映射逻辑，但它们无法可靠地执行源自 Shop 的完整结账、客户余额和结算流程。测试模式和 Bogus 网关不会创建类似于生产环境的 Shop Cash 交易款项行，因为它们不使用实时的 Shopify Payments 结算流程。

您可以自行测试的内容

您通常可以通过从 Shop 发起的低金额生产订单来测试以下工作流：

  • 针对包含 Shop Cash 以及 Shop Pay 或 Shop Pay 分期付款等多种付款方式订单的订单摄取。
  • shop_cash 的 ERP 或 OMS 映射。
  • 完整 Shop Cash 授权值的存储。
  • 针对订单的全额和部分退款。
  • shop_cash_refund_debit 交易款项活动的摄取。
  • 针对 Shop Cash 抵扣额的交易款项对账。
  • 预购或发货时捕获行为（如果您的商店使用延迟捕获）。
  • 退货应用对包含多种付款方式的订单的处理。

在生产环境中进行测试时，请使用低金额订单，并遵循您商店的内部测试订单和退款程序。

可能需要 Shopify 支持团队协助的内容

如果您在以下任何场景中需要帮助，请联系 Shopify 支持团队：

  • 查看处于发布阶段的市场中的 Shop Cash 可用情况。
  • 调查失败的 Shop Cash 捕获或退款。
  • 调查在经历正常交易款项周期及一个额外的交易款项周期后，缺失 Shop Cash 交易款项交易的情况。
  • 查看已作废或过期的 Shop Cash 授权是否可以重新授权。
  • 规划复杂的 ERP、OMS、预购或发货工作流的上线事宜。

在扩大 Shop Cash 订单量规模之前，请完成以下检查：

  • 已针对 shop_cash 部署并验证 ERP 和 OMS 付款方式映射。
  • 已端到端摄取示例 Shop Cash 订单，包括授权和捕获交易。
  • 示例 Shop Cash 交易款项抵扣额已与一个或多个源订单对账。
  • 已处理示例 Shop Cash 退款，并且该退款已与退款扣款对账。
  • 支持分组的 Shop Cash 交易款项行，或已有手动对账流程。
  • 您的支持和财务团队均了解部分退款分配操作。
  • 预购、手动捕获和发货时捕获行为（如适用）已通过验证。
  • 退货应用可以识别并针对正确的 Shop Cash 捕获交易进行退款。
  • 支持团队和财务团队了解客户 Shop Cash 余额、Shop 优惠和 Shop Campaign 账单活动之间的区别。

有关 API 和订单数据要求，请参阅 Shop Cash 订单数据和第三方集成。有关交易款项要求，请参阅 Shop Cash 交易款项对账。