♦ 背景
PHP
官方文档,请参考:
【>>> 微信支付分产品介绍】
☞ 前期准备
可直接参考指导文档
【>>>接入前准备】
weixinpay_scoreBD@tencent.com
发送邮件接入申请
一般都由 产品负责人员进行申请,
作为开发人员,重点在于阅读开发文档,编写测试用例【免确认订单模式】是高级接口权限,需特殊申请才能使用。
使用支付分的行业/场景,目前只能调用【需确认订单模式】接口。
接口调用权限与服务id相关,在申请服务id时,只有上述场景下的服务 id,才有权限调用【免确认订单模式】接口。
即只有在上述场景下,创建支付分订单 api 接口中 need_user_confirm 字段才能传。
false:免确认订单。
以【免确认订单模式】为例,用户使用流程如下:
首次使用,用户先从商户端(小程序/app/H5),跳入微信支付分页面,进行商户服务的授权
授权成功后,商户即可通过后台接口,进行支付分订单的创建和完结。用户无需再进入支付分授权页面进行授权。
一般正式开发前,需进行
【>>> 微信支付分测试号配置指引】
☛ 开发指引
再次提醒,以【免确认模式】开发操作为例
1. 首先,用户在商户侧下单购买产品或服务,此时,我们需要先对用户的授权状态进行查询
2. 引导用户开启授权服务
这一步需要根据实际场景,比如:APP场景调起支付分-授权服务、H5场景调起支付分-授权服务、小程序调起支付分-授权服务
3. 创建支付分订单
4. 商户为用户提供服务,待服务结束后,商户调用完结订单接口完结当前订单
5. 收到用户扣款成功通知,业务流程结束
▷ 第一步
引导用户开启授权服务这一步需要前端的页面设计,主要在于引导开启授权服务
▷ 第二步
签名生成服务端接口编写前,我们需要成功使用 微信官方要求的
>>>【签名规则】
HTTP Header 头
封装方法:
/**
* @Notes: 签名封装方法
* @param $url 请求接口链接地址
* @param $type 请求方法 GET/POST
* @param $bodys 请求主体 json_encode() 处理后的字符串
* @return mixed
* @User: zhanghj
* @DateTime: 2023-08-31 18:18
*/
public function getToken($url,$type,$bodys= ''){
//请求头
$arr_header[] = "Content-Type: application/json";
$arr_header[] = "Accept: application/json";
$arr_header[] = "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3100.0 Safari/537.36" ;
//生成签名
$http_method = $type;
$timestamp = time();
$nonce = $this->createNoncestr(32);
$body = $bodys;
$merchant_id = "XXXXXXXXXXXXXXXXX"; //商户号
$serial_no = "NNNNNNNNNNNNNNNNNNNNNNNNNN"; //这个是证书号 这个必须使用新版证书
$url_parts = parse_url($url);
$canonical_url = ($url_parts['path'] . (!empty($url_parts['query']) ? "?${url_parts['query']}" : ""));
$message = $http_method . "\n" .
$canonical_url . "\n" .
$timestamp . "\n" .
$nonce . "\n" .
$body . "\n";
openssl_sign($message, $raw_sign, PayConfig::PrivateKey, 'sha256WithRSAEncryption');
$sign = base64_encode($raw_sign);
$schema = 'WECHATPAY2-SHA256-RSA2048 ';
$token = sprintf('mchid="%s",nonce_str="%s",timestamp="%d",serial_no="%s",signature="%s"',
$merchant_id, $nonce, $timestamp, $serial_no, $sign);
$arr_header[] = "Authorization:" . $schema . $token;
return $arr_header;
}
//作用:产生随机字符串,不长于 32 位
public function createNoncestr($length = 32) {
$chars = "abcdefghijklmnopqrstuvwxyz0123456789";
$str = "";
for ($i = 0; $i < $length; $i++) {
$str .= substr($chars, mt_rand(0, strlen($chars) - 1), 1);
}
$result_ = strtoupper($str);
return $result_;
}
▷ 第三步
接口请求用例以 “创建支付分订单” 为例,代码参考如下:
$url = 'https://api.mch.weixin.qq.com/v3/payscore/serviceorder';
$data = array(
'out_order_no'=>$orderSn,
'appid' => PayConfig::AppId,//公众号
'service_id' =>$wxPayConf['service_id'],//服务id
'service_introduction'=>'智慧零售',
'risk_fund'=>array(
'name'=>'ESTIMATE_ORDER_COST',
'amount'=>20000,
),
'location'=>array(
'start_location'=>'江苏省苏州市创意产业园15-303',
),
'time_range'=>array(
'start_time'=>'OnAccept',
),
'need_user_confirm'=>false,
'notify_url'=>'http://xxxxxxxxxxxxx/order/wx_pay_notify', //回调地址
);
$arr_header = $this->getToken($url,'POST',json_encode($data,JSON_UNESCAPED_UNICODE));
$res = $this->posturl($url, json_encode($data,JSON_UNESCAPED_UNICODE), $arr_header);
$res_arr = json_decode($res, true);
【提示】:
可根据返回参数 "state",对支付分订单作符合业务的处理
CURL POST
请求处理方法 public function posturl($url, $data = null, $arr_header = []){
$curl = curl_init();
// curl 设置
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE);
// 判断 $data get or post
if ( !empty($data) ) {
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
}
if (!empty($arr_header)) {
curl_setopt($curl, CURLOPT_HTTPHEADER, $arr_header);
}
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// 执行
$res = curl_exec($curl);
curl_close($curl);
return $res;
}
▷ 第四步
支付成功回调通知 API微信支付分通过支付成功通知接口将用户支付成功消息通知给商户
【>>> 支付成功回调通知文档】
描述如下:
【提示】
一般在此回调接口位置,
根据返回的订单号out_order_no
,以及状态 state="DONE"
对商家应用的订单,处理最后的更新操作逻辑
同时,注意保存 微信服务端返回的支付信息,比如字段:transaction_id
,方便后期的退款操作
▶ 附录
创建支付分订单
取消支付分订单
完结支付分订单
支付成功回调通知
申请退款、退款结果通知