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。