支付宝当面付对接
当面付顾名思义，面对面付款，帮助商家在线下消费场景下实现快速收款；当面付产品支持条码支付和扫码支付两种付款方式。 我们这里对接的就是扫码支付 扫码支付，指用户打开支付宝钱包中的“扫一扫”功能，扫描商家展示在某收银场景下的二维码并进行支付的模式。该模式适用于线下实体店支付、面对面支付等场景。业务流程如下图所示：
由于当面付的签约非常简单，允许个体工商户/个人商户签约。所以该方式也被大量用于线上的扫码支付，由于该方式违反了支付宝的相关条款，有一定风险，咱作为技术交流，暂且先抛开这个问题。
作为技术对接，即使你没有签约当面付产品，也是可以进行开发的。 支付能力直接涉及到交易与资金，为了方便开放者调试支付能力，开放平台已经准备好沙箱环境，包括沙箱环境账号和沙箱版支付宝钱包，这样开发者就可以在沙箱环境调试了。点击了解如何接入沙箱并接入沙箱环境。
所以我这边开发使用的是沙箱环境，毕竟里面好多钱，随便用。
首先先下载相应的开发语言的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('非法请求');
}
}由于我们对接的并不是类似商城一般的系统，所以暂时用不到类似退款这些的复杂操作。
当面付的基础对接就到此结束。 完结撒花！
本文参与 腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。
原始发表：2020-04-04，如有侵权请联系 cloudcommunity@tencent.com 删除
评论
登录后参与评论
推荐阅读
相关产品与服务
云支付
云支付（Cloud Pay，CPay）为您提供开放、可靠的聚合收款技术服务和商户管理功能。云支付支持刷卡支付、扫码支付、一码多付多种支付方式。服务商也可使用云支付提供的 SDK 和 HTTPS 接口，将云支付集成进自己的系统中，为商户提供的个性化解决方案。
腾讯云开发者
