PayPal 配置指南
PayPal 可用于跨境收款,适合面向海外买家的店铺。
准备工作
注册 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。