文档CommercePayment Services

过度捕获

最近更新： 2026年10月23日

创建对象：

  • Intermediate
  • Admin
  • User

超额捕获允许具有PayPal超额捕获协议的合格商户在开订单发票时捕获超过原始授权金额的金额。 例如，最终金额可能会因基于重量的调整或授权与履行之间的物料成本更改而增加。

PayPal确定每个商户帐户的过度捕获限制。 在Payment Services中启用过度捕获不会建立协议或增加PayPal批准的限制。

NOTE
本主题介绍Payment Services扩展中的过度捕获。 对于Adobe Commerce as a Cloud Service，请参阅自定义捕获量以了解单独的可用性和启用要求。

先决条件

在启用过度捕获之前：

  • 过度捕获仅在Payment Services 2.17.0或更高版本中可用。
  • 过度捕获仅适用于美国企业。 PayPal的过度捕获要求(PSD2)也适用于向欧洲经济区(EEA)中的PayPal买家出售的美国商家。
  • 过度捕获不适用于替代支付方式(APM)。
  • 获取与PayPal的过度捕获协议，并通过您的PayPal客户经理确认为您的商户帐户批准的限制。
  • 将付款方法的​ Payment Action ​设置为Authorize。 超量捕获适用于稍后在开票期间捕获的授权订单，而不适用于通过Authorize and Capture自动捕获的订单。 查看将 Payment Services 设置为付款方式。

启用过度捕获

  1. 在​ 管理员 ​侧边栏上，转到​Stores > Settings>Configuration。
  2. 在左侧面板中，展开​ Sales ​并选择​Payment Methods。
  3. 使用商店范围选择器选择要配置的网站。
  4. 展开​ FEATURED ADOBE PAYMENT SOLUTION ​部分。
  5. 在​ Payment Services ​部分中，展开​ General Configuration ​部分。
  6. 将​ Over Capture Enabled ​设置为Yes。
  7. 单击​ Save Config ​保存更改。
  8. 导航到​System > Cache Management，然后单击​ Flush Cache ​以刷新所有无效缓存。

捕获授权付款

在管理员开具发票期间会发生过度捕获。 请求的捕获金额必须在PayPal为你的商家帐户批准的限制之内。 请参阅为标准开票工作流创建发票。

  1. 在​ 管理员 ​侧边栏上，转到​Sales > Orders。
  2. 打开具有尚未获取的授权付款的订单。
  3. 单击​Invoice。
  4. 在自定义捕获量字段中，输入要捕获的总量。 例如，如果授权金额为USD 100，而商定的最终费用为USD 110，请输入110，而不是10。 请求的金额必须在您的PayPal批准限制之内。
  5. 为通过付款提供商请求付款的发票选择联机捕获。
  6. 查看发票并单击​Submit Invoice。

使用发票API捕获

使用标准创建发票终结点：

POST /rest/<store_code>/V1/order/<orderId>/invoice

使用订单的存储代码和订单的内部ID。 使用授权的管理员或集成令牌进行身份验证并设置Content-Type: application/json。

以下示例有效负荷为已授权使用USD 100的订单请求包含在线捕获USD 110的完整发票，前提是商家的PayPal协议允许该金额：

{
  "capture": true,
  "notify": false,
  "arguments": {
    "extension_attributes": {
      "custom_capture_amount": 110
    }
  }
}

在此示例中：

  1. capture请求联机捕获。
  2. notify控制Commerce是否发送发票通知电子邮件。
  3. custom_capture_amount是要捕获的最终数量，而不是超过授权数量的增加。

对拒绝的捕获进行故障排除

如果PayPal拒绝过度捕获请求：

  • 确认用于付款的PayPal商家帐户存在过度捕获协议。
  • 检查请求的金额是否在批准的限制之内。 如果超过限额，请要求降低限额或联系您的PayPal客户经理讨论提高限额。
recommendation-more-help
commerce-help-payment-services