场景演示
本页介绍如何使用支付模式,即仅调用 Subotiz 的支付引擎,自行构建前端界面与业务逻辑。 如果您需要完整的商品管理、定价与支付能力,请前往 嵌入式结账模式。嵌入完整 Checkout 页面

嵌入完整页面演示图
嵌入部分组件元素

嵌入部分组件元素演示图
支付流程
- 当客户准备完成购买时,从您的客户端(client)向您的服务端(server)发起结账请求。您的服务端应使用 Subotiz API 创建一个 Checkout Session,并在创建 Session 时以参数形式传入 order_id(接入方订单 ID,业务唯一),以便后续关联交易单。
- Checkout Session 会提供一个 Session ID,您的客户端可使用 SDK 唤起 Subotiz 的支付表单并展示给客户。
- 客户会在 Subotiz 表单中输入支付信息并完成交易。
- 交易完成后,Subotiz 会以 webhook 方式通知您的服务端,通知包含支付成功事件,该事件中包含创建 session 时传入的 order_id,借此可关联接入方订单和 Subotiz 的交易单。
接入步骤
1
提供 webhook 通知地址
创建一个事件接收地址,以接收您账户上发生的事件。当有事件发生时,Subotiz 会发送 HTTPS POST 请求将 Webhook 事件通知到该端点,请求体内容是 JSON 格式的事件对象。您可以通过关注事件来同步变更您系统的业务数据。
2
集成嵌入式表单
您的客户端可以使用 Subotiz SDK 集成 Subotiz Checkout。
1. 加载 Subotiz.js
2. 提供容器节点
3. 创建 Checkout Session
使用 Subotiz API 创建Checkout Session ,并将响应结果返回前端。embedded 模式创建 Checkout Session 示例:关键参数
order_id:为接入方订单 ID,用于后续关联业务数据integration_method:设置为embedded,表示使用嵌入式模式接入return_url: 客户在 Subotiz Checkout 页面支付成功之后跳转的页面mode:选择payment模式total_amount:本次结账的金额
4. 初始化结账页面
续订收费
Subotiz 支持续订付款功能。用户完成首次支付后,系统将生成支付凭证,后续该用户产生的订阅费用可使用此支付凭证进行扣费,无需用户重新填写支付信息。续订流程
- 用户完成首次支付后,保存支付成功事件(trades.succeeded)中的
payment_token数据,用于发起续订扣费。 - 使用 Subotiz API 中的创建交易单(Trade)接口发起扣费。
- 主动查询交易单或等待异步通知以获取支付结果,并将支付结果通知顾客。