> This page is for Afterpay Online Developer, version Chinese.
> For other versions, use one of these documentation indexes:
> - Main (default): https://developers.afterpay.com/afterpay-online-developer/main/llms.txt
> - v1: https://developers.afterpay.com/afterpay-online-developer/v-1/llms.txt
> - Chinese: https://developers.afterpay.com/afterpay-online-developer/chinese/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.afterpay.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.afterpay.com/_mcp/server.

# 2b. 授权和捕获

**资金在下单时授权，在发货时捕获**

---

如果您预计能够履行订单，请使用 `token` 进行授权调用来授权支付。

> **支持授权和捕获支付流程的平台**
>
> * 直接 API（v2 API）
>
> * [Salesforce Commerce Cloud](https://afterpay.docs.buildwithfern.com/afterpay-online-developer/guides/platforms/adobe-commerce-magento/introduction)
>
> * [Adobe Commerce (Magento)](https://afterpay.docs.buildwithfern.com/afterpay-online-developer/guides/platforms/platforms-quickstart)

## 1. 授权

* [POST /v2/payments/auth](https://afterpay.docs.buildwithfern.com/afterpay-online-developer/api-reference/reference/payments/list-payments)

![Auth](/_fern-img/50a8cc4fc6a430ec45bfe99ead49dc35f7f5dbba06f9755d63ee21536fff741d.webp)

如果授权成功，Afterpay 将返回一个由 Afterpay 生成的唯一[订单ID](https://afterpay.docs.buildwithfern.com/afterpay-online-developer/api-reference/reference/payments/list-payments)。当您想要捕获资金时，将使用这个 `orderID`。

如果 Afterpay 拒绝了支付（例如，客户的支付工具详情输入错误），商户应在结账时向客户展示适当的信息。

## 延迟捕获

* [POST /v2/payments/orderId/capture](https://afterpay.docs.buildwithfern.com/afterpay-online-developer/api-reference/reference/payments/list-payments)

![Deferred Capture](/_fern-img/1efa8bb7c1bc641335ee3776962daba6b71d35f0b233224b4e12df185a42a1ef.webp)

针对授权捕获支付 - `POST /v2/payments/{id}/capture`
如果您能够履行订单，请使用带有 id 的捕获调用来完成支付。如果您只履行部分订单，您可以捕获部分支付。只要捕获总额不超过授权金额，就可以对一个授权执行多次捕获。如果请求中提供了唯一的 requestId（GUID），捕获调用是幂等的。

这个流程完成支付批准，启动客户的支付计划 - 所有这些作为一个组合操作。当商户捕获订单总额时，资金（**最高至订单金额**）将与商户结算。

延迟支付流程允许商户通过以下方式捕获最高至订单金额的支付：

* 通过授权进行多次部分捕获，或
* 通过授权进行单次捕获请求

以下是建议使用延迟支付流程来捕获支付的几个示例。

* **分批发货的多件商品订单的部分延迟捕获：** 在这种情况下，如果商户通常根据分批发货中的商品价值向客户收取部分金额。该价值包括商品价格和所有适用的费用、税收和/或折扣

* **单件商品或多件商品订单的单次延迟捕获：** 在这种情况下，如果商户通常在订单中的所有商品发货后向客户收取全部订单金额

* **单件商品或多件商品订单的单次即时捕获：** 在这种情况下，如果商户通常在订单成功下达时向客户收取全部订单金额。请参考即时支付流程部分

## 订单下达和支付捕获

* 商户调用授权（/v2/payments/auth）端点确认订单。
  * 支付状态（"APPROVED" 或 "DECLINED"）只有在授权完成后才能知道。
  * 如果 Afterpay 批准了支付，商户存储支付的 id 和 "AUTH\_APPROVED" 支付事件的 expires 时间戳，并向客户展示订单确认/收据页面。"AUTH\_APPROVED" 状态表示：
    * Afterpay 能够成功验证（和/或收取）与客户 Afterpay 账户关联的支付工具（信用卡或借记卡）。
    * 商户团队的授权用户现在可以在 Afterpay 门户上查看订单信息。

> **Info**
>
> 支付捕获窗口和过期时间
> 在生产环境中，所有支付捕获请求必须在订单下达日期起 13 天内完成。当 13 天窗口过期时，任何剩余的**可捕获金额将自动作废**，客户的分期付款将更新以反映新的（减少的）订单总额。
>
> 商户将无法捕获任何已自动作废的部分（或全部）订单金额。

## 更新配送快递

* [PUT /v2/payments/\{orderId}/courier](https://afterpay.docs.buildwithfern.com/afterpay-online-developer/api-reference/reference/payments/list-payments)
  当订单发生配送时，使用快递 API 调用向 Afterpay 发送每个配送的跟踪信息。