Talivia 使用文档
Talivia 使用文档
首页数据看板
简介安装团队获取更新
Stripe
Yolfi
使用 Yolfi 付款链接归因收入Yolfi 结账会话接口测试与排查 Yolfi
Dodo Payments
LemonSqueezy
Polar
手动付款接口测试付款集成
集成
人工智能代理与模型上下文协议llms.txtllms-full.txt
收入Yolfi

Yolfi 结账会话接口

从后端创建托管的 Yolfi 结账。

查看 Markdown 原文
请先连接 Yolfi

继续之前,请完成 Yolfi 连接配置。

只有后端创建结账会话时才使用本指南。如果在 Yolfi 控制台中创建了可重复使用的链接,请查看付款链接指南。

创建 Yolfi 结账会话

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

创建 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 结账会话。

使用 Yolfi 付款链接归因收入

为 Yolfi 付款链接添加一个重定向参数。

测试与排查 Yolfi

检查 Yolfi 付款是否已记录并匹配到流量。