手机网站支付

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

说明

支付宝手机网站支付交易SDK。

官方文档:https://docs.open.alipay.com/203/105287/

请求参数类

手机网站支付参数

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

属性
名称类型说明
$methodstring接口名称
$return_urlstring同步返回地址,HTTP/HTTPS开头字符串
$notify_urlstring支付宝服务器主动通知商户服务器里指定的页面http/https路径。
$businessParams\Yurun\PaySDK\AlipayApp\Wap\Params\Pay\BusinessParams业务请求参数
参考https://docs.open.alipay.com/203/107090/
$_syncResponseNamestring支付宝返回的json中xxx_response的名字
$_methodstring接口请求方法
$_isSyncVerifyboolean是否同步返回验证

业务请求参数

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

属性
名称类型说明
$out_trade_nostring商户订单号,64个字符以内、可包含字母、数字、下划线;需保证在商户端不重复
$product_codestring销售产品码,与支付宝签约的产品码名称。 注:目前仅支持QUICK_WAP_WAY
$total_amountdouble订单总金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]
$subjectstring订单标题
$bodystring订单描述
$passback_paramsstring公用回传参数,如果请求时传递了该参数,则返回给商户时会回传该参数。支付宝只会在异步通知时将该参数原样返回。本参数必须进行UrlEncode之后才可以发送给支付宝
$extend_params\Yurun\PaySDK\AlipayApp\Wap\Params\Pay\ExtendParams业务扩展参数,详见业务扩展参数说明
$goods_typeint商品主类型:0—虚拟类商品,1—实物类商品(默认)
$timeout_expressstring该笔订单允许的最晚付款时间,逾期将关闭交易。取值范围:1m~15d。m-分钟,h-小时,d-天,1c-当天(1c-当天的情况下,无论交易何时创建,都在0点关闭)。 该参数数值不接受小数点, 如 1.5h,可转换为 90m。
该参数在请求到支付宝时开始计时。
$time_expirestring绝对超时时间,格式为yyyy-MM-dd HH:mm。 注:1)以支付宝系统时间为准;2)如果和timeout_express参数同时传入,以time_expire为准。
$enable_pay_channelsstring可用渠道,用户只能在指定渠道范围内支付
当有多个渠道时用“,”分隔
注:与disable_pay_channels互斥
$disable_pay_channelsstring禁用渠道,用户不可用指定渠道支付
当有多个渠道时用“,”分隔
注:与enable_pay_channels互斥
$auth_tokenstring获取用户授权信息,可实现如免登功能。获取方法请查阅:用户信息授权
$store_idstring商户门店编号。该参数用于请求参数中以区分各门店,非必传项。
$quit_urlstring添加该参数后在h5支付收银台会出现返回按钮,可用于用户付款中途退出并返回到该参数指定的商户网站地址。
注:该参数对支付宝钱包标准收银台下的跳转不生效。
$promo_paramsstring优惠参数
注:仅与支付宝协商后可用

业务扩展参数

类名:\Yurun\PaySDK\AlipayApp\Wap\Params\Pay\ExtendParams

属性
名称类型说明
$sys_service_provider_idstring系统商编号,该参数作为系统商返佣数据提取的依据,请填写系统商签约协议的PID
$needBuyerRealnamedstring是否发起实名校验
T:发起
F:不发起
$TRANS_MEMOstring账务备注
注:该字段显示在离线账单的账务备注中
$hb_fq_numstring花呗分期数(目前仅支持3、6、12)
$hb_fq_seller_percentstring卖家承担收费比例,商家承担手续费传入100,用户承担手续费传入0,仅支持传入100、0两种,其他比例暂不支持

简单使用

支付

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

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

// 跳转到支付页面
// $pay->redirectExecute($request);

// 获取跳转url
$pay->prepareExecute($request, $url);
var_dump($url);

详见:test/AlipayApp/wap_pay.php