ECShopX/todo/paypal-testing-steps.md

PayPal 支付功能测试步骤

本文档提供了测试 PayPal 支付功能的步骤，包括配置测试、支付流程测试和退款测试。

准备工作

1. 确保已完成 PayPal 开发者账号注册和沙盒环境配置（参考 paypal-developer-account-setup.md）
2. 确保已安装 PayPal PHP SDK 并完成代码集成
3. 确保已配置 .env 文件中的 PayPal 相关环境变量（参考 paypal-env-example.md）
4. 准备好沙盒测试账号（商家账号和个人账号）的登录信息

测试步骤

1. 配置测试

1. 登录管理后台
2. 进入支付配置页面
3. 选择 PayPal 支付方式
4. 输入以下信息：
   • Client ID（使用沙盒应用的 Client ID）
   • Client Secret（使用沙盒应用的 Secret）
   • 勾选"沙盒模式"
   • 输入 Webhook ID
   • 勾选"启用"
5. 保存配置
6. 检查配置是否保存成功

预期结果：配置保存成功，PayPal 支付方式显示为已启用。

2. 前端支付方式显示测试

1. 登录前端商城
2. 将商品添加到购物车
3. 进入结算页面
4. 查看支付方式列表

预期结果：支付方式列表中显示 PayPal 选项。

3. 基本支付流程测试

1. 在前端商城创建一个测试订单
2. 选择 PayPal 支付方式
3. 点击"支付"按钮
4. 系统应该重定向到 PayPal 登录页面
5. 使用沙盒个人账号登录 PayPal
6. 确认支付信息
7. 点击"同意并继续"按钮
8. 系统应该重定向回商城并显示支付成功页面

预期结果：

• 支付成功
• 订单状态更新为已支付
• 交易记录正确保存在数据库中

4. 取消支付测试

1. 在前端商城创建一个测试订单
2. 选择 PayPal 支付方式
3. 点击"支付"按钮
4. 系统重定向到 PayPal 登录页面
5. 使用沙盒个人账号登录 PayPal
6. 在 PayPal 支付页面点击"取消并返回"链接

预期结果：

• 系统重定向回商城并显示支付取消页面
• 订单状态保持为未支付

5. 退款测试

1. 登录管理后台
2. 找到一个已使用 PayPal 支付的订单
3. 进入订单详情页面
4. 点击"退款"按钮
5. 输入退款金额（可以是部分退款或全额退款）
6. 提交退款请求

预期结果：

• 退款成功
• 订单状态更新为已退款或部分退款
• 退款记录正确保存在数据库中

6. Webhook 测试

1. 登录 PayPal 开发者控制台
2. 进入您的应用详情页面
3. 找到"Webhooks"部分
4. 点击"Simulator"按钮
5. 选择事件类型（如 PAYMENT.SALE.COMPLETED）
6. 输入相关参数
7. 点击"Send test webhook"按钮

预期结果：

• 系统正确接收 Webhook 请求
• 系统验证 Webhook 签名
• 系统根据事件类型执行相应的业务逻辑
• 日志中记录 Webhook 处理过程

问题排查

如果测试过程中遇到问题，请检查以下内容：

1. 支付创建失败：

   • 检查 PayPal 配置是否正确（Client ID 和 Secret）
   • 查看日志文件 storage/logs/paypal.log 获取详细错误信息

2. 回调处理失败：

   • 确保回调 URL 可以从外网访问
   • 检查 PayerID 和 PaymentID 是否正确传递

3. Webhook 验证失败：

   • 确保 Webhook ID 配置正确
   • 检查 Webhook URL 是否可以从外网访问
   • 验证请求头中的签名信息是否完整

4. 支付成功但订单状态未更新：

   • 检查数据库中的交易记录
   • 查看日志文件，确认支付回调是否正确处理

测试记录

测试项目	测试日期	测试结果	备注
配置测试
前端支付方式显示
基本支付流程
取消支付
退款测试
Webhook 测试

注意事项

1. 所有测试应先在沙盒环境中完成，确认无误后再在生产环境中进行
2. 在生产环境中进行测试时，建议使用小额交易
3. 记录所有测试过程和结果，以便后续分析和改进