小程序支付
优质
小牛编辑
143浏览
2023-12-01
说明
支付宝小程序支付交易SDK。
官方文档：https://opendocs.alipay.com/open/204/105465/
类
请求参数类
APP支付参数
类名：\Yurun\PaySDK\AlipayApp\MiniApp\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\MiniApp\Params\Pay\BusinessParams | 业务请求参数 参考https://docs.open.alipay.com/204/105465/ |
| $_syncResponseName | string | 支付宝返回的json中xxx_response的名字 |
| $_method | string | 接口请求方法 |
| $_isSyncVerify | boolean | 是否同步返回验证 |
业务请求参数
类名：\Yurun\PaySDK\AlipayApp\MiniApp\Params\Pay\BusinessParams
属性
| 名称 | 类型 | 说明 |
|---|---|---|
| $body | string | 订单描述 |
| $subject | string | 订单标题 |
| $buyer_id | string | 买家的支付宝唯一用户号（2088开头的16位纯数字） 特殊可选 |
| $out_trade_no | string | 商户订单号，64个字符以内、可包含字母、数字、下划线；需保证在商户端不重复 |
| $seller_id | string | 卖家支付宝用户ID。 如果该值为空，则默认为商户签约账号对应的支付宝用户ID |
| $timeout_express | string | 该笔订单允许的最晚付款时间，逾期将关闭交易。取值范围：1m～15d。m-分钟，h-小时，d-天，1c-当天（1c-当天的情况下，无论交易何时创建，都在0点关闭）。 该参数数值不接受小数点， 如 1.5h，可转换为 90m。 该参数在请求到支付宝时开始计时。 |
| $total_amount | double | 订单总金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000] |
| $discountable_amount | double | 可打折金额. 参与优惠计算的金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000] 如果该值未传入，但传入了【订单总金额】，【不可打折金额】则该值默认为【订单总金额】-【不可打折金额】 |
| $product_code | string | 销售产品码。 如果签约的是当面付快捷版，则传OFFLINE_PAYMENT; 其它支付宝当面付产品传FACE_TO_FACE_PAYMENT； 不传默认使用FACE_TO_FACE_PAYMENT； |
| $extend_params | \Yurun\PaySDK\AlipayApp\MiniApp\Params\Pay\ExtendParams | 业务扩展参数，详见业务扩展参数说明 |
| $operator_id | string | 商户操作员编号 |
| $store_id | string | 商户门店编号。该参数用于请求参数中以区分各门店，非必传项。 |
| $terminal_id | string | 商户机具终端编号 |
| $settle_info | array | 描述结算信息，json格式，详见结算参数说明 |
| $logistics_detail | array | 物流信息 |
| $business_params | array | 商户传入业务信息，具体值要和支付宝约定，应用于安全，营销等参数直传场景，格式为json格式 |
| $receiver_address_info | array | 收货人及地址信息 |
业务扩展参数
类名：\Yurun\PaySDK\AlipayApp\MiniApp\Params\Pay\ExtendParams
属性
| 名称 | 类型 | 说明 |
|---|---|---|
| $sys_service_provider_id | string | 系统商编号，该参数作为系统商返佣数据提取的依据，请填写系统商签约协议的PID |
| $card_type | string | 卡类型 |
简单使用
支付
// SDK实例化，传入公共配置
$pay = new \Yurun\PaySDK\AlipayApp\SDK($params);
// 支付接口
$request = new \Yurun\PaySDK\AlipayApp\MiniApp\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 = 9000000; // 价格
$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/miniapp_pay.php