API Reference
API Reference

概述

Subotiz 主要支持两种集成模式:结账模式和付款模式。

Checkout 模式

Checkout 是 Subotiz 为订阅制业务设计的端到端交易解决方案。其核心优势在于整合了产品管理、订阅生命周期管理、多渠道支付处理和全球化运营能力。此模式适用于需要完整交易闭环的场景(例如:AI 工具、SaaS 平台、Web3 应用)。

核心能力包括:

  • 产品与订阅管理:创建产品、配置灵活的定价(免费试用、分级定价、优惠券),并管理订阅周期(月/年)及周期中调整。

  • 智能结算体验:可定制的结算流程(标准/快捷/两步),移动端优化布局,以及内置的全球税务合规性。

  • 多支付方式:支持信用卡、借记卡、PayPal、Apple Pay、Google Pay 等,并通过智能路由提升支付成功率。

  • 全球化支持:自动切换 18 种以上语言(中文/英文/日文/西班牙文)和多币种支持。

集成方式:

  • 托管页面:Subotiz 提供托管结算页面。商户通过 API 创建 Checkout Session,然后将客户重定向到此托管页面完成支付,从而省去前端开发工作。

  • 嵌入式表单:使用我们的 SDK 将结算功能直接嵌入到您自己的网页中。支持通过无代码编辑器进行界面定制(样式、组件、流程),确保品牌一致性。

维度托管页面嵌入式表单
技术难度低(仅 API + Webhook;无需前端开发)中(SDK 集成;提供无代码编辑器)
定制化程度中(Logo/颜色;固定流程)高(完整 UI 样式、组件布局、交互流程)
品牌识别度高(完全嵌入商户页面)
开发周期1-3 天(主要关注 API)3-7 天(UI 定制 + 测试)
适用场景中小企业需要快速上线需要深度定制且具备前端资源的品牌

Payment 模式

Payment 是 Subotiz 的轻量级解决方案,专注于支付处理。核心能力涵盖收款、退款、对账和 Token 续订(无需重复收集支付信息,使用 token 直接付款)。不包含产品/订阅管理。此模式适用于拥有现有系统(例如 ERP/CRM)但仅需要支付处理的商户。

核心优势:

  • 多渠道支持:与 Checkout 共享支付网络(信用卡、Google/Apple Pay)。

  • 无缝嵌入:完全自定义 UI,无 Subotiz 品牌标识。

集成方式:

维度嵌入式表单 (Payment 模式)
技术难度中(SDK 集成 + 续订逻辑)
定制化程度高(完全由商户设计 UI;无 Subotiz 品牌标识)
核心优势Token 续订 + 多种支付提供商
开发周期3-5 天(SDK + 逻辑适配)
适用场景拥有现有订阅系统的企业

对比

维度CheckoutPayment
范围完整周期(产品 + 订阅 + 支付)仅支付(包括续订)
价值简化转化优化以提升订阅转化率与现有系统集成。更专注于支付效率和续订稳定性
订阅内置(方案、修改、自动续订)无(自行管理)
定制化程度无代码结算编辑器:支持定制结算流程和 UI 样式仅限于支付界面
全球化支持多语言/币种/税务合规性多语言/币种/税务合规性
集成方式托管页面 + 嵌入式表单仅嵌入式表单

场景匹配指南

Checkout 模式推荐

  • 业务类型:SaaS、AI 工具、Web3 应用、移动游戏

  • 需求:产品目录/订阅管理或结算优化

  • 技术资源:前端开发能力有限或偏好无代码方案

  • 全球化:多区域客户需要本地支付方式

Payment 模式推荐

  • 业务类型:拥有成熟订阅系统的企业

  • 需求:纯粹的支付处理能力

  • 技术资源:具备前端能力进行自定义 UI 设计

  • 品牌控制:不希望有第三方页面重定向

These developer docs retire on 2026-08-30. Visit the new docs: NEW DOCS本开发者文档将于 2026-08-30下线,请访问新版文档: 新文档