APP支付

优质

小牛编辑

170浏览

2023-12-01

说明

支付宝手机APP支付交易SDK。

返回一个可以直接给Android/iOS客户端请求的URL。

官方文档：https://docs.open.alipay.com/204/105465/

类

请求参数类

APP支付参数

类名：\Yurun\PaySDK\AlipayApp\App\Params\Pay\Request

属性

名称	类型	说明
$method	string	接口名称
$notify_url	string	支付宝服务器主动通知商户服务器里指定的页面http/https路径。
$businessParams	\Yurun\PaySDK\AlipayApp\App\Params\Pay\BusinessParams	业务请求参数参考https://docs.open.alipay.com/204/105465/
$_syncResponseName	string	支付宝返回的json中xxx_response的名字
$_method	string	接口请求方法
$_isSyncVerify	boolean	是否同步返回验证

业务请求参数

类名：\Yurun\PaySDK\AlipayApp\App\Params\Pay\BusinessParams

属性

名称	类型	说明
$body	string	订单描述
$subject	string	订单标题
$out_trade_no	string	商户订单号，64个字符以内、可包含字母、数字、下划线；需保证在商户端不重复
$timeout_express	string	该笔订单允许的最晚付款时间，逾期将关闭交易。取值范围：1m～15d。m-分钟，h-小时，d-天，1c-当天（1c-当天的情况下，无论交易何时创建，都在0点关闭）。该参数数值不接受小数点，如 1.5h，可转换为 90m。该参数在请求到支付宝时开始计时。
$total_amount	double	订单总金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]
$product_code	string	销售产品码，与支付宝签约的产品码名称。注：目前仅支持QUICK_WAP_WAY
$goods_type	int	商品主类型：0—虚拟类商品，1—实物类商品（默认）
$passback_params	string	公用回传参数，如果请求时传递了该参数，则返回给商户时会回传该参数。支付宝只会在异步通知时将该参数原样返回。本参数必须进行UrlEncode之后才可以发送给支付宝
$promo_params	string	优惠参数注：仅与支付宝协商后可用
$extend_params	\Yurun\PaySDK\AlipayApp\App\Params\Pay\ExtendParams	业务扩展参数，详见业务扩展参数说明
$enable_pay_channels	string	可用渠道，用户只能在指定渠道范围内支付当有多个渠道时用“,”分隔注：与disable_pay_channels互斥
$disable_pay_channels	string	禁用渠道，用户不可用指定渠道支付当有多个渠道时用“,”分隔注：与enable_pay_channels互斥
$store_id	string	商户门店编号。该参数用于请求参数中以区分各门店，非必传项。
$ext_user_info	\Yurun\PaySDK\AlipayApp\App\ExtUserInfo	外部指定买家

业务扩展参数

类名：\Yurun\PaySDK\AlipayApp\App\Params\Pay\ExtendParams

属性

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

外部指定买家

类名：\Yurun\PaySDK\AlipayApp\App\ExtUserInfo

属性

名称	类型	说明
$name	string	证件姓名 need_check_info=T时该参数才有效
$mobile	string	手机号该参数暂不校验
$cert_type	string	身份证：IDENTITY_CARD、护照：PASSPORT、军官证：OFFICER_CARD、士兵证：SOLDIER_CARD、户口本：HOKOU等。如有其它类型需要支持，请与蚂蚁金服工作人员联系。注： need_check_info=T时该参数才有效
$cert_no	string	证件号 need_check_info=T时该参数才有效
$min_age	int	允许的最小买家年龄，买家年龄必须大于等于所传数值 1. need_check_info=T时该参数才有效 2. min_age为整数，必须大于等于0
$fix_buyer	string	是否强制校验付款人身份信息 T:强制校验，F：不强制
$need_check_info	string	是否强制校验身份信息 T:强制校验，F：不强制

简单使用

支付

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

// 支付接口
$request = new \Yurun\PaySDK\AlipayApp\App\Params\Pay\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黑色陶瓷尊享版'; // 商品标题

// 处理
$pay->prepareExecute($request, $url, $data);

// echo $url; // 输出的是可以让app直接请求的url
echo http_build_query($data); // 输出的是可以让app直接使用的参数

详见：test/AlipayApp/app_pay.php