开发文档
接入提示
不提供BC、SSC、JR、QP、CP等涉及黄赌毒行业的支付接入,其他行业接入需审核通过方可开通接口
接入要求:
1.正规行业站点
2.接入站点域名需ICP网站备案
平台支持订单路由,商户可选平台通道或商户通道接入聚合支付
已开通双支付通道(平台通道、商户通道)的商户,订单默认由商户通道进行处理,在未对商户通道进行配置及开启时订单将转至平台通道进行处理
仅开通平台通道的商户,无需对商户通道进行配置
平台通道与商户通道区别:
平台通道:由平台代收款,资金由平台扣除交易手续费后结算至商户
商户通道:商户自行与支付渠道(支付宝、微信、QQ)签约,资金由支付渠道直接结算至商户,交易手续费由支付渠道收取
平台通道与商户通道收费:
平台通道:收取每笔交易手续费
商户通道:按年收取平台服务费,平台服务费4,999元/年
创建订单
请求方式:GET / POST
请求网址:https://pay.umistrong.com.cn/api/submit
参数说明:
参数名称 变量名 类型长度 是否必须 说明
版本号 version varchar(5) 默认 1.0
商户编号 customerid int(6) 商户后台获取
商户订单号 sdorderno varchar(50)
订单标题 subject varchar(256) 不传此参数时默认取商户订单号
订单描述 body varchar(128)
订单金额 totalfee decimal(10,2) 最多两位小数
支付编号 paytype varchar(12)
支付编号 支付渠道 适用场景 系统行为
alipay 支付宝PC 电脑网站支付 跳转支付宝PC付款页
alipaywap 支付宝WAP 手机网站支付 手机浏览器跳转支付宝WAP付款页
alipayjsapi 支付宝生活号 支付宝内置浏览器支付 手机支付宝扫一扫弹出收银台
alipayqr 支付宝扫码 电脑网站扫码支付 跳转扫码页
alipaymicro 支付宝付款码 线下条码支付 扣款成功返回success
付款码16~24位纯数字,以25~30开头
weixin 微信扫码 电脑网站扫码支付 跳转扫码页
weixinh5 微信H5 手机网站支付 手机浏览器跳转唤起手机微信收银台
weixinjsapi 微信公众号 手机微信内置浏览器支付 手机微信扫一扫弹出收银台
weixinmicro 微信付款码 线下条码支付 扣款成功返回success
付款码18位纯数字,以10、11、12、13、14、15开头
qq QQ扫码 电脑网站扫码支付 跳转扫码页
qqjsapi QQ公众号 手机QQ内置浏览器支付 手机QQ扫一扫弹出收银台
qqmicro QQ付款码 线下条码支付 扣款成功返回success
付款码18位纯数字,以91开头

技巧提示:
1.可对条码支付(alipaymicro、weixinmicro、qqmicro)进行包装,根据各渠道条码规则自动识别支付渠道进行接口调用扣款,以实现商户高效扫码
2.可对JSAPI支付(alipayjsapi、weixinjsapi、qqjsapi)进行包装,根据用户浏览器UA(User-Agent)自动识别支付渠道进行接口调用,以实现统一扫码(三码合一)
异步通知URL notifyurl varchar(50) 不能带有任何参数
同步跳转URL returnurl varchar(50) 不能带有任何参数
md5签名 sign varchar(32) 参照md5签名方法
分区判断 server varchar(50) 支付通知中原样返回,该字段主要用于商户携带订单的自定义数据
备注说明 remark varchar(50) 支付通知中原样返回,该字段主要用于商户携带订单的自定义数据
付款条码 authcode varchar(50) 条码支付(alipaymicro、weixinmicro、qqmicro)必传
md5签名方法:
version={value}&customerid={value}&totalfee={value}&sdorderno={value}&notifyurl={value}&returnurl={value}&apikey={value}
使用md5签名上面拼接的字符串即可生成小写的32位密文
异步通知回调
通知方式:POST
收到通知回复:success
回调失败的处理:如果收到商户的回复不符合规范或超时,会判定本次通知失败,重新发送通知,直到成功为止,但不保证通知最终一定能成功
参数说明:
参数名称 变量名 类型长度 说明
商户编号 customerid int(6)
商户订单号 sdorderno varchar(50)
平台订单号 sdpayno varchar(50)
交易金额 totalfee decimal(10,2) 通知回调业务处理过程中务必验证交易金额,支付失败返回交易金额为0
支付类型 paytype varchar(12) 同创建订单支付编号
md5验证签名 sign varchar(32) 参照md5签名方法
分区判断 server varchar(50) 原样返回
备注说明 remark varchar(50) 原样返回
md5签名方法:
customerid={value}&totalfee={value}&sdorderno={value}&sdpayno={value}&paytype={value}&apikey={value}
使用md5签名上面拼接的字符串即可生成小写的32位密文
同步通知跳转
通知方式:GET
其他说明:请不要在同步通知页面处理交易结果,最终结果以异步通知为准
参数说明:同异步参数说明
md5签名方法:同异步md5签名方法
订单查询
请求方式:GET / POST
请求网址:https://pay.umistrong.com.cn/api/query
参数说明:
参数名称 变量名 类型长度 是否必须 说明
版本号 version varchar(5) 默认 1.0
商户编号 customerid int(6) 商户后台获取
商户订单号 sdorderno varchar(50)
md5签名 sign varchar(32) 参照md5签名方法
md5签名方法:
version={value}&customerid={value}&sdorderno={value}&apikey={value}
使用md5签名上面拼接的字符串即可生成小写的32位密文
结果返回:
参数名称 变量名 类型长度 说明
支付状态 status int(2) 0 -> 已付款,已通知商户系统
1 -> 未付款
2 -> 已付款,待通知商户系统
3 -> 已退款,全额退款
4 -> 已关闭
5 -> 已退款,部分退款
商户订单号 sdorderno varchar(50)
平台订单号 sdpayno varchar(50)
渠道订单号 tradeno varchar(50) 未付款订单不返回
交易金额 totalfee decimal(10,2) 最多两位小数
支付类型 paytype varchar(12) 同创建订单支付编号
收款通道 ordertype int(2) 0 -> 平台通道
1 -> 商户通道
订单时间 datetime varchar(14) yyyyMMddHHmmss
付款时间 paytime varchar(14) yyyyMMddHHmmss,未付款订单不返回
退款明细 refund JSONArray 已退款订单返回此参数
参数名称 变量名 类型长度 说明
商户退款单号 sdrefundno varchar(50)
退款类型 refundtype int(2) 0 -> 全额退款
1 -> 部分退款
退款金额 refundfee decimal(10,2)
退款时间 datetime varchar(14) yyyyMMddHHmmss
退款状态 status int(2) 0 -> 退款成功
1 -> 退款失败
订单关闭
请求方式:GET / POST
请求网址:https://pay.umistrong.com.cn/api/close
参数说明:同订单查询参数说明
md5签名方法:同订单查询md5签名方法
结果返回:success
其他说明:订单成功关闭会返回success
订单撤销
请求方式:GET / POST
请求网址:https://pay.umistrong.com.cn/api/reverse
参数说明:同订单查询参数说明
md5签名方法:同订单查询md5签名方法
结果返回:success
其他说明:订单成功撤销会返回success
仅条码支付订单可调用本接口(alipaymicro、weixinmicro、qqmicro),调用本接口后,订单状态变化如下
1.已付款 -> 已退款 -> 已关闭
2.未付款 -> 已关闭
订单退款
请求方式:GET / POST
请求网址:https://pay.umistrong.com.cn/api/refund
结果返回:success
其他说明:订单成功退款会返回success
其他说明:调用本接口后,已付款金额将原路退回支付方,但商户在本平台已产生的平台手续费不退还,请确保商户账户余额大于已付款金额
参数说明:
参数名称 变量名 类型长度 是否必须 说明
商户退款单号 sdrefundno varchar(50) 退款业务单号,一般为商户订单号前加R,可全额退款,也可多次部分退款
例:
商户订单号001
全额退款:商户退款单号R001
部分退款:商户退款单号R001-1,R001-2,R001-3(以此类推,不能重复)
退款金额 refundfee decimal(10,2) 最多两位小数且金额不能大于商户订单可退金额
可退金额 = 实付金额 - 已退款金额
版本号 version varchar(5) 默认 1.0
商户编号 customerid int(6) 商户后台获取
商户订单号 sdorderno varchar(50)
md5签名 sign varchar(32) 参照md5签名方法
md5签名方法:
version={value}&customerid={value}&sdorderno={value}&sdrefundno={value}&refundfee={value}&apikey={value}
使用md5签名上面拼接的字符串即可生成小写的32位密文
集成测试
使用账号test密码test登陆平台获取接入秘钥(APIKey)进行商户系统集成开发
使用创建订单接口生成付款订单后,无需实际付款,使用测试商户进入商户后台->交易订单,在对应订单点击付款进行订单模拟支付后,再点击通知图标对商户系统进行异步回调

接入注意事项:
1.付款结果以异步通知为准
2.不论异步通知还是同步通知必须再次验证totalfee金额是否与发起支付时的金额一致,支付失败返回交易金额为0
3.我方支付系统有可能进行多次异步回调,要做好商户系统接收通知接口的订单处理逻辑,避免订单重复处理
4.订单支付成功后会对商户系统进行异步回调,商户系统需在订单处理完成后输出"success"反馈订单处理结果,否则我方支付系统会根据策略,间隔时间持续多次进行异步回调直至接收到"success"停止