API 开发API 调用和支付流程

2b. 授权和捕获

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

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

支持授权和捕获支付流程的平台

1. 授权

Auth

如果授权成功，Afterpay 将返回一个由 Afterpay 生成的唯一订单ID。当您想要捕获资金时，将使用这个 orderID。

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

延迟捕获

Deferred Capture

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

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

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

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

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

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

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

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

订单下达和支付捕获

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

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

商户将无法捕获任何已自动作废的部分（或全部）订单金额。

更新配送快递