支付宝 V3 支付

V3 支持以下支付接口（经 pay() 显式传入对应 V3 Shortcut 的插件数组使用）：

method	说明	参数	返回值
pos	付款码支付（被扫码）	array $order	Collection
scan	扫码支付（预创建，主动扫）	array $order	Collection

TIP

示例（以扫码支付为例）：

use Yansongda\Pay\Shortcut\Alipay\V3\ScanShortcut;

$result = Pay::alipay()->pay((new ScanShortcut())->getPlugins([]), $order);

付款码支付（刷卡支付，被扫码）

例子

Pay::config($this->config);

$result = Pay::alipay()->pos([
    'out_trade_no' => ''.time(),
    'auth_code' => '284776044441477959',
    'total_amount' => '0.01',
    'subject' => 'yansongda 测试 - 01',
]);

订单配置参数

所有订单配置参数和官方 V3 接口请求体无任何差别（snake_case 直传，无需 method/biz_content 等包装），例如 out_trade_no、auth_code、total_amount、subject 等，请参考官方 PHP SDK 的 AlipayTradePayModel 查看完整参数。

notify_url 支持两级配置：订单参数传入优先，否则回落租户配置的 notify_url。

扫码支付（预创建，主动扫）

例子

Pay::config($this->config);

$result = Pay::alipay()->scan([
    'out_trade_no' => ''.time(),
    'total_amount' => '0.01',
    'subject' => 'yansongda 测试 - 01',
]);

return $result->get('qr_code'); // 二维码 url

订单配置参数

所有订单配置参数和官方 V3 接口请求体无任何差别（snake_case 直传），例如 out_trade_no、total_amount、subject 等，请参考官方 PHP SDK 的 AlipayTradePrecreateModel 查看完整参数。

notify_url 支持两级配置：订单参数传入优先，否则回落租户配置的 notify_url。

返回值

以上接口均返回 Collection，字段与支付宝官方 V3 接口响应体一致（无包裹层）。例如付款码支付成功返回 trade_no 等字段，扫码支付返回 qr_code 字段。

用户自行实现第三方授权（服务模式）时，可通过订单参数 '_app_auth_token' => 'xxx' 或租户配置 app_auth_token 传递授权 token，SDK 会自动放入 alipay-app-auth-token 请求头并参与签名。