之前我们学习了银联商务的H5支付,但是现在H5支付不支持微信支付,最后发现银联商务的公众号+服务窗支付可以支持支付宝支付+微信支付+银联支付
一:接口地址:
测试接口地址:https://qr-test2.chinaums.com/netpay-portal/webpay/pay.do
正式接口地址:https://qr.chinaums.com/netpay-portal/webpay/pay.do
二:主要参数说明:
接口使用的是get传参,直接将接口参数放到接口地址后,此接口是由浏览器直接跳转到接口
1:instMid
业务类型,直接填入:YUEDANDEFAULT
2:merOrderId
商户订单号
3:mid
银联商务的公众号+服务窗支付产品的商户号
4:msgSrc
消息来源,如:WWW.TEST.COM
5:msgType(这个参数是否重要,主要区分使用什么进行支付)
消息类型:微信支付使用:WXPay.jsPay,支付宝支付使用:trade.jsPay,银联支付使用:qmf.jspay或qmf.webPay
6:orderDesc
订单描述
7:requestTimestamp
报文请求时间,格式为:yyyy-MM-dd HH:mm:ss,如2019-10-01 12:12:12
8:tid
银联商务的公众号+服务窗支付产品的终端号
9:totalAmount
支付总金额,单位为分
10:notifyUrl
支付结果通知地址
11:returnUrl
网页跳转地址
12:sign
签名,将上面的参数按照a-z的顺序进行排序,排序完成之后用&字符连接起来,连接起来之后如果存在转义字符,那么去掉转义字符,然后进行md5加密获取到签名
三:银联商务的公众号+服务窗支付实例:
//测试号相关信息
$mdKey = 'fcAmtnx7MwismjWNhNKdHC44mNXtnEQeJkRrhKJwyrW2ysRR';
$mid = '898340149000005';
$tid = '88880001';
$time = time();
$requestTimestamp = date('Y-m-d H:i:s',$time);
$merOrderId = date('YmdHis') . mt_rand(100000, 999999);
$msgType = 'qmf.jspay';//微信支付:WXPay.jsPay,支付宝支付:trade.jsPay,银联支付:qmf.jspay(qmf.webPay)
$data = [
'instMid' => 'YUEDANDEFAULT',//业务类型
'merOrderId' => $merOrderId,//订单号
'mid' => $mid,//商户号
'msgSrc' => 'WWW.TEST.COM',//消息来源
'msgType' => $msgType,//消息类型
'orderDesc' => '测试',//订单描述
'requestTimestamp' => $requestTimestamp,//报文请求时间
'tid' => $tid,//终端号
'totalAmount' => '1',//支付金额
'notifyUrl' => 'http://d9vhs4.natappfree.cc',//支付结果通知地址,结果页面会将返回参数通过post传过来。通过status值来判断是否支付成功
'returnUrl' => 'http://d9vhs4.natappfree.cc',//网页跳转地址,结果页面会将返回参数通过get传过来。通过status值来判断是否支付成功
];
ksort($data);
reset($data);
$options = '';
foreach ($data as $key => $value) {
$options .= $key . '=' . $value .'&';
}
$options = rtrim($options, '&');
//存在转义字符,那么去掉转义
if(get_magic_quotes_gpc()){
$options = stripslashes($options);
}
$sign = md5($options . $mdKey);
$options .= '&sign=' . $sign;
$url = 'https://qr-test2.chinaums.com/netpay-portal/webpay/pay.do?'.$options;
//获取到url之后直接跳转即可
支付结束后返回的status参数取值:
四:支付退款
既然有支付那么就有退款,那么如何进行退款呢
1:退款接口
测试接口:https://qr-test2.chinaums.com/netpay-route-server/api/
正式接口:https://qr.chinaums.com/netpay-route-server/api/
2:主要参数说明
(1)msgSrc
消息来源,例:WWW.TEST.COM
(2)msgType
消息来源,直接填入:refund
(3)requestTimestamp
报文请求时间,格式为yyyy-MM-dd HH:mm:ss,如:2019-10-01 12:12:12
(4)merOrderId
商户订单号
(5)instMid
业务类型,直接填入YUEDANDEFAULT
(6)mid
银联商务的公众号+服务窗支付产品的商户号
(7)tid
银联商务的公众号+服务窗支付产品的终端号
(8)refundAmount
退款金额,单位为分
(9)refundDesc
退款说明
(10)sign
签名
实现方式同支付中签名相同
五:支付退款实例
//测试号相关信息
$mdKey = 'fcAmtnx7MwismjWNhNKdHC44mNXtnEQeJkRrhKJwyrW2ysRR';
$mid = '898340149000005';
$tid = '88880001';
$requestTimestamp = date('Y-m-d H:i:s',time());
$data = [
'msgSrc' => 'WWW.TEST.COM',//消息来源
'msgType' => 'refund',//消息类型
'requestTimestamp' => $requestTimestamp,//报文请求时间
'merOrderId' => $merOrderId,//订单号
'instMid' => $params['instMid'],//业务类型
'mid' => $mid,//商户号
'tid' => $tid,//终端号
'refundAmount' => 1,//退款金额
'refundDesc' => '测试',//退款说明
];
ksort($data);
reset($data);
$options = '';
foreach ($data as $key => $value) {
$options .= $key . '=' . $value .'&';
}
$options = rtrim($options, '&');
//存在转义字符,那么去掉转义
if(get_magic_quotes_gpc()){
$options = stripslashes($options);
}
//签名
$sign = md5($options . $mdKey);
$data['sign'] = $sign;
$client = new Client();
$response = $client->createRequest()
->setMethod('POST')
->setUrl('https://qr-test2.chinaums.com/netpay-route-server/api/')
->setData($data)
->setHeaders([
'Content-Type'=>'application/json'
])
->setFormat(Client::FORMAT_JSON) //提交的数据的格式
->send();
if ($response->isOk) {
$data = $response->data;
if ($data['refundStatus'] == 'SUCCESS') {
//退款成功
return true;
}
}
return false;
}