企业级聚合支付
基础设施

整合支付宝、微信支付、抖音支付,一个接口完成下单、回调、退款与对账;支持 SaaS 自有通道,通道不可用时按策略自动切换。

交易总览 · 今日 示意

示意数据:一个示例商户在控制台看到的交易金额、交易笔数、支付成功率与各支付方式占比,不是平台的真实交易数据。

交易金额
12,860元
+14.8% 环比
交易笔数
126笔
+6.8% 环比
支付成功率
92.4%
+0.6% 环比
  • 支付宝 ¥5,916 46.0%
  • 微信支付 ¥4,887 38.0%
  • 抖音支付 ¥2,057 16.0%
01 合作模式

两种接入模式,按需组合通道

资金怎么走由接入模式决定。每种支付产品可以配置多个通道,平台按路由策略为每笔订单选择通道。

01 / 自有通道

SaaS 自有通道

接入你自己的支付通道,由平台负责下单、回调通知与订单管理,按套餐或按笔计费。

  • 资金由你的通道直接结算,不经过平台
  • 可与平台通道组合:优先使用、兜底使用或独占
  • 交易投诉同步到控制台,在时限内回复

适合 已有支付通道、需要统一下单和对账的商户

02 / 服务商

服务商进件 暂未开放

通过平台在微信支付、支付宝开通特约商户,付款直接进入你自己的商户号。

  • 资金不经平台账户,由渠道直接结算给商户
  • 平台负责下单、支付通知与对账
  • 与 SaaS 自有通道共用同一套接口

适合 希望资金直达自己商户号的商户

03 / 路由

通道路由

同一种支付产品可以配置多个通道,平台按路由策略为每笔订单选择通道,通道不可用时自动切换。

  • 按优先级:按顺序使用,前一个通道不可用时自动切换到下一个
  • 随机轮询:按权重随机分配,所选通道不可用时换用其他通道
  • 指定通道:固定使用一个通道,不自动切换

适用 自有通道与平台通道

02 接入流程

四步完成接入上线

全程在控制台线上办理。概览页的「首笔收款路径」会随进度自动打勾,不用对着文档逐项核对。

  1. Step 01

    注册与实名认证

    填写邮箱与登录密码注册,注册后即可登录控制台。实名认证在线完成:个人刷脸核验;个体工商户和企业核验营业执照登记信息后,由经营者或法定代表人刷脸,认证通过后才能收款。

    办理位置 控制台 · 实名认证

  2. Step 02

    配置密钥

    保存商户公钥、生成回调密钥,下载平台公钥用于验签;可以按需设置接口 IP 白名单。

    办理位置 控制台 · 密钥管理

  3. Step 03

    测试支付与联调

    按接入文档对接下单与通知,发起小额测试支付(付款后可原路退款),再发送测试通知,确认验签与解密代码正确。

    办理位置 控制台 · 测试工具

  4. Step 04

    首笔正式收款

    下单、引导付款、接收通知、查单兜底、每日对账跑通后即可上线,收到首笔正式收款后概览显示「已上线」。

    办理位置 控制台 · 概览

03 产品能力

收款、退款与对账

平台当前开放 9 种支付产品,随后台配置同步更新。不指定产品时只返回收银台地址,由付款人在收银台按所在环境选择;也可以指定产品,直接拿到二维码、跳转链接或调起参数。

  • 支付宝扫码

    alipay_qr

    当面付预下单,生成二维码供付款人用支付宝扫码;在手机浏览器中可直接唤起支付宝

    适用环境: 电脑浏览器 手机浏览器 支付宝内
  • 支付宝手机网站

    alipay_wap

    手机浏览器跳转支付宝手机收银台,可唤起支付宝 App 付款

    适用环境: 手机浏览器 支付宝内
  • 支付宝电脑网站

    alipay_page

    电脑浏览器跳转支付宝网页收银台,可扫码或登录账号付款

    适用环境: 电脑浏览器
04 开发者

统一接口,一次对接

接口地址 https://pay.siyun223.com/api/v1。不指定支付产品时,收银台按付款人所在环境展示你可用的支付方式,平台新增支付产品后业务代码不用改。

统一接口
下单、查单、关单、退款、退款查询与对账,一套接口覆盖已开通的全部支付产品。
联调工具
控制台提供小额测试支付与测试通知;每个应答带请求 ID,在「请求日志」里能查到每一次接口调用。
异步通知
支付成功后向 notify_url 推送签名通知;推送失败按 15 秒、30 秒、3 分钟……的间隔自动重试,共 10 次,也可以在控制台手动重发。
签名验签
请求用商户私钥做 SHA256withRSA 签名,应答与通知由平台私钥签名,通知业务数据另用回调密钥做 AES-256-GCM 加密。

PHP SDK 单文件、无第三方依赖;Java、Python、Node.js、Go 示例代码包含签名、验签与解密。

POST/api/v1/orders下单示例
{
  "out_trade_no": "M202610280001",
  "amount": 12800,
  "subject": "年度会员",
  "notify_url": "https://example.com/pay/notify"
}
示例数据,金额单位为分;应答由平台私钥签名。查看下单接口的完整字段
05 适用场景

覆盖主流付款场景

按付款人所在的环境匹配支付产品,线上网站、微信内与线下门店用同一套接口和控制台管理。

  • 电脑网站

    电脑浏览器

    付款人在电脑上下单,收银台显示扫码付款或跳转支付宝网页收银台,付款完成后跳回你的页面。

    支付宝扫码 支付宝电脑网站 微信扫码 抖音扫码
  • 手机网站与 H5

    手机浏览器

    在手机浏览器中跳转支付中间页,唤起已安装的支付 App 付款;收银台按所在环境自动选择支付产品。

    支付宝扫码 支付宝手机网站 微信 H5 微信小程序 抖音 H5
  • 公众号与小程序

    微信内

    在微信内打开收银台,经公众号网页授权调起支付;商户小程序传入付款人 openid 即可直接下单。

    微信公众号 微信小程序
  • 线下门店

    聚合收款码

    不写代码也能收款:一张收款码支持已开通的多种付款方式,付款人扫码后确认或输入金额,按所在 App 完成支付。

    免开发 收款码 扫码付款
  • SaaS 软件

    自有通道

    接入你自己的支付通道,平台负责下单、回调通知与订单管理,资金由你的通道直接结算;员工使用子账号登录,只开放授权的功能。

    自有通道 通道路由 子账号
  • 付款人售后

    订单服务页

    每笔订单都有订单服务页,付款人可以自助核实支付结果、通知商户、提交问题反馈,先找你处理,减少向支付渠道投诉。

    订单查询 问题反馈 投诉处理
06 安全保障

请求、应答和通知都能验证来源

商户私钥只保存在商户自己的服务器上,平台只保存公钥。平台的应答和通知同样带签名,通知里的业务数据再用回调密钥加密。

  • 签名

    非对称签名

    RSA 2048~4096 位密钥,SHA256withRSA 签名。密钥在浏览器本地生成,平台只保存商户公钥。

  • 加密

    通知加密

    通知业务数据用 32 位回调密钥做 AES-256-GCM 加密,带认证标签防篡改。

  • 防重放

    时间戳与随机串

    时间戳与平台相差超过 5 分钟即拒绝,随机串 15 分钟内不能重复使用。

  • 来源

    IP 白名单

    开放接口只接受白名单内服务器的请求,未配置时不限制来源 IP。

  • 密钥

    密钥轮换

    平台更换签名密钥时新旧公钥并存一段时间,可通过接口获取全部有效公钥。

  • 账号

    两步验证

    控制台登录支持 TOTP 两步验证,登录与关键操作全程记录日志。

  • 限流

    按商户限流

    每个商户每分钟 1,200 次请求;同一订单同一时间只处理一个请求,避免重复下单或重复退款。

  • 日志

    请求日志

    每个应答带请求 ID,签名错误、参数错误都能在控制台按请求 ID 查到原因。

07 商户控制台

电脑、iPad、手机上都能顺手处理

收款概览、订单、退款、对账、投诉、子账号权限都在控制台完成。出门在外,用手机也能查单、看收款。

电脑:侧边导航 + 四列数据卡片,表格完整展示示意数据

  • 10次 支付通知失败后自动重试,约 23 小时内
  • 90天 支付后可以发起原路退款
  • 5分钟 请求时间戳的允许误差,超出即拒绝
  • 1~120分钟 下单时可以指定订单有效期

接入前你可能想了解

整理了商户接入前常问的问题。没有找到答案时,可以先查看接入文档,或注册后在控制台查看产品与费率。

查看接入文档
注册与实名认证需要什么资料?

填写邮箱与登录密码即可注册。实名认证在线自动核验,不需要上传证件照片:个人填写姓名与身份证号后用手机刷脸;个体工商户和企业先核验营业执照登记信息(名称、统一社会信用代码、经营者或法定代表人姓名与身份证号),再由经营者或法定代表人刷脸,认证通过后才能收款。

费率怎么算?

注册免费。费率按支付产品和收款通道分别配置,不同商户、不同通道可能不同,注册后在控制台「产品与费率」查看已开通产品的实际费率与单笔限额。使用 SaaS 自有通道时,渠道手续费以你与渠道的约定为准,平台按套餐或按笔收取服务费。

支持哪些支付方式?

目前开放支付宝、微信支付、抖音支付,共 9 种支付产品:支付宝扫码、支付宝手机网站、支付宝电脑网站、微信扫码、微信公众号、微信 H5、微信小程序、抖音扫码、抖音 H5。实际可用的产品与限额以控制台「产品与费率」为准。

可以先测试再上线吗?

可以。在控制台「测试工具」中发起小额测试支付:走真实通道,与正常订单一样计手续费,付款后可以在订单详情中原路退款。「发送测试通知」不产生交易,用来确认你的验签与解密代码。

怎么确认付款人已经付款?

以异步通知或查单结果为准,付款后跳回 return_url 不能作为支付成功的依据。通知由平台私钥签名,推送失败按 15 秒、30 秒、3 分钟……的间隔自动重试,共 10 次;也可以在控制台手动重发,或调用查单接口兜底。

可以退款吗?

可以。在控制台的订单详情中发起,或调用 POST /api/v1/refunds。款项原路退回付款人,支持部分退款与多次退款,支付后 90 天内可以发起;申请时传入退款通知地址,退款结果同样以签名通知推送。

提供哪些开发语言的 SDK?

提供 PHP SDK(单文件、无第三方依赖,在接入文档中公开下载),以及 Java、Python、Node.js、Go 的示例代码,包含签名、验签与解密。

准备好接入了吗?

注册免费。先用小额测试支付走一遍真实通道,付款后可以在订单详情中原路退款;测试通知不产生交易。