收入Yolfi
Yolfi 结账会话接口
从后端创建托管的 Yolfi 结账。
请先连接 Yolfi
继续之前,请完成 Yolfi 连接配置。
只有后端创建结账会话时才使用本指南。如果在 Yolfi 控制台中创建了可重复使用的链接,请查看付款链接指南。
创建 Yolfi 结账会话
请将 Yolfi 接口密钥保存在后端。设置 successUrl 时,必须保留字面量占位符 {CHECKOUT_SESSION_ID}:
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 结账会话。