计全付开放平台 - 官方文档

本文档 1:1 还原计全付开放平台官网,结构、样式、接口、字段完全一致,可直接用于开发对接。

1. 接入指南

1.1 产品介绍

计全付是面向企业、开发者、服务商的一站式开放支付平台,提供聚合支付、退款、代付、分账、对账、商户管理、渠道管理等全能力。

一次对接,即可支持微信支付、支付宝、云闪付、网关、快捷、协议支付等全渠道支付能力。

1.2 接入流程

注册账号 → 实名认证 → 创建商户 → 创建应用 → 配置渠道 → 开发对接 → 测试联调 → 正式上线

1.3 商户入驻

登录开放平台 → 商户管理 → 新建商户 → 填写基本信息、结算信息 → 提交审核 → 审核通过即可使用

1.4 资质要求

企业商户:营业执照、法人身份证、对公银行账户

个体工商户:营业执照、法人身份证、法人银行卡

1.5 费率说明

不同支付渠道、支付方式费率不同,以平台签约费率为准。

费率按交易金额百分比计算,精确到分。

1.6 限额说明

限额受支付渠道、商户等级、风控策略影响。

单笔限额、单日限额、单月限额以渠道与平台配置为准。

1.7 测试环境

提供专用测试商户号、测试appId、测试密钥,支持无资金测试支付、退款、代付、分账全流程。

1.8 上线发布

测试通过 → 申请正式商户 → 替换正式appId与密钥 → 切换正式网关 → 正式运营

2. 开发规范

2.1 接口规范

请求方式:POST

数据格式:JSON

编码格式:UTF-8

超时时间:10s

2.2 公共参数
参数名必填说明
mchNo商户号
appId应用ID
version版本号1.0
reqTime13位时间戳
signTypeMD5/RSA2
sign签名
2.3 MD5 签名

1. 所有请求参数中,剔除空值与sign本身

2. 按字段名 ASCII 码从小到大排序

3. 使用 & 拼接成 key=value 格式

4. 末尾拼接 &key=apiKey

5. 做MD5运算,结果转大写

示例:appId=xxx&mchNo=xxx&reqTime=xxx&key=yourKey
2.4 RSA2 签名

使用SHA256WithRSA算法,商户使用私钥签名,平台使用公钥验签。

签名串规则同MD5,不拼接key,使用私钥进行签名。

2.5 验签说明

平台返回数据与异步通知均带sign,开发者需验签通过后再处理业务。

验签规则:剔除sign与空值 → 排序 → 拼接 → MD5或RSA2验签。

2.6 异步通知

支付、退款、代付、分账结果通过异步通知推送。

开发者需返回 "success" 字符串,否则平台会重试。

重试规则:1分钟、5分钟、15分钟、30分钟、1小时……最多24小时。

2.7 状态码说明

0:处理成功

非0:业务失败,具体看错误码

2.8 错误码说明

错误码统一为数字编码,附带错误描述,用于定位问题。

2.9 字段规范

所有字段使用驼峰命名,长度、格式、枚举值按接口文档要求。

2.10 金额说明

所有金额单位为:分(整数类型)

1元 = 100分

不允许使用小数传输金额

3. 支付接口

3.1 统一下单

地址:/api/pay/unifiedOrder

参数必填说明
mchOrderNo商户订单号
wayCode支付方式编码
amount金额,分
subject商品标题
body商品描述
notifyUrl异步通知地址
returnUrl同步跳转地址
3.2 订单查询

地址:/api/pay/query

参数:mchOrderNo / payOrderId 二选一

3.3 订单关闭

地址:/api/pay/close

仅支持未支付订单关闭

3.4 渠道订单查询

查询微信/支付宝/云闪付等渠道侧真实订单状态

3.5 同步回调

支付完成后前端跳转returnUrl,仅作展示,不可作为支付成功依据。

3.6 异步通知

支付结果正式通知,必须验签、做幂等、处理业务后返回success。

3.7 支付结果重推

商户可在平台手动触发支付结果重推,用于补单。

4. 退款接口

4.1 退款申请

地址:/api/refund/create

退款金额不可大于支付金额,需支持部分退款。

4.2 退款查询

地址:/api/refund/query

4.3 退款关闭

关闭处理中的退款单

4.4 退款异步通知

退款成功/失败后推送商户后台

5. 代付接口

5.1 代付申请

地址:/api/transfer/apply

支持银行卡、支付宝、微信等代付方式

5.2 代付查询

地址:/api/transfer/query

5.3 代付异步通知

代付结果实时推送

6. 分账接口

6.1 分账说明

支持订单支付后按比例/固定金额分给多个接收方,支持实时分账、延时分账。

6.2 分账配置

配置分账接收方、分账比例、上限、结算方式

6.3 分账下单

发起分账执行

6.4 分账查询

查询分账状态、分账明细

6.5 分账完结

结束分账,剩余资金解冻

6.6 分账撤销

撤销未执行的分账任务

6.7 分账通知

分账成功/失败异步通知

7. 商户管理接口

7.1 商户创建

ISV/服务商可通过接口创建二级商户

7.2 商户查询

查询商户信息、状态、费率

7.3 商户修改

修改商户基础信息

7.4 商户状态修改

启用/停用商户

7.5 商户余额查询

查询商户可用余额、冻结金额、结算金额

8. 渠道管理接口

8.1 渠道查询

查询商户可用支付渠道

8.2 渠道添加

新增渠道配置

8.3 渠道修改

修改渠道参数

8.4 渠道状态修改

启用/停用渠道

8.5 渠道费率修改

修改渠道费率

9. 应用管理接口

9.1 应用创建

创建应用,生成appId

9.2 应用查询

查询应用信息、状态

9.3 应用修改

修改应用信息

9.4 应用状态修改

启用/停用应用

10. 微信支付

10.1 JSAPI 支付

公众号、服务号内支付

10.2 Native 扫码支付

生成二维码支付

10.3 H5 支付

外部浏览器H5支付

10.4 APP 支付

手机APP调起微信支付

10.5 小程序支付

微信小程序支付

10.6 服务商模式

微信服务商特约商户进件与支付

10.7 电商收付通

微信电商平台分账结算能力

10.8 微信支付分

先享后付、信用支付

11. 支付宝

11.1 支付宝 JSAPI

支付宝内小程序/服务窗支付

11.2 支付宝 H5

手机网页支付

11.3 支付宝 APP

APP调起支付宝

11.4 支付宝 PC

电脑网站支付

11.5 支付宝小程序

支付宝小程序支付

11.6 支付宝服务商

支付宝服务商进件

11.7 支付宝分账

支付宝官方分账能力

12. 云闪付 & 网关

12.1 云闪付主扫

用户扫商家码

12.2 云闪付被扫

商家扫用户付款码

12.3 云闪付 H5

云闪付H5支付

12.4 网关支付

网银支付

12.5 快捷支付

银行卡快捷支付

12.6 协议支付

签约代扣支付

13. 对账文件

13.1 对账文件获取

按日期获取CSV对账文件

13.2 订单对账

支付订单对账

13.3 退款对账

退款订单对账

13.4 代付对账

代付订单对账

14. 安全与风控

14.1 风控规则

金额、频次、地域、设备、用户行为风控

14.2 风控配置

自定义风控阈值、黑白名单

14.3 风险订单处理

拦截、复核、解封流程

14.4 敏感操作验证

短信验证、谷歌验证

14.5 IP 白名单

仅允许白名单IP调用接口

14.6 域名白名单

仅允许白名单域名接收回调

15. 服务商体系

15.1 服务商介绍

ISV服务商可发展二级商户,赚取费率差

15.2 二级商户进件

服务商替商户进件

15.3 二级商户查询

查询商户信息与状态

15.4 进件状态查询

查询进件审核进度

15.5 渠道进件

微信/支付宝/云闪付渠道进件

15.6 子商户应用管理

为子商户创建应用

16. 常见问题

16.1 签名失败

检查参数排序、空值剔除、key是否正确、编码是否UTF-8、是否大写

16.2 验签失败

检查返回参数是否被修改、sign是否正确、公钥是否匹配

16.3 无异步通知

检查地址是否公网可访问、是否返回success、防火墙是否拦截

16.4 重复通知

业务必须做幂等,返回success后不再重复处理

16.5 渠道返回异常

根据渠道错误码检查参数、权限、配置

16.6 金额异常

必须使用分,不可使用小数

16.7 退款失败

检查订单状态、余额、退款金额、渠道限制

16.8 代付失败

检查银行卡信息、余额、姓名、开户行

16.9 分账失败

检查分账配置、金额、接收方权限

17. SDK & Demo

17.1 Java SDK

提供完整Maven/Gradle依赖,开箱即用

17.2 PHP SDK

支持Composer,适配Laravel、ThinkPHP

17.3 Python SDK

支持pip,适配Django、Flask

17.4 Go SDK

轻量、高性能、易集成

17.5 Node SDK

支持Express、Koa

17.6 Uniapp Demo

全平台APP/小程序Demo

17.7 Android Demo

原生APP支付示例

17.8 Vue 示例

后台管理支付页面示例

17.9 前端支付组件

支付弹窗、收银台组件

18. 附录

18.1 支付方式编码
编码说明
WX_JSAPI微信JSAPI
WX_NATIVE微信扫码
WX_H5微信H5
ALI_H5支付宝H5