Daiying CMS PayPal 支付插件配置教程：Client ID、Webhook 与 Sandbox 测试完整指南

PayPal 官方支付插件用于把 Daiying CMS 的 Core 支付链路接入 PayPal Checkout Order。它支持 Sandbox / Live 环境、Webhook 验证、订单捕获和退款，适合跨境收款和美元等币种的支付场景。

准备 PayPal Business 与 Developer App

• 准备 PayPal Business 账户。
• 进入 PayPal Developer Dashboard 创建 App。
• 在 Sandbox 阶段使用 Sandbox App 和 Sandbox Buyer 测试账号。
• 上线前切换 Live App，并替换正式 Client ID、Client Secret 和 Webhook ID。

进入 Daiying CMS PayPal 配置页面

后台路径为：商业 → 支付管理 → 支付 Provider / 支付方式设置，选择 PayPal，或打开 /admin/payments/providers?provider_id=official.payment.paypal#provider-form。页面标题会显示“配置支付方式：PayPal”。

配置 Sandbox

后台字段名是 Environment。测试阶段选择 Sandbox 测试环境，并填写 Sandbox App 的 Client ID 和 Client Secret。正式收款前切换为 Live 正式环境，并使用 Live App 的凭据。

填写 Client ID 与 Client Secret

Client ID

Client ID 来自 PayPal Developer App 的 API Credentials。Daiying CMS 以密钥字段保存；如果已经配置，后台显示“已配置，留空则保留”。

Client Secret

Client Secret 是私密凭据，只能填写在 Client Secret 字段中。不要把它写入高级公共 JSON、文章、截图或任何公开位置。

Webhook 设置

Daiying CMS 的 PayPal Webhook URL 为：https://www.daiyingcms.com/payment/webhooks/official.payment.paypal。请在 PayPal Developer App 中创建 Webhook，把生成的 Webhook ID 填入后台 Webhook ID 字段。浏览器 return URL 只负责用户体验，订单可信支付状态必须依赖 PayPal Webhook 验证。

Sandbox Buyer 测试

在 Sandbox 环境中创建订单后，使用 PayPal Sandbox Buyer 账号完成支付。支付后返回 Daiying CMS 后台 商业 → 支付管理 检查订单状态、Provider 和支付日志。只有 Webhook 验证通过后，订单才应进入可信 paid 状态。

从 Sandbox 切换到 Live

• 在 PayPal Developer 中切换到 Live App。
• 替换 Live Client ID 和 Live Client Secret。
• 创建 Live Webhook，并保存新的 Webhook ID。
• Daiying CMS 的 Environment 改为 Live 正式环境。
• 使用真实公开商品做小额订单验证。

常见错误排查

• Environment 与凭据不匹配：Sandbox 凭据不能用于 Live。
• Client Secret 未配置：首次配置必须填写，后续留空才表示保留。
• Webhook ID 未配置：PayPal Webhook 验证无法完成。
• 买家未完成授权：订单可能停留在 pending 或需要买家操作。
• 币种不支持：确认 PayPal 账户和站点商品币种一致。

安全注意事项

Client Secret 只能保存在 Daiying CMS 后台密钥区；不要出现在截图、文章、日志或 Git 中。公开教程截图应只显示“已配置，留空则保留”的状态。

相关阅读

查看 Stripe 支付插件配置教程