# Yolfi 结账会话接口 (https://talivia.com/zh-CN/docs/revenue-guides/yolfi/checkout-session)



继续之前，请完成 [Yolfi 连接配置](https://talivia.com/zh-CN/docs/revenue-guides/yolfi#%E8%BF%9E%E6%8E%A5-yolfi)。

只有后端创建结账会话时才使用本指南。如果在 Yolfi 控制台中创建了可重复使用的链接，请查看[付款链接指南](https://talivia.com/zh-CN/docs/revenue-guides/yolfi/payment-link-on-your-site)。

## 创建 Yolfi 结账会话 [#创建-yolfi-结账会话]

请将 Yolfi 接口密钥保存在后端。设置 `successUrl` 时，必须保留字面量占位符 `{CHECKOUT_SESSION_ID}`：

```javascript title="创建 Yolfi 结账会话"
const checkout = await fetch('https://app.yolfi.com/api/checkout-sessions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.YOLFI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    paylinkId: process.env.YOLFI_PAYLINK_ID,
    successUrl: 'https://your-site.com/thanks?session_id={CHECKOUT_SESSION_ID}',
  }),
}).then(response => response.json());

return Response.json({ url: checkout.data.url });
```

将客户送到 `checkout.data.url`。付款后，Talivia 会从返回页面读取 `session_id` 并自动匹配付款，无需 Talivia 元数据。

订阅的首次结账使用同一个 `successUrl`，之后的续费会自动关联到原始付款。

完整请求与响应结构请参阅 [Yolfi 结账会话](https://docs.yolfi.com/en/paylinks/checkout-sessions)。