主扫支付API

业务功能
初始化扫码请求,通过该请求生成二维码来进行扫码支付。
交互模式
请求:后台请求交互模式
返回结果+通知:后台请求交互模式+后台通知交互模式
测试url:
地址:39.107.230.207
端口:10020

请求参数(O-非必传 ,M-必传):

编码格式 参数名称 类型 参数说明 样例 可空
ASCII 交易类型(trans_type) String 必传:U(银联主扫) M
ASCII 接入机构标识(assignid) String 代理商线下入网获取 M
ASCII 商户编号(merch_no) String 商户在SaaS平台的编号 M
ASCII 服务商交易订单号(out_trade_no) String 服务商的交易订单编号(同一服务商下唯一) 161018121614000624679888 M
ASCII 订单金额原(total_amount) String 订单总金额,以元为单位 100 M
ASCII 通知地址(notify_url) String 支付成功后的通知地址 http://test.mdun.cn/jd/pay/notice O
ASCII SAAS终端号(pn) String 标准服务商必填(v1.27增加) M
ASCII 签名(sign) String 可以传递16位 M

请求示例:

带通知地址notify_url字节组拼接顺序:
trans_type + assignid +merch_no + out_trade_no + total_amount + notify_url + pn + sign
带通知地址notify_url签名字符串顺序:
assignid + merch_no + out_trade_no +total_amount + notify_url + pn + trans_type

不带通知地址notify_url字节组拼接顺序:
trans_type + assignid +merch_no + out_trade_no + total_amount + pn + sign
带通知地址notify_url签名字符串顺序:
assignid + merch_no + out_trade_no +total_amount + pn + trans_type

按照文档顺序
1.针对第一个参数交易类型A,使用1个字节来表示交易类型的ASCII长度(注意:每个参数字节组长度不能超过99个),使用bcd编码获取1个字节 bcd(A.getBytes(“ASCII”).length)
2.获取规定编码的字节组,A.getBytes(“ASCII”)
3.将1和2中字节组进行合并;
4.依次针对所有的字段进行拼接;
5.最后发送字节的16进制字符串:01410863706F73746573740838383838383838381374657374303030303030303036043130303016313231393035303530303030303030311645313445323743343045394544343630

返回参数:只针对返回return_code为10000的情况

编码格式 参数名称 类型 参数说明 样例 可空
ASCII 错误码(return_code) int 10000 代表成功,其他是失败 M
ASCII 服务商交易订单号(out_trade_no) String SaaS平台的交易订单编号 M
ASCII SAAS平台订单号(trade_no) String 凭证条码订单号(v1.24增加) 161018121614000624679888 M
ASCII 支付二维码地址(qr_code) String https://qr.95516.com/00010000/01142955972072216394471211817257 M
UTF-8 错误信息(return_msg) String O
ASCII 签名(sign) String M
ASCII 交易失败原因(pay_error_msg) String M

返回示例:

与请求方式一样,获取SAAS返回字节组,先通过解析第一个字节获并使用bcd编码获取return_code的长度,根据return_code的值,进行成功和失败两种的解析。解析过程中要注意参数的顺序
1.当retrun_code为10000时,SAAS平台返回字节组顺序是:return_code + out_trade_no + trade_no + qr_code + sign +pay_error_msg
签名顺序:return_code + out_trade_no + trade_no + qr_code
2.当retrun_code不为10000时,SAAS平台返回字节组顺序是:return_code + ret_msg + sign +pay_error_msg
签名顺序:return_code + return_msg

SAAS返回字节组转化16进制字符串
053130303030137465737430303030303030303726414C3230303432363135313134333933373530303934373234374668747470733A2F2F71722E616C697061792E636F6D2F6261783035343931376C686D75636F6F7076376836306331324136373637414332384145453130314344453736333635324143353145354541

文档更新时间: 2022-03-11 13:53   作者:admin