> 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.

# 创建结账

**创建新的 Afterpay 订单需要哪些 API 调用？**

---

| **操作**                                                                                                                            | **端点**                       | **目的**                    |
| --------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ------------------------- |
| [获取配置](https://afterpay.docs.buildwithfern.com/afterpay-online-developer/api-reference/reference/configuration/get-configuration) | `/v2/platform/configuration` | 获取 Afterpay 订单限额（最小/最大值）。 |
| [创建结账](https://afterpay.docs.buildwithfern.com/afterpay-online-developer/api-reference/reference/checkouts/create-checkout-1)     | `/v2/checkouts`              | 提供订单详情并生成结账令牌。            |

在创建 Afterpay 结账之前，商户需要获取 Afterpay 启用的最小和最大订单金额。这是通过获取配置端点完成的。

## 1. 获取配置

[GET /v2/configuration](https://afterpay.docs.buildwithfern.com/afterpay-online-developer/api-reference/reference/configuration/get-configuration)

```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FFF',
      'primaryTextColor': '#000',
      'primaryBorderColor': '#000',
      'lineColor': '#000',
      'secondaryColor': '#fff',
      'tertiaryColor': '#fff',
      'noteBkgColor': '#fff',
      'noteBorderColor': '#000'
    }
  }
}%%
sequenceDiagram
    Merchant Website ->> Afterpay: GET/v2/configuration
    Afterpay -->> Merchant Website: Configuration
```

此调用应作为计划后台进程的一部分执行。我们建议每天调用一次此端点，并在服务器端存储 `minimumAmount` 和 `maximumAmount`。

商户应使用这些值来确定：

1. 在产品详情页面上显示正确的 [Afterpay 消息](/afterpay-online-developer/chinese/getting-started-with-afterpay-on-site-messaging)
2. 是否应将 Afterpay 作为可用的支付方式呈现。
   如果订单总金额小于最小金额或大于最大 Afterpay 金额，创建结账的请求将被拒绝。请与您的 Afterpay 联系人联系以更改您的最小或最大范围。

## 2. 创建结账

[POST /v2/checkouts](https://afterpay.docs.buildwithfern.com/afterpay-online-developer/api-reference/reference/checkouts/create-checkout-1)

```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FFF',
      'primaryTextColor': '#000',
      'primaryBorderColor': '#000',
      'lineColor': '#000',
      'secondaryColor': '#fff',
      'tertiaryColor': '#fff',
      'noteBkgColor': '#fff',
      'noteBorderColor': '#000'
    }
  }
}%%
sequenceDiagram
    Merchant Website ->> Afterpay: POST/v2/checkouts
    Afterpay -->> Merchant Website: Token
```

您将调用创建结账端点来向 Afterpay 提供以下信息：

1. 客户信息
2. 订单详情
3. 订单总额
4. 配送信息
5. 您希望在客户完成 Afterpay 结账流程时将其定向到的 URL

> **Afterpay 使用订单总额来计算分期付款计划并协助客户的预批准流程。**

Afterpay 响应一个用于标识此结账的令牌。
例如：`002.5lmerr3k945d00c7htvcrdff83q36kp10a247m212fjpa5ju`

该令牌与 [Afterpay.js JavaScript 库](/afterpay-online-developer/chinese/standard-checkout-overview) 一起使用，将客户引导至 Afterpay 结账流程。

**Afterpay 结账最终界面**
![Afterpay-Checkout-final-screen](/_fern-img/33eb96e650b36d1db9e6605b41327dbc14f06479ac08981bf2158771c607a39f.webp)

客户完成结账流程后，他们将被返回到创建结账请求中提供的商户网站 URL。如果使用[重定向方法](/afterpay-online-developer/chinese/standard-checkout-overview)，状态将附加到商户 URL。例如：

* **如果客户成功完成结账流程：** `www.merchant-example.com/confirm?&status=SUCCESS&orderToken=002.5lmerr3k945d00c7htvcrdff83q36kp10a247m212fjpa5ju`
* **如果客户关闭窗口：** `www.merchant-example.com/confirm?&status=CANCELLED&orderToken=002.5lmerr3k945d00c7htvcrdff83q36kp10a247m212fjpa5ju`

> **Info**
>
> 还提供了[弹出窗口方法](/afterpay-online-developer/chinese/standard-checkout-overview)，它使用 `postMessage` 来传达状态和令牌。

## 选择何时捕获付款

现在您已经获得了结账的成功预批准，您可以[直接捕获订单](/afterpay-online-developer/chinese/direct-capture)或创建[授权 API 调用](/afterpay-online-developer/chinese/auth-and-capture)以将资金保留，直到您准备好捕获为止。