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。