跳转到主要内容
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

创建商品

在 Subotiz 管理平台中创建商品和商品定价,将商品信息和价格信息保存在服务端中。创建 Checkout Session 时需依赖商品定价的 price_id 来动态获取商品信息。

创建商品

创建商品定价

2

提供支付成功页面

您的程序需要提供顾客支付成功的展示页面,并确保能够在公网中访问。顾客付款完成后,Subotiz 会将客户重定向到该页面。
3

提供 webhook 通知地址

创建一个事件接收地址,以接收您账户上发生的事件。当有事件发生时,Subotiz 会发送 HTTPS POST 请求将 Webhook 事件通知到该端点,请求体内容是 JSON 格式的事件对象。您可以通过关注事件来同步变更您系统的业务数据。
4

集成嵌入式表单

您的客户端可以使用 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:有商品数据时选择 checkout 模式

4. 初始化结账页面