跳转到主要内容
Subotiz 支持通过嵌入式表单(embedded 模式)完成结账流程。提供低代码支付集成方案,可便捷创建可定制的支付表单,助您快速完成支付流程。

场景演示

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

嵌入完整 Checkout 页面

嵌入完整页面演示图

嵌入部分组件元素

嵌入部分组件元素演示图

支付流程

  1. 当客户准备完成购买时,从您的客户端(client)向您的服务端(server)发起结账请求。您的服务端应使用 Subotiz API 创建一个 Checkout Session,并在创建 Session 时以参数形式传入 order_id(接入方订单 ID,业务唯一),以便后续关联交易单。
  2. Checkout Session 会提供一个 Session ID,您的客户端可使用 SDK 唤起 Subotiz 的支付表单并展示给客户。
  3. 客户会在 Subotiz 表单中输入支付信息并完成交易。
  4. 交易完成后,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 支持续订付款功能。用户完成首次支付后,系统将生成支付凭证,后续该用户产生的订阅费用可使用此支付凭证进行扣费,无需用户重新填写支付信息。

续订流程

  1. 用户完成首次支付后,保存支付成功事件(trades.succeeded)中的 payment_token 数据,用于发起续订扣费。
  2. 使用 Subotiz API 中的创建交易单(Trade)接口发起扣费。
  3. 主动查询交易单或等待异步通知以获取支付结果,并将支付结果通知顾客。