计全付开放平台 - 官方文档
1. 接入指南
计全付是面向企业、开发者、服务商的一站式开放支付平台,提供聚合支付、退款、代付、分账、对账、商户管理、渠道管理等全能力。
一次对接,即可支持微信支付、支付宝、云闪付、网关、快捷、协议支付等全渠道支付能力。
注册账号 → 实名认证 → 创建商户 → 创建应用 → 配置渠道 → 开发对接 → 测试联调 → 正式上线
登录开放平台 → 商户管理 → 新建商户 → 填写基本信息、结算信息 → 提交审核 → 审核通过即可使用
企业商户:营业执照、法人身份证、对公银行账户
个体工商户:营业执照、法人身份证、法人银行卡
不同支付渠道、支付方式费率不同,以平台签约费率为准。
费率按交易金额百分比计算,精确到分。
限额受支付渠道、商户等级、风控策略影响。
单笔限额、单日限额、单月限额以渠道与平台配置为准。
提供专用测试商户号、测试appId、测试密钥,支持无资金测试支付、退款、代付、分账全流程。
测试通过 → 申请正式商户 → 替换正式appId与密钥 → 切换正式网关 → 正式运营
2. 开发规范
请求方式:POST
数据格式:JSON
编码格式:UTF-8
超时时间:10s
| 参数名 | 必填 | 说明 |
|---|---|---|
| mchNo | 是 | 商户号 |
| appId | 是 | 应用ID |
| version | 是 | 版本号1.0 |
| reqTime | 是 | 13位时间戳 |
| signType | 是 | MD5/RSA2 |
| sign | 是 | 签名 |
1. 所有请求参数中,剔除空值与sign本身
2. 按字段名 ASCII 码从小到大排序
3. 使用 & 拼接成 key=value 格式
4. 末尾拼接 &key=apiKey
5. 做MD5运算,结果转大写
使用SHA256WithRSA算法,商户使用私钥签名,平台使用公钥验签。
签名串规则同MD5,不拼接key,使用私钥进行签名。
平台返回数据与异步通知均带sign,开发者需验签通过后再处理业务。
验签规则:剔除sign与空值 → 排序 → 拼接 → MD5或RSA2验签。
支付、退款、代付、分账结果通过异步通知推送。
开发者需返回 "success" 字符串,否则平台会重试。
重试规则:1分钟、5分钟、15分钟、30分钟、1小时……最多24小时。
0:处理成功
非0:业务失败,具体看错误码
错误码统一为数字编码,附带错误描述,用于定位问题。
所有字段使用驼峰命名,长度、格式、枚举值按接口文档要求。
所有金额单位为:分(整数类型)
1元 = 100分
不允许使用小数传输金额
3. 支付接口
地址:/api/pay/unifiedOrder
| 参数 | 必填 | 说明 |
|---|---|---|
| mchOrderNo | 是 | 商户订单号 |
| wayCode | 是 | 支付方式编码 |
| amount | 是 | 金额,分 |
| subject | 是 | 商品标题 |
| body | 是 | 商品描述 |
| notifyUrl | 是 | 异步通知地址 |
| returnUrl | 否 | 同步跳转地址 |
地址:/api/pay/query
参数:mchOrderNo / payOrderId 二选一
地址:/api/pay/close
仅支持未支付订单关闭
查询微信/支付宝/云闪付等渠道侧真实订单状态
支付完成后前端跳转returnUrl,仅作展示,不可作为支付成功依据。
支付结果正式通知,必须验签、做幂等、处理业务后返回success。
商户可在平台手动触发支付结果重推,用于补单。
4. 退款接口
地址:/api/refund/create
退款金额不可大于支付金额,需支持部分退款。
地址:/api/refund/query
关闭处理中的退款单
退款成功/失败后推送商户后台
5. 代付接口
地址:/api/transfer/apply
支持银行卡、支付宝、微信等代付方式
地址:/api/transfer/query
代付结果实时推送
6. 分账接口
支持订单支付后按比例/固定金额分给多个接收方,支持实时分账、延时分账。
配置分账接收方、分账比例、上限、结算方式
发起分账执行
查询分账状态、分账明细
结束分账,剩余资金解冻
撤销未执行的分账任务
分账成功/失败异步通知
7. 商户管理接口
ISV/服务商可通过接口创建二级商户
查询商户信息、状态、费率
修改商户基础信息
启用/停用商户
查询商户可用余额、冻结金额、结算金额
8. 渠道管理接口
查询商户可用支付渠道
新增渠道配置
修改渠道参数
启用/停用渠道
修改渠道费率
9. 应用管理接口
创建应用,生成appId
查询应用信息、状态
修改应用信息
启用/停用应用
10. 微信支付
公众号、服务号内支付
生成二维码支付
外部浏览器H5支付
手机APP调起微信支付
微信小程序支付
微信服务商特约商户进件与支付
微信电商平台分账结算能力
先享后付、信用支付
11. 支付宝
支付宝内小程序/服务窗支付
手机网页支付
APP调起支付宝
电脑网站支付
支付宝小程序支付
支付宝服务商进件
支付宝官方分账能力
12. 云闪付 & 网关
用户扫商家码
商家扫用户付款码
云闪付H5支付
网银支付
银行卡快捷支付
签约代扣支付
13. 对账文件
按日期获取CSV对账文件
支付订单对账
退款订单对账
代付订单对账
14. 安全与风控
金额、频次、地域、设备、用户行为风控
自定义风控阈值、黑白名单
拦截、复核、解封流程
短信验证、谷歌验证
仅允许白名单IP调用接口
仅允许白名单域名接收回调
15. 服务商体系
ISV服务商可发展二级商户,赚取费率差
服务商替商户进件
查询商户信息与状态
查询进件审核进度
微信/支付宝/云闪付渠道进件
为子商户创建应用
16. 常见问题
检查参数排序、空值剔除、key是否正确、编码是否UTF-8、是否大写
检查返回参数是否被修改、sign是否正确、公钥是否匹配
检查地址是否公网可访问、是否返回success、防火墙是否拦截
业务必须做幂等,返回success后不再重复处理
根据渠道错误码检查参数、权限、配置
必须使用分,不可使用小数
检查订单状态、余额、退款金额、渠道限制
检查银行卡信息、余额、姓名、开户行
检查分账配置、金额、接收方权限
17. SDK & Demo
提供完整Maven/Gradle依赖,开箱即用
支持Composer,适配Laravel、ThinkPHP
支持pip,适配Django、Flask
轻量、高性能、易集成
支持Express、Koa
全平台APP/小程序Demo
原生APP支付示例
后台管理支付页面示例
支付弹窗、收银台组件
18. 附录
| 编码 | 说明 |
|---|---|
| WX_JSAPI | 微信JSAPI |
| WX_NATIVE | 微信扫码 |
| WX_H5 | 微信H5 |
| ALI_H5 | 支付宝H5 |