介绍
这篇文章主要为大家详细介绍了支付宝在线支付接口接入开发教程
支付流程
图片来源：https://opendocs.alipay.com/open/270/105899?pathHash=d57664bf
证书设置
接入流程
登录支付宝
https://open.alipay.com/develop/manage
创建应用
设置页面
接口加签
下载支付宝密钥工具
生成CSR文件
打开生成的文件
本地文件目录
支付宝页面下一步
上传刚刚生成的CSR文件
填写配置
注意：
app_secret_cert为“应用私钥RSA2048-敏感数据，请妥善保管.txt”文件的内容
产品绑定
支付
安装依赖
代码语言：javascript复制composer require yansongda/pay ^3.0.0
说明：以下以支付宝沙箱环境为环境进行文档编写，若有问题，请及时反馈哦！
配置文件
假设有以下配置文件 config/payment.php
<?php
/**
* @desc 支付配置文件
* @author Tinywan(ShaoBo Wan)
* @date 2023/11/11 20:15
*/
return [
'alipay' => [
'default' => [
// 必填-支付宝分配的 app_id
'app_id' => '20160909004708941',
// 必填-应用私钥 字符串或路径
'app_secret_cert' => 'MIIEpAIBAAKCxxxxxxxxxxxxxxP4r3m4OUmD/ XDgCg==',
// 必填-应用公钥证书 路径
'app_public_cert_path' => base_path().'/payment/appCertPublicKey_2016090900470841.crt',
// 必填-支付宝公钥证书 路径
'alipay_public_cert_path' => base_path().'/payment/alipayCertPublicKey_RSA2.crt',
// 必填-支付宝根证书 路径
'alipay_root_cert_path' => base_path().'/payment/alipayRootCert.crt',
// 选填-同步回调地址
'return_url' => 'https://webman.tinywan.cn/payment/alipay-return',
// 选填-异步回调地址
'notify_url' => 'https://webman.tinywan.cn/payment/alipay-notify',
// 选填-服务商模式下的服务商 id，当 mode 为 Pay::MODE_SERVICE 时使用该参数
'service_provider_id' => '',
// 选填-默认为正常模式。可选为：MODE_NORMAL, MODE_SANDBOX, MODE_SERVICE
'mode' => YansongdaPayPay::MODE_SANDBOX,
]
],
'logger' => [
'enable' => false,
'file' => runtime_path().'/logs/alipay.log',
'level' => 'debug', // 建议生产环境等级调整为 info，开发环境为 debug
'type' => 'single', // optional, 可选 daily.
'max_file' => 30, // optional, 当 type 为 daily 时有效，默认 30 天
],
'http' => [ // optional
'timeout' => 5.0,
'connect_timeout' => 5.0,
// 更多配置项请参考 [Guzzle](https://guzzle-cn.readthedocs.io/zh_CN/latest/request-options.html)
],
'_force' => true,
];
代码语言：javascript复制注意：证书目录没有规定，以上示例是放在的框架的
payment目录下
├── payment
│ ├── alipayCertPublicKey_RSA2.crt
│ ├── alipayRootCert.crt
│ └── appCertPublicKey_2016090900470841.crt
使用
初始化
直接调用 config 方法初始化
// 获取配置文件 config/payment.php
$config = Config::get('payment');
Pay::config($config);
注意：如果是支付宝沙箱模式，一定要记得开启配置文件
'mode' => YansongdaPayPay::MODE_SANDBOX,，该选项默认为默认为正常模式。
支付（电脑网站支付）
官方文档地址：https://opendocs.alipay.com/open/270/105898?pathHash=b3b2b667
代码语言：javascript复制use supportRequest;
use WebmanConfig;
use YansongdaPayPay;
/**
* @param Request $request
* @return string
*/
public function payment(Request $request)
{
// 1. 获取配置文件 config/payment.php
$config = Config::get('payment');
// 2. 初始化配置
Pay::config($config);
// 3. 网页支付
$order = [
'out_trade_no' => time(),
'total_amount' => '8888.88',
'subject' => 'webman payment',
'_method' => 'get' // 使用get方式跳转
];
return Pay::alipay()->web($order)->getBody()->getContents();
}
回调
「异步回调」
代码语言：javascript复制use supportRequest;
use WebmanConfig;
use YansongdaPayPay;
/**
* @desc:『支付宝』异步通知
* @param Request $request
* @return Response
*/
public function alipayNotify(Request $request): Response
{
// 1. 获取配置文件 config/payment.php
$config = Config::get('payment');
// 2. 初始化配置
Pay::config($config);
// 3. 支付宝回调处理
$result = Pay::alipay()->callback($request->post());
// ===================================================================================================
// 请自行对 trade_status 进行判断及其它逻辑进行判断，只有交易通知状态为 TRADE_SUCCESS 或 TRADE_FINISHED 时，支付宝才会认定为买家付款成功。
// 1、商户需要验证该通知数据中的out_trade_no是否为商户系统中创建的订单号；
// 2、判断total_amount是否确实为该订单的实际金额（即商户订单创建时的金额）；
// 3、校验通知中的seller_id（或者seller_email) 是否为out_trade_no这笔单据的对应的操作方；
// 4、验证app_id是否为该商户本身。
// 5、其它业务逻辑情况
// ===================================================================================================
// 5. 支付宝回调处理
return new Response(200, [], 'success');
}
注意：不能使用插件本身
return Pay::alipay()->success();响应支付宝回调，如果你用到中间件会出现中间件问题。所以响应支付宝需要使用webman的响应类supportResponse;
「同步回调」
代码语言：javascript复制use supportRequest;
use YansongdaPayPay;
/**
* @desc: 『支付宝』同步通知
* @param Request $request
* @author Tinywan(ShaoBo Wan)
*/
public function alipayReturn(Request $request)
{
Log::info('『支付宝』同步通知'.json_encode($request->get()));
return 'success';
}
日志
所有相关支付日志多存储在 项目目录/runtime/logs/pay.log文件中
