当面付

优质
小牛编辑
204浏览
2023-12-01

说明

支付宝当面付交易SDK。

官方文档:https://docs.open.alipay.com/194/105203/

请求参数类

面对面支付-条码支付参数

类名:\Yurun\PaySDK\AlipayApp\FTF\Params\Pay\Request

属性
名称类型说明
$methodstring接口名称
$notify_urlstring支付宝服务器主动通知商户服务器里指定的页面http/https路径。
$app_auth_tokenstring详见:https://docs.open.alipay.com/common/105193
$businessParams\Yurun\PaySDK\AlipayApp\FTF\Params\Pay\BusinessParams业务请求参数
参考https://docs.open.alipay.com/api_1/alipay.trade.pay
$_syncResponseNamestring支付宝返回的json中xxx_response的名字
$_methodstring接口请求方法
$_isSyncVerifyboolean是否同步返回验证

面对面支付-扫码支付参数

类名:\Yurun\PaySDK\AlipayApp\FTF\Params\QR\Request

属性
名称类型说明
$methodstring接口名称
$notify_urlstring支付宝服务器主动通知商户服务器里指定的页面http/https路径。
$app_auth_tokenstring详见:https://docs.open.alipay.com/common/105193
$businessParams\Yurun\PaySDK\AlipayApp\FTF\Params\QR\BusinessParams业务请求参数
参考https://docs.open.alipay.com/api_1/alipay.trade.precreate
$_syncResponseNamestring支付宝返回的json中xxx_response的名字
$_methodstring接口请求方法
$_isSyncVerifyboolean是否同步返回验证

业务请求参数-条码支付

类名:\Yurun\PaySDK\AlipayApp\FTF\Params\Pay\BusinessParams

属性
名称类型说明
$out_trade_nostring商户订单号,64个字符以内、可包含字母、数字、下划线;需保证在商户端不重复
$scenestring支付场景
条码支付,取值:bar_code
声波支付,取值:wave_code
$auth_codestring支付授权码,25~30开头的长度为16~24位的数字,实际字符串长度以开发者获取的付款码长度为准
$product_codestring销售产品码,与支付宝签约的产品码名称。
$total_amountdouble订单总金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]
$discountable_amountdouble参与优惠计算的金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]。
如果该值未传入,但传入了【订单总金额】和【不可打折金额】,则该值默认为【订单总金额】-【不可打折金额】
$subjectstring订单标题
$buyer_idstring买家的支付宝用户id,如果为空,会从传入了码值信息中获取买家ID
$seller_idstring如果该值为空,则默认为商户签约账号对应的支付宝用户ID
$bodystring订单描述
$goods_detailarray<\Yurun\PaySDK\AlipayApp\FTF\Params\GoodsDetail>订单包含的商品列表信息
$extend_params\Yurun\PaySDK\AlipayApp\FTF\Params\ExtendParams业务扩展参数,详见业务扩展参数说明
$operator_idstring商户操作员编号
$store_idstring商户门店编号
$terminal_idstring商户机具终端编号
$timeout_expressstring该笔订单允许的最晚付款时间,逾期将关闭交易。取值范围:1m~15d。m-分钟,h-小时,d-天,1c-当天(1c-当天的情况下,无论交易何时创建,都在0点关闭)。 该参数数值不接受小数点, 如 1.5h,可转换为 90m

业务请求参数-扫码支付

类名:\Yurun\PaySDK\AlipayApp\FTF\Params\QR\BusinessParams

属性
名称类型说明
$out_trade_nostring商户订单号,64个字符以内、可包含字母、数字、下划线;需保证在商户端不重复
$total_amountdouble订单总金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]
$discountable_amountdouble参与优惠计算的金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]。
如果该值未传入,但传入了【订单总金额】和【不可打折金额】,则该值默认为【订单总金额】-【不可打折金额】
$subjectstring订单标题
$seller_idstring如果该值为空,则默认为商户签约账号对应的支付宝用户ID
$bodystring订单描述
$goods_detailarray<\Yurun\PaySDK\AlipayApp\FTF\Params\GoodsDetail>订单包含的商品列表信息
$extend_params\Yurun\PaySDK\AlipayApp\FTF\Params\ExtendParams业务扩展参数,详见业务扩展参数说明
$operator_idstring商户操作员编号
$store_idstring商户门店编号
$terminal_idstring商户机具终端编号
$timeout_expressstring该笔订单允许的最晚付款时间,逾期将关闭交易。取值范围:1m~15d。m-分钟,h-小时,d-天,1c-当天(1c-当天的情况下,无论交易何时创建,都在0点关闭)。 该参数数值不接受小数点, 如 1.5h,可转换为 90m

商品列表信息

类名:\Yurun\PaySDK\AlipayApp\FTF\Params\GoodsDetail

属性
名称类型说明
$goods_idstring商品的编号
$goods_namestring商品名称
$quantityint商品数量
$pricedouble商品单价,单位为元
$goods_categorystring商品类目
$bodystring商品描述信息
$show_urlstring商品的展示地址

业务扩展参数

类名:\Yurun\PaySDK\AlipayApp\FTF\Params\ExtendParams

属性
名称类型说明
$sys_service_provider_idstring系统商编号,该参数作为系统商返佣数据提取的依据,请填写系统商签约协议的PID

简单使用

条码支付

商家使用扫码设备,扫描用户支付宝钱包上的条码/二维码,完成收款

// SDK实例化,传入公共配置
$pay = new \Yurun\PaySDK\AlipayApp\SDK($params);

// 支付接口
$request = new \Yurun\PaySDK\AlipayApp\FTF\Params\Pay\Request;
$request->notify_url = $GLOBALS['PAY_CONFIG']['notify_url']; // 支付后通知地址(作为支付成功回调,这个可靠)
$request->businessParams->scene = 'bar_code'; // 条码支付,取值:bar_code ;声波支付,取值:wave_code
$request->businessParams->auth_code = '287601589603060117'; // 为了方便测试用条码支付,点开付款码,查看那一串数字就是了。
$request->businessParams->out_trade_no = 'test' . mt_rand(10000000,99999999); // 商户订单号
$request->businessParams->total_amount = 0.01; // 价格
$request->businessParams->subject = '小米手机9黑色陶瓷尊享版'; // 商品标题

// 调用接口
$result = $pay->execute($request);

var_dump('result:', $result);

var_dump('success:', $pay->checkResult());

var_dump('error:', $pay->getError(), 'error_code:', $pay->getErrorCode());

详见:test/AlipayApp/ftf_pay.php

扫码支付

用户支付宝钱包上的扫一扫功能扫商户二维码,完成付款

// SDK实例化,传入公共配置
$pay = new \Yurun\PaySDK\AlipayApp\SDK($params);

// 支付接口
$request = new \Yurun\PaySDK\AlipayApp\FTF\Params\QR\Request;
$request->notify_url = $GLOBALS['PAY_CONFIG']['notify_url']; // 支付后通知地址(作为支付成功回调,这个可靠)
$request->businessParams->out_trade_no = 'test' . mt_rand(10000000,99999999); // 商户订单号
$request->businessParams->total_amount = 0.01; // 价格
$request->businessParams->subject = '小米手机9黑色陶瓷尊享版'; // 商品标题
// 调用接口
try{
    $data = $pay->execute($request);

    var_dump('result:', $data);

    var_dump('success:', $pay->checkResult());

    var_dump('error:', $pay->getError(), 'error_code:', $pay->getErrorCode());
}
catch(Exception $e){
    var_dump($pay->response->body);
}

执行完后,需要将$data['alipay_trade_precreate_response']['qr_code']数据生成二维码,提供给用户扫描支付。

详见:test/AlipayApp/ftf_qr.php