需安装Yansongda/pay SDK、配置支付参数、封装PayService类、实现回调验签与状态更新、处理前端跳转与轮询。
如果您在ThinkPHP项目中需要接入微信或支付宝支付功能，但尚未完成SDK集成与配置，则很可能是由于依赖未安装、配置缺失或调用方式不正确所致。以下是完成Yansongda支付集成的多种可行路径：
一、通过Composer安装Yansongda/pay SDK
该方法为标准且推荐的引入方式，确保版本兼容性与自动依赖管理。Yansongda/pay支持ThinkPHP 5.x与6.x，需使用对应版本约束。
1、进入项目根目录，执行安装命令：composer require yansongda/pay:^4.0
2、若使用ThinkPHP 6.x且遇到容器绑定问题，补充安装适配器：composer require illuminate/container
立即学习“PHP免费学习笔记（深入）”；
3、确认vendor/yansongda/pay目录已生成，并检查其src/Pay.php可正常加载。
二、配置支付参数至框架环境
参数必须严格区分环境存放，禁止硬编码于业务逻辑中；ThinkPHP 6建议统一写入config/pay.php，ThinkPHP 5可置于config.php或.env中解析后注入。
1、创建config/pay.php文件，内容包含微信与支付宝两套独立配置数组，每套均含default键作为默认驱动标识。
2、微信配置中必须提供mch_id、mch_secret_key（v3密钥）、mch_public_cert_path（公钥证书路径）及notify_url，其中证书路径需为realpath()绝对路径。
3、支付宝配置中必须设置app_id、ali_public_key（支付宝公钥）、private_key（应用私钥）及notify_url，签名类型固定为RSA2。
三、封装支付服务类实现解耦调用
避免在控制器中直接实例化Pay对象，应通过服务层统一管理配置与异常，提升可测试性与复用性。
1、在app/common/service/下新建PayService.php，构造函数中读取think\facade\Config::get('pay.wechat')或'pay.alipay'。
2、定义createWapOrder($orderData)方法：对微信调用Pay::wechat($config)->wap($orderData)，对支付宝调用Pay::alipay($config)->wap($orderData)。
3、返回结构统一为关联数组，包含redirect（跳转URL）、qrcode（扫码内容）或jsapi_parameters（JSAPI签名参数），由上层决定渲染方式。
四、实现支付回调接口并完成验签与状态更新
异步通知是支付闭环的关键环节，必须验证签名、校验订单存在性、比对金额一致性，并原子化更新订单状态，防止重复处理。
1、定义路由POST /api/pay/notify/wechat与POST /api/pay/notify/alipay，指向同一控制器方法或分设两个方法。
2、在方法内调用$pay->verify()->toArray()获取原始通知数据，捕获Yansongda\Pay\Exception\InvalidSignException异常。
3、从$data['out_trade_no']查库确认订单未支付且金额匹配，执行Db::name('order')->where('order_no', $data['out_trade_no'])->update(['pay_status' => 1])。
4、成功处理后立即返回$pay->success()（微信）或'success'字符串（支付宝），否则返回空响应或'fail'。
五、处理前端支付结果跳转与用户提示
同步返回页面（return_url）仅作用户体验展示，不可用于状态变更，其数据未经签名保护，必须以异步通知为准。
1、支付宝return_url接收request参数，需调用Pay::alipay($config)->verifyReturn($_GET)进行轻量验签。
2、微信return_url（如H5支付）无签名参数，仅作跳转中转，应重定向至前端订单详情页，由页面AJAX轮询订单状态接口确认最终结果。
3、所有跳转页须携带out_trade_no，前端通过该字段请求/api/order/status?sn=xxx获取实时支付状态并渲染UI。
