当面付
优质
小牛编辑
204浏览
2023-12-01
说明
支付宝当面付交易SDK。
官方文档:https://docs.open.alipay.com/194/105203/
类
请求参数类
面对面支付-条码支付参数
类名:\Yurun\PaySDK\AlipayApp\FTF\Params\Pay\Request
属性
名称 | 类型 | 说明 |
---|---|---|
$method | string | 接口名称 |
$notify_url | string | 支付宝服务器主动通知商户服务器里指定的页面http/https路径。 |
$app_auth_token | string | 详见: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 |
$_syncResponseName | string | 支付宝返回的json中xxx_response的名字 |
$_method | string | 接口请求方法 |
$_isSyncVerify | boolean | 是否同步返回验证 |
面对面支付-扫码支付参数
类名:\Yurun\PaySDK\AlipayApp\FTF\Params\QR\Request
属性
名称 | 类型 | 说明 |
---|---|---|
$method | string | 接口名称 |
$notify_url | string | 支付宝服务器主动通知商户服务器里指定的页面http/https路径。 |
$app_auth_token | string | 详见: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 |
$_syncResponseName | string | 支付宝返回的json中xxx_response的名字 |
$_method | string | 接口请求方法 |
$_isSyncVerify | boolean | 是否同步返回验证 |
业务请求参数-条码支付
类名:\Yurun\PaySDK\AlipayApp\FTF\Params\Pay\BusinessParams
属性
名称 | 类型 | 说明 |
---|---|---|
$out_trade_no | string | 商户订单号,64个字符以内、可包含字母、数字、下划线;需保证在商户端不重复 |
$scene | string | 支付场景 条码支付,取值:bar_code 声波支付,取值:wave_code |
$auth_code | string | 支付授权码,25~30开头的长度为16~24位的数字,实际字符串长度以开发者获取的付款码长度为准 |
$product_code | string | 销售产品码,与支付宝签约的产品码名称。 |
$total_amount | double | 订单总金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000] |
$discountable_amount | double | 参与优惠计算的金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]。 如果该值未传入,但传入了【订单总金额】和【不可打折金额】,则该值默认为【订单总金额】-【不可打折金额】 |
$subject | string | 订单标题 |
$buyer_id | string | 买家的支付宝用户id,如果为空,会从传入了码值信息中获取买家ID |
$seller_id | string | 如果该值为空,则默认为商户签约账号对应的支付宝用户ID |
$body | string | 订单描述 |
$goods_detail | array<\Yurun\PaySDK\AlipayApp\FTF\Params\GoodsDetail> | 订单包含的商品列表信息 |
$extend_params | \Yurun\PaySDK\AlipayApp\FTF\Params\ExtendParams | 业务扩展参数,详见业务扩展参数说明 |
$operator_id | string | 商户操作员编号 |
$store_id | string | 商户门店编号 |
$terminal_id | string | 商户机具终端编号 |
$timeout_express | string | 该笔订单允许的最晚付款时间,逾期将关闭交易。取值范围:1m~15d。m-分钟,h-小时,d-天,1c-当天(1c-当天的情况下,无论交易何时创建,都在0点关闭)。 该参数数值不接受小数点, 如 1.5h,可转换为 90m |
业务请求参数-扫码支付
类名:\Yurun\PaySDK\AlipayApp\FTF\Params\QR\BusinessParams
属性
名称 | 类型 | 说明 |
---|---|---|
$out_trade_no | string | 商户订单号,64个字符以内、可包含字母、数字、下划线;需保证在商户端不重复 |
$total_amount | double | 订单总金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000] |
$discountable_amount | double | 参与优惠计算的金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]。 如果该值未传入,但传入了【订单总金额】和【不可打折金额】,则该值默认为【订单总金额】-【不可打折金额】 |
$subject | string | 订单标题 |
$seller_id | string | 如果该值为空,则默认为商户签约账号对应的支付宝用户ID |
$body | string | 订单描述 |
$goods_detail | array<\Yurun\PaySDK\AlipayApp\FTF\Params\GoodsDetail> | 订单包含的商品列表信息 |
$extend_params | \Yurun\PaySDK\AlipayApp\FTF\Params\ExtendParams | 业务扩展参数,详见业务扩展参数说明 |
$operator_id | string | 商户操作员编号 |
$store_id | string | 商户门店编号 |
$terminal_id | string | 商户机具终端编号 |
$timeout_express | string | 该笔订单允许的最晚付款时间,逾期将关闭交易。取值范围:1m~15d。m-分钟,h-小时,d-天,1c-当天(1c-当天的情况下,无论交易何时创建,都在0点关闭)。 该参数数值不接受小数点, 如 1.5h,可转换为 90m |
商品列表信息
类名:\Yurun\PaySDK\AlipayApp\FTF\Params\GoodsDetail
属性
名称 | 类型 | 说明 |
---|---|---|
$goods_id | string | 商品的编号 |
$goods_name | string | 商品名称 |
$quantity | int | 商品数量 |
$price | double | 商品单价,单位为元 |
$goods_category | string | 商品类目 |
$body | string | 商品描述信息 |
$show_url | string | 商品的展示地址 |
业务扩展参数
类名:\Yurun\PaySDK\AlipayApp\FTF\Params\ExtendParams
属性
名称 | 类型 | 说明 |
---|---|---|
$sys_service_provider_id | string | 系统商编号,该参数作为系统商返佣数据提取的依据,请填写系统商签约协议的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