> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 手动付款捕获

> 安装 Aftersell Shopify Flow 模板，只需几次点击即可修复使用手动付款捕获时出现的部分付款购买后 upsell 订单。

如果你的商店使用手动付款捕获（Manual Payment Capture），一些接受了购买后 upsell 的订单可能会显示为**部分付款（Partially paid）**：原始付款已被捕获，但 upsell 付款仅被授权。自 2026 年 3 月 31 日前后起，这种情况最常见的原因是 Shopify 的一项自动化变更。本文将说明发生了什么变化，以及如何在保留手动付款捕获设置的同时，使用 Aftersell Shopify Flow 模板解决此问题。

<Note>
  你是否在使用 **NoFraud** 或 **Riskified** 等欺诈检测应用，且它在 upsell 添加之前就捕获了付款，或者发现客户从失败的 upsell 中免费获得了商品？请参阅[使用欺诈检测应用时的付款捕获](/zh/aftersell/fraud-detection-payment-capture)。
</Note>

<div id="confirm-your-payment-capture-settings">
  ## 确认你的付款捕获设置
</div>

本文仅适用于使用手动付款捕获的商店。你的商店可能已设置了自动付款捕获系统，但仍启用了 Shopify 的手动付款捕获设置。你可以在此确认商店的付款捕获设置：

**Shopify 后台 > Settings > Payments > Payment Capture Method**

<Frame>
  <img src="https://mintcdn.com/aftersell/1Y3gBpUfxv16VGSW/images/aftersell/payment-capture-shopify-payments-setting.gif?s=0c7250818cb992fbdeb725072ddcc754" alt="Shopify Payments 设置中显示付款捕获方式选项" width="1912" height="1080" data-path="images/aftersell/payment-capture-shopify-payments-setting.gif" />
</Frame>

如果你未使用手动付款捕获，本文其余内容不适用于你。有关其他原因，请参阅[部分付款订单](/zh/aftersell/partially_paid_orders)。

<div id="what-changed">
  ## 发生了什么变化
</div>

Shopify 在 **2026 年 3 月 31 日**前后更新了其内置自动化模板 **“Capture payment if order is not high fraud risk”**。此更新改变了 Shopify 在订单编辑时评估欺诈风险的方式，从而破坏了购买后 upsell 的自动付款捕获。

此前，当订单被编辑时（例如添加购买后 upsell 商品时），Shopify 会重新运行欺诈分析。这一风险等级变化会重新触发付款捕获模板 Flow，从而捕获 upsell 付款。Shopify 现在不再在订单编辑时重新运行欺诈分析，因此模板 Flow 不会重新触发，upsell 付款也不会被捕获。

此问题影响**使用或不使用**欺诈检测应用的商店。

<div id="symptoms">
  ## 症状
</div>

如果出现以下情况，你可能正遇到此问题：

* 你注意到购买后 upsell 的**部分付款**订单突然激增
* 只有客户接受了购买后 upsell 的订单显示为部分付款
* 原始订单的付款已被捕获，但 upsell 付款处于**已授权但未捕获**状态
* 在问题开始出现前后，你没有更改商店设置中的任何内容

<div id="install-the-aftersell-flow-template">
  ## 安装 Aftersell Flow 模板
</div>

Aftersell 发布了一个预构建的 Shopify Flow 模板，只需一键即可为你设置完整的工作流。我们建议使用该模板，而不是手动搭建 Flow。

<Steps>
  <Step title="打开 Shopify Flow">
    在 Shopify 后台中，前往 **Apps > Flow** 并打开 **Templates** 库。
  </Step>

  <Step title="找到 Aftersell 模板">
    搜索 **“Capture payment when a post-purchase upsell is accepted”**（位于 **Orders** 类别下）并选择它。
  </Step>

  <Step title="安装并开启工作流">
    点击 **Install workflow**，查看各个步骤，然后开启该工作流。无需进行其他配置。
  </Step>
</Steps>

<Info>
  你现有的用于捕获原始订单付款的 Shopify 自动化可以保持不变。这个新 Flow 会与其并行运行，且只处理购买后 upsell 的付款。
</Info>

<div id="how-the-template-works">
  ## 模板的工作原理
</div>

<Frame>
  <img src="https://mintcdn.com/aftersell/5tllGPhNI007DemO/images/aftersell/payment-capture-flow-template-retry.png?fit=max&auto=format&n=5tllGPhNI007DemO&q=85&s=f44e7a0520cbb78e127811e94f014f8a" alt="带有 Aftersell 优惠接受触发器、可捕获条件、60 秒等待、重试条件、捕获付款操作和 Fail workflow run 的 Shopify Flow 模板" width="1189" height="1045" data-path="images/aftersell/payment-capture-flow-template-retry.png" />
</Frame>

1. \*\*触发器：“Aftersell Post Purchase Offer Accepted”。\*\*当客户接受 Aftersell 购买后 upsell 优惠且商品成功添加到订单时，Flow 开始运行。
2. \*\*条件：“Order capturable is equal to true”。\*\*Flow 检查 Shopify 当前是否可以捕获该订单的付款。
   * **如果为 true**，Flow 会运行 **Capture payment**，捕获未结的 upsell 金额。
   * **如果为 false**，Flow 会进入下一步。
3. \*\*等待：60 秒。\*\*Shopify 有时需要片刻时间才能捕获 upsell 付款，因此 Flow 会等待一分钟后再重试。
4. \*\*条件：“Order capturable is equal to true”。\*\*Flow 进行第二次检查。
   * **如果为 true**，Flow 会运行 **Capture payment**。
   * **如果为 false**，Flow 会运行 **Fail workflow run**。由于 Shopify 仍然无法捕获付款，本次运行会在 Shopify Flow 中被标记为失败，供你查看。

<Tip>
  请在 Shopify Flow 运行历史中检查失败的运行。运行失败意味着 upsell 付款未被自动捕获，该订单可能需要人工审核。
</Tip>

<Warning>
  \*\*不要添加 presentment money 金额条件。\*\*部分商店遇到过 Shopify 错误地将 presentment money 金额返回为 0 的问题，即使当时存在未结余额。添加类似“presentment money amount is greater than 0”的条件可能导致 Flow 在有效订单上跳过付款捕获。这可能导致客户收到账单邮件，而不是自动完成付款捕获。请按原样使用该模板，它只检查订单是否可捕获。
</Warning>

<Accordion title="手动搭建 Flow">
  如果你无法使用该模板，请在 Shopify Flow 中按以下步骤创建新的工作流：

  1. 添加 **Aftersell Post Purchase Offer Accepted** 触发器。
  2. 添加一个 **Condition**：**Order capturable is equal to true**。
  3. 在 **True** 分支上，添加 **Capture payment** 操作。
  4. 在 **False** 分支上，添加一个设置为 **60 秒**的 **Wait** 操作。
  5. 等待之后，添加第二个 **Condition**：**Order capturable is equal to true**。
  6. 在第二个条件的 **True** 分支上，添加 **Capture payment** 操作。
  7. 在第二个条件的 **False** 分支上，添加 **Fail workflow run** 操作。
  8. 开启该工作流。
</Accordion>

<div id="after-setting-up-the-flow">
  ## 设置好 Flow 之后
</div>

* 在生产环境启用之前，先在开发或沙盒商店中**测试该 Flow**。
* 启用 Flow 后的几天内**监控你的订单**，确认付款按预期被捕获，且没有向客户发送账单邮件。
* \*\*检查你的履约工作流。\*\*如果你使用外部履约服务，请确保此付款捕获 Flow 不会在你准备就绪之前触发履约。更多详情请参阅我们的[履约文档](/zh/aftersell/fulfillment)。
* \*\*检查你的订单保留设置。\*\*如果曾出现订单在付款未完成的情况下发货的情况，请确认你的订单保留设置已配置为在付款完全捕获之前阻止履约。

<div id="frequently-asked-questions">
  ## 常见问题
</div>

<AccordionGroup>
  <Accordion title="Aftersell 参与付款捕获吗？">
    不参与。Aftersell 不参与付款授权或捕获。Aftersell 通过 Shopify 的购买后 API 通知 Shopify 将 upsell 商品添加到订单中。其余付款流程由 Shopify 处理。本文所述的 Shopify Flow 是确保付款被捕获的推荐方式。
  </Accordion>

  <Accordion title="我没有使用欺诈应用。为什么我的购买后 upsell 付款没有被捕获？">
    Shopify 在 2026 年 3 月 31 日前后更新了其内置的“Capture payment if order is not high fraud risk”自动化模板，在订单被编辑时不再重新运行欺诈分析。因此，upsell 付款不会被捕获。安装 [Aftersell Flow 模板](#install-the-aftersell-flow-template)即可解决此问题。
  </Accordion>

  <Accordion title="该 Flow 会捕获订单全额还是仅捕获 upsell 金额？">
    该 Flow 只捕获未结的 upsell 金额。它不会重新捕获或重复捕获原始订单付款。
  </Accordion>

  <Accordion title="如果 Flow 运行时订单不可捕获会怎样？">
    Aftersell 模板会先检查 **Order capturable**，如果订单可捕获，则立即捕获付款。

    如果不可捕获，模板会等待 **60 秒**，第二次检查 **Order capturable**，如果订单在此期间变为可捕获，则捕获付款。如果订单仍然不可捕获，本次运行会结束，并显示消息 **“Order did not become capturable in time”**。无论哪种情况，都不会过早捕获付款。

    只有单一条件（没有等待和重试）的手动搭建 Flow 会在第一次检查后停止，不会重试。
  </Accordion>

  <Accordion title="我已经有一个用于捕获付款的 Shopify 自动化。我需要更改它吗？">
    不需要。你现有的 Shopify 自动化（例如“Capture payment if order is not high fraud risk”）可以保持不变。新的 Shopify Flow 会与其并行运行，专门处理购买后 upsell 的付款缺口。
  </Accordion>

  <Accordion title="我的客户在接受购买后 upsell 后收到账单邮件。发生了什么？">
    如果 Shopify Flow 包含 presentment money 金额条件，就可能发生这种情况。即使存在未结余额，Shopify 有时也会将 presentment money 金额返回为 0。这种情况下，Flow 会跳过付款捕获，Shopify 转而向客户发送账单邮件。请从 Flow 中移除 presentment money 条件，只保留“Order capturable”检查。
  </Accordion>

  <Accordion title="在哪里可以进一步了解部分付款订单？">
    请参阅我们的[部分付款订单](/zh/aftersell/partially_paid_orders)文章，了解部分付款订单产生的原因及解决方法。
  </Accordion>
</AccordionGroup>