1. 概述
本指南将帮助您快速接入LakShine支付平台，完成从申请账号到正式上线的完整流程。
预计时间：整个接入流程约需3-7个工作日，其中技术对接可在1-2天内完成。
1.1 接入流程概览
- 申请商户账号 - 联系商务团队，提交申请材料
- 配置支付接口 - 管理员配置接口权限和渠道
- 技术对接 - 下载SDK，实现支付功能
- 测试上线 - 完成测试，正式上线
2. 接入前准备
2.1 技术环境要求
| 项目 |
要求 |
说明 |
| PHP版本 |
7.0+ |
推荐使用PHP 7.4或更高版本 |
| 服务器 |
支持HTTPS |
必须配置SSL证书 |
| 网络 |
外网可访问 |
能够接收异步通知 |
| 域名 |
已备案 |
中国大陆服务器需要备案 |
2.2 申请材料准备
- 企业营业执照（三证合一）
- 法人身份证正反面
- 银行开户许可证
- 企业基本信息表
- 业务场景说明文档
- 网站域名和备案信息
注意：请确保所有材料真实有效，材料不完整可能导致审核延迟。
3. 第一步：申请商户账号
1
联系商务团队
发送邮件至 [email protected] 或拨打商务电话 400-xxx-xxxx，提供以下信息：
- 企业名称和联系方式
- 业务场景和交易规模
- 期望接入的支付方式
- 预计月交易金额
2
提交申请材料
商务团队审核通过后，需要提交完整的申请材料。审核时间通常为1-2个工作日。
3
账号创建
材料审核通过后，管理员将为您创建商户账号，并发送以下信息：
- 商户ID（mchid）
- API密钥（secretkey）
- API Key
- 支付网关地址
重要提醒：请妥善保管API密钥，不要泄露给第三方。
4. 第二步：配置支付接口
1
接口权限配置
管理员将根据您的业务需求配置相应的支付接口权限：
- 统一支付接口（默认开通）
- 扫码支付接口（根据需求开通）
- H5支付接口（根据需求开通）
- APP支付接口（根据需求开通）
2
支付渠道配置
配置可用的支付渠道：
- 微信支付渠道
- 支付宝渠道
- 银联支付渠道
- 其他第三方支付渠道
3
异步通知配置
配置异步通知地址，用于接收支付结果通知。
配置时间：接口配置通常在账号创建后1-2个工作日内完成。
5. 第三步：技术对接
1
下载SDK
从官网下载 LakShinePaySDK.php 文件：
// 下载地址
https://api.lakshine.com/sdk/LakShinePaySDK.php
2
初始化配置
<?php
require_once 'LakShinePaySDK.php';
// 创建SDK实例
$sdk = new LakShinePaySDK([
'mchid' => '123456789', // 您的商户ID
'secretkey' => 'your_secret_key', // 您的商户密钥
'api_url' => 'https://api.lakshine.com', // API地址
'timeout' => 30 // 请求超时时间
]);
?>
3
实现统一下单
<?php
// 统一下单
$orderData = [
'out_trade_no' => 'TEST' . date('YmdHis') . rand(1000, 9999),
'amount' => '100.00',
'channel' => 'lakshine',
'notify_url' => 'https://your-domain.com/notify',
'return_url' => 'https://your-domain.com/return',
'body' => '商品购买'
];
try {
$result = $sdk->unifiedOrder($orderData);
if ($result['result_code'] === 'SUCCESS') {
$payUrl = $result['charge']['credential']['charge_url'];
// 跳转到支付页面
header('Location: ' . $payUrl);
exit;
} else {
echo "下单失败：" . $result['result_msg'];
}
} catch (Exception $e) {
echo "异常：" . $e->getMessage();
}
?>
4
处理异步通知
<?php
// 接收异步通知
$notifyData = $_POST;
// 验证签名
if ($sdk->verifySign($notifyData, $notifyData['sign'])) {
if ($notifyData['status'] === 'SUCCESS') {
// 支付成功，更新订单状态
updateOrderStatus($notifyData['out_trade_no'], 'paid');
echo 'SUCCESS';
} else {
echo 'FAIL';
}
} else {
echo 'FAIL';
}
?>
6. 第四步：测试上线
1
功能测试
在正式上线前，请完成以下测试：
- 统一下单接口测试
- 支付流程测试
- 异步通知接收测试
- 订单查询接口测试
- 退款接口测试
2
安全测试
3
正式上线
测试通过后，可以正式上线：
- 切换到生产环境
- 配置正式域名
- 监控支付状态
- 处理异常情况
恭喜！您已成功接入LakShine支付平台。如有问题，请联系技术支持团队。
7. 常见问题
7.1 申请阶段
Q: 申请材料提交后多久能收到回复？
A: 通常1-2个工作日内会收到商务团队的回复。
Q: 账号创建需要多长时间？
A: 材料审核通过后，账号创建通常在1个工作日内完成。
7.2 技术对接阶段
Q: 签名验证失败怎么办？
A: 请检查商户密钥是否正确，确认参数排序和MD5算法实现。
Q: 异步通知接收不到怎么办？
A: 请检查notify_url是否可访问，确认服务器防火墙设置。
7.3 上线后
Q: 如何监控支付状态？
A: 可以通过订单查询接口定期查询，或依赖异步通知机制。