使用结账会话创建订阅订单。需要通过创建结账会话创建的 productType: "subscription" 会话。
POST /v1/actions/subscription-order/create-order
请求体
| 字段 | 类型 | 必需 | 说明 |
|---|
checkoutSessionId | string | 是 | 结账会话 ID（cs_ + UUID 格式） |
billingDetail | object | 是 | 用于税额计算的账单信息 |
buyerEmail | string | 否 | 消费者邮箱地址 |
buyerIp | string | 否 | 消费者 IP 地址（用于税额计算） |
successUrl | string | 否 | 覆盖成功后的重定向 URL |
账单信息
| 字段 | 类型 | 必需 | 说明 |
|---|
country | string | 是 | ISO 3166-1 alpha-2 国家代码 |
isBusiness | boolean | 是 | 是否为企业购买 |
state | string | 条件 | US、CA 必填 |
postcode | string | 否 | 邮政编码 |
businessName | string | 条件 | isBusiness: true 时必填 |
taxId | string | 条件 | 税务 ID（欧盟 B2B 免税必填） |
请求示例
const { checkoutUrl } = await client.orders.createSubscriptionOrder({
checkoutSessionId: "cs_550e8400-e29b-41d4-a716-446655440000",
billingDetail: {
country: "US",
isBusiness: false,
state: "CA",
postcode: "94105",
},
buyerEmail: "customer@example.com",
});
// Redirect consumer to checkoutUrl
成功响应 (200)
{
"data": {
"checkoutUrl": "https://waffo.ai/store/my-store/checkout/token"
}
}
响应字段
| 字段 | 类型 | 说明 |
|---|
checkoutUrl | string | 消费者完成支付的重定向 URL |
将消费者重定向到 checkoutUrl 以完成支付。结账页面处理支付收集、税额计算和 3D Secure 认证。会话锁定产品版本、定价和货币。
错误响应
| 状态码 | 说明 |
|---|
| 400 | 缺少必填字段/无效的账单信息 |
| 401 | 认证失败 |
| 404 | 结账会话未找到或已过期 |
| 500 | 内部服务器错误 |
