电脑网站支付
优质
小牛编辑
135浏览
2023-12-01
说明
支付宝电脑网站支付交易SDK。
官方文档：https://docs.open.alipay.com/270/105900/
类
请求参数类
电脑网站支付参数
类名：\Yurun\PaySDK\AlipayApp\Page\Params\Pay\Request
属性
| 名称 | 类型 | 说明 |
|---|---|---|
| $method | string | 接口名称 |
| $return_url | string | 同步返回地址，HTTP/HTTPS开头字符串 |
| $notify_url | string | 支付宝服务器主动通知商户服务器里指定的页面http/https路径。 |
| $businessParams | \Yurun\PaySDK\AlipayApp\Page\Params\Pay\BusinessParams | 业务请求参数 参考https://docs.open.alipay.com/270/alipay.trade.page.pay |
| $_syncResponseName | string | 支付宝返回的json中xxx_response的名字 |
| $_method | string | 接口请求方法 |
| $_isSyncVerify | boolean | 是否同步返回验证 |
业务请求参数
类名：\Yurun\PaySDK\AlipayApp\Page\Params\Pay\BusinessParams
属性
| 名称 | 类型 | 说明 |
|---|---|---|
| $out_trade_no | string | 商户订单号，64个字符以内、可包含字母、数字、下划线；需保证在商户端不重复 |
| $product_code | string | 销售产品码，与支付宝签约的产品码名称。 注：目前仅支持FAST_INSTANT_TRADE_PAY |
| $total_amount | double | 订单总金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000] |
| $subject | string | 订单标题 |
| $body | string | 订单描述 |
| $goods_detail | \Yurun\PaySDK\AlipayApp\Page\Params\GoodsDetail | 订单包含的商品列表信息，Json格式： {"show_url":"https://或http://打头的商品的展示地址"} ，在支付时，可点击商品名称跳转到该地址 |
| $passback_params | string | 公用回传参数，如果请求时传递了该参数，则返回给商户时会回传该参数。支付宝只会在异步通知时将该参数原样返回。本参数必须进行UrlEncode之后才可以发送给支付宝 |
| $extend_params | \Yurun\PaySDK\AlipayApp\Page\Params\Pay\ExtendParams | 业务扩展参数，详见业务扩展参数说明 |
| $goods_type | int | 商品主类型：0—虚拟类商品，1—实物类商品（默认） |
| $timeout_express | string | 该笔订单允许的最晚付款时间，逾期将关闭交易。取值范围：1m～15d。m-分钟，h-小时，d-天，1c-当天（1c-当天的情况下，无论交易何时创建，都在0点关闭）。 该参数数值不接受小数点， 如 1.5h，可转换为 90m。 该参数在请求到支付宝时开始计时。 |
| $enable_pay_channels | string | 可用渠道，用户只能在指定渠道范围内支付 当有多个渠道时用“,”分隔 注：与disable_pay_channels互斥 |
| $disable_pay_channels | string | 禁用渠道，用户不可用指定渠道支付 当有多个渠道时用“,”分隔 注：与enable_pay_channels互斥 |
| $auth_token | string | 获取用户授权信息，可实现如免登功能。获取方法请查阅：用户信息授权 |
| $qr_pay_mode | int | PC扫码支付的方式，支持前置模式和跳转模式。 前置模式是将二维码前置到商户的订单确认页的模式。需要商户在自己的页面中以iframe方式请求支付宝页面。具体分为以下几种： 0：订单码-简约前置模式，对应iframe宽度不能小于600px，高度不能小于300px； 1：订单码-前置模式，对应iframe宽度不能小于300px，高度不能小于600px； 3：订单码-迷你前置模式，对应iframe宽度不能小于75px，高度不能小于75px； 4：订单码-可定义宽度的嵌入式二维码，商户可根据需要设定二维码的大小。 跳转模式下，用户的扫码界面是由支付宝生成的，不在商户的域名下。 2：订单码-跳转模式 |
| $qrcode_width | int | 商户自定义二维码宽度 注：qr_pay_mode=4时该参数生效 |
商品列表信息
类名：\Yurun\PaySDK\AlipayApp\Page\Params\GoodsDetail
属性
| 名称 | 类型 | 说明 |
|---|---|---|
| $show_url | string | 在支付时，可点击商品名称跳转到该地址 |
业务扩展参数
类名：\Yurun\PaySDK\AlipayApp\Page\Params\Pay\ExtendParams
属性
| 名称 | 类型 | 说明 |
|---|---|---|
| $sys_service_provider_id | string | 系统商编号，该参数作为系统商返佣数据提取的依据，请填写系统商签约协议的PID |
| $hb_fq_num | string | 花呗分期数（目前仅支持3、6、12） |
| $hb_fq_seller_percent | string | 卖家承担收费比例，商家承担手续费传入100，用户承担手续费传入0，仅支持传入100、0两种，其他比例暂不支持 |
简单使用
支付
// SDK实例化，传入公共配置
$pay = new \Yurun\PaySDK\AlipayApp\SDK($params);
// 支付接口
$request = new \Yurun\PaySDK\AlipayApp\Page\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 = 9000000; // 价格
$request->businessParams->subject = '小米手机9黑色陶瓷尊享版'; // 商品标题
// 跳转到支付页面
// $pay->redirectExecute($request);
// 获取跳转url
$pay->prepareExecute($request, $url);
var_dump($url);
详见：test/AlipayApp/page_pay.php