我们这里对接的就是扫码支付
扫码支付,指用户打开支付宝钱包中的“扫一扫”功能,扫描商家展示在某收银场景下的二维码并进行支付的模式。该模式适用于线下实体店支付、面对面支付等场景。业务流程如下图所示:
由于当面付的签约非常简单,允许个体工商户/个人商户签约。所以该方式也被大量用于线上的扫码支付,由于该方式违反了支付宝的相关条款,有一定风险,咱作为技术交流,暂且先抛开这个问题。
作为技术对接,即使你没有签约当面付产品,也是可以进行开发的。
支付能力直接涉及到交易与资金,为了方便开放者调试支付能力,开放平台已经准备好沙箱环境,包括沙箱环境账号和沙箱版支付宝钱包,这样开发者就可以在沙箱环境调试了。点击了解如何接入沙箱并接入沙箱环境。
所以我这边开发使用的是沙箱环境,毕竟里面好多钱,随便用。
首先先下载相应的开发语言的sdk 下载:https://docs.open.alipay.com/194/105201/
扫码支付文档:https://docs.open.alipay.com/194/106078/
配置密钥
为了保证交易双方(商户和支付宝)的身份和数据安全,开发者在调用接口前,需要配置双方密钥,对交易数据进行双方校验。
下载支付宝开放平台开发助手进行密钥生成。
生成密钥后,开发者需要在开放平台开发者中心进行密钥配置,配置完成后可以获取支付宝公钥
设计接入
由于我这边的设计不需要用到轮询(后面会说),所以没有加上
以下是我业务中的相关代码
public function pay(){ if (request()->isPost()) { // (必填) 商户网站订单系统中唯一订单号,64个字符以内,只能包含字母、数字、下划线, // 需保证商户系统端不能重复,建议通过数据库sequence生成, $uid = Session::get('sq.uid'); $outTradeNo = order_num() . $uid; // (必填) 订单标题,粗略描述用户的支付目的。如“xxx品牌xxx门店当面付扫码消费” $subject = '聚合平台用户积分充值'; // (必填) 订单总金额,单位为元,不能超过1亿元 // 如果同时传入了【打折金额】,【不可打折金额】,【订单总金额】三者,则必须满足如下条件:【订单总金额】=【打折金额】+【不可打折金额】 $totalAmount = input('post.pay_money/f'); if($totalAmount < 1){ return ['status' => 1, 'msg' => '最低充值金额1元']; } if($totalAmount > 9999999){ return ['status' => 1, 'msg' => '充值最大金额不能超过9999999元']; } // (不推荐使用) 订单可打折金额,可以配合商家平台配置折扣活动,如果订单部分商品参与打折,可以将部分商品总价填写至此字段,默认全部商品可打折 // 如果该值未传入,但传入了【订单总金额】,【不可打折金额】 则该值默认为【订单总金额】- 【不可打折金额】 //String discountableAmount = "1.00"; // // (可选) 订单不可打折金额,可以配合商家平台配置折扣活动,如果酒水不参与打折,则将对应金额填写至此字段 // 如果该值未传入,但传入了【订单总金额】,【打折金额】,则该值默认为【订单总金额】-【打折金额】 // $undiscountableAmount = "0.01"; // 卖家支付宝账号ID,用于支持一个签约账号下支持打款到不同的收款账号,(打款到sellerId对应的支付宝账号) // 如果该字段为空,则默认为与支付宝签约的商户的PID,也就是appid对应的PID //$sellerId = ""; // 订单描述,可以对交易或商品进行一个详细地描述,比如填写"购买商品2件共15.00元" $body = "聚合平台用户积分充值" . $totalAmount . '元'; //商户操作员编号,添加此参数可以为商户操作员做销售统计 // $operatorId = ""; // (可选) 商户门店编号,通过门店号和商家后台可以配置精准到门店的折扣信息,详询支付宝技术支持 // $storeId = ""; // 支付宝的店铺编号 // $alipayStoreId= ""; // 业务扩展参数,目前可添加由支付宝分配的系统商编号(通过setSysServiceProviderId方法),系统商开发使用,详情请咨询支付宝技术支持 // $providerId = ""; //系统商pid,作为系统商返佣数据提取的依据 // $extendParams = new ExtendParams(); // $extendParams->setSysServiceProviderId($providerId); // $extendParamsArr = $extendParams->getExtendParams(); // 支付超时,线下扫码交易定义为5分钟 $timeExpress = "5m"; // 商品明细列表,需填写购买商品详细信息, // $goodsDetailList = array(); // // 创建一个商品信息,参数含义分别为商品id(使用国标)、名称、单价(单位为分)、数量,如果需要添加商品类别,详见GoodsDetail // $goods1 = new GoodsDetail(); // $goods1->setGoodsId("apple-01"); // $goods1->setGoodsName("iphone"); // $goods1->setPrice(3000); // $goods1->setQuantity(1); // //得到商品1明细数组 // $goods1Arr = $goods1->getGoodsDetail(); // // 继续创建并添加第一条商品信息,用户购买的产品为“xx牙刷”,单价为5.05元,购买了两件 // $goods2 = new GoodsDetail(); // $goods2->setGoodsId("apple-02"); // $goods2->setGoodsName("ipad"); // $goods2->setPrice(1000); // $goods2->setQuantity(1); // //得到商品1明细数组 // $goods2Arr = $goods2->getGoodsDetail(); // $goodsDetailList = array($goods1Arr,$goods2Arr); //第三方应用授权令牌,商户授权系统商开发模式下使用 $appAuthToken = "";//根据真实值填写 // 创建请求builder,设置请求参数 $qrPayRequestBuilder = new AlipayTradePrecreateContentBuilder(); $qrPayRequestBuilder->setOutTradeNo($outTradeNo); $qrPayRequestBuilder->setTotalAmount($totalAmount); $qrPayRequestBuilder->setTimeExpress($timeExpress); $qrPayRequestBuilder->setSubject($subject); $qrPayRequestBuilder->setBody($body); // $qrPayRequestBuilder->setUndiscountableAmount($undiscountableAmount); // $qrPayRequestBuilder->setExtendParams($extendParamsArr); // $qrPayRequestBuilder->setGoodsDetailList($goodsDetailList); // $qrPayRequestBuilder->setStoreId($storeId); // $qrPayRequestBuilder->setOperatorId($operatorId); // $qrPayRequestBuilder->setAlipayStoreId($alipayStoreId); $qrPayRequestBuilder->setAppAuthToken($appAuthToken); // 调用qrPay方法获取当面付应答 require ROOT_PATH.'extend/f2fpay/config/config.php'; $qrPay = new AlipayTradeService($config); $qrPayResult = $qrPay->qrPay($qrPayRequestBuilder); // 根据状态值进行业务处理 switch ($qrPayResult->getTradeStatus()){ case "SUCCESS": $response = $qrPayResult->getResponse(); Db::name('order') ->insert([ 'uid' => $uid, 'pay_id' => $outTradeNo, 'money' => $totalAmount, 'creat_time' => time(), 'subject' => $subject ]); return ['status' => 0, 'msg' => '支付宝创建订单二维码成功!!!"','data' => [ 'qr_code' => $response->qr_code, 'outTradeNo' => $outTradeNo ]]; // $qrcode = $qrPay->create_erweima($response->qr_code); // echo $qrcode; // print_r($response); break; case "FAILED": return ['status' => 1, 'msg' => '支付宝创建订单二维码失败!!!"']; // if(!empty($qrPayResult->getResponse())){ // print_r($qrPayResult->getResponse()); // } break; case "UNKNOWN": return ['status' => 1, 'msg' => '系统异常,状态未知!!!"']; // echo "系统异常,状态未知!!!"."<br>--------------------------<br>"; // if(!empty($qrPayResult->getResponse())){ // print_r($qrPayResult->getResponse()); // } break; default: return ['status' => 1, 'msg' => '不支持的返回状态,创建订单二维码返回异常!!!']; break; } return ; } }以上就是当面付预下单代码
关于这个SDK,我非常有必要吐槽一下,哪个货写的demo,还在PHP例子里引入了个lotusphp框架,一大堆没有用的东西,完全没有考虑我们开发者能不能接受的了。
我也是花了点时间,把SDK给精简了一下,只拿出我需要的部分,放入了我自己的框架中,加上了namespace,自动加载。
扫码支付有一个独有的功能----异步通知
这个也正是线上支付最为需要的功能
当收银台调用预下单请求 API 生成二维码展示给用户后,用户通过手机扫描二维码进行支付,支付宝会将该笔订单的变更信息,沿着商户调用预下单请求时所传入的异步通知地址 notify_url,通过 POST 请求的形式将支付结果作为参数通知到商户系统。
记住这个异步通知地址需要在应用那设置一下。
// 异步回调 public function notify() { if (request()->isPost()) { require ROOT_PATH.'extend/f2fpay/config/config.php'; $aop = new AopClient; $aop->alipayrsaPublicKey = $config['alipay_public_key']; $flag = $aop->rsaCheckV1($_POST, null, "RSA2"); if ($flag) { //异步SIGN验证成功, 可以进行下一步动作。例如验证订单金额 然后完成订单。之类的。。 //需要验证的就是 订单号 与 订单金额是否一致,验证成功 就可以对数据库中的订单进行操作了。 //TRADE_SUCCESS 对于当面付来说,已经到账了。详情可以看这里 https://www.cnblogs.com/tdalcn/p/5956690.html if ($_POST['trade_status'] === "TRADE_SUCCESS") { //订单处理模板 $res = Db::name('order') ->where('pay_id', $_POST['out_trade_no']) ->where('money', $_POST['total_amount']) ->where('status', 0) ->find(); if($res){ Db::name('order') ->where('id',$res['id']) ->update([ 'status' => 1, 'buyer_logon_id' => $_POST['buyer_logon_id'], 'pay_time' => $_POST['gmt_payment'], 'pay_no' => $_POST['trade_no'] ]); Db::name('user') ->where('uid',$res['uid']) ->setInc('integral', floatval($_POST['total_amount']) * 1000); } } } echo 'success'; //接口必须返回success 不然阿里会一直发送校验验证。 } }轮询
其中如果需要页面支付成功后同步跳转,则需要添加轮询,由于当面付是没有同步通知这个功能,所以需要用到轮询,并且这个方法也是在当面付的文档中所提及到的。
以下代码摘自Bty付费版
public function query() { if (input('post.no')) { $out_trade_no = input('post.no'); $queryContentBuilder = new AlipayTradeQueryContentBuilder(); $queryContentBuilder->setOutTradeNo($out_trade_no); $queryResponse = new AlipayTradeService($this->alipay_config); $queryResult = $queryResponse->queryTradeResult($queryContentBuilder); $res['status'] = $queryResult->getTradeStatus(); $res['buyer'] = isset($queryResult->getResponse()->buyer_logon_id) ? $queryResult->getResponse()->buyer_logon_id : ''; $res['amount'] = $queryResult->getResponse()->buyer_pay_amount; if ($res['status'] == 'SUCCESS') { $this->paySuccess('', $out_trade_no); } exit(json_encode($res)); } else { $this->error('非法请求'); } }由于我们对接的并不是类似商城一般的系统,所以暂时用不到类似退款这些的复杂操作。
当面付的基础对接就到此结束。
完结撒花!
发表评论