PayPal 配置指南
PayPal 是全球广泛使用的支付平台,支持190+国家和25+货币,适合跨境电商和国际业务。
准备工作
注册 PayPal Business 账户
访问 paypal.com 注册商家账户,完成企业验证。
创建 API 凭证
在开发者门户 developer.paypal.com 创建应用,获取 Client ID 和 Client Secret。
配置 Webhook
在应用设置中添加 Webhook 端点,选择需要监听的事件类型。
配置步骤
1
步骤一:进入支付平台管理
在管理后台进入支付平台管理,找到 PayPal 配置项。
2
步骤二:填写凭证信息
填写 Client ID 和 Client Secret。
3
步骤三:选择环境模式
测试环境(prod_mode: false)使用沙箱凭证,生产环境使用正式凭证。
4
步骤四:配置回调地址
返回URL:https://yourdomain.com/payment/paypal/return 取消URL:https://yourdomain.com/payment/paypal/cancel
5
步骤五:保存并测试
使用 PayPal 沙箱账户测试支付流程。
沙箱测试账户
在 PayPal 开发者门户创建沙箱买家账户进行测试:
- 登录 developer.paypal.com
- 进入 Sandbox -> Accounts
- 使用预创建的买家账户或创建新的测试账户
注意事项
- 沙箱环境凭证与生产环境凭证不同
- 生产环境必须使用 HTTPS
- Webhook 端点需要能公网访问
- PayPal 支付可能需要较长时间确认
常见问题
支付后订单状态未更新?
检查 Webhook 是否正确配置,确认收到 PAYMENT.CAPTURE.COMPLETED 事件。
如何获取 Webhook ID?
在开发者门户应用设置中,Webhook 创建后会显示 ID。