Paypal 支付设置

本文介绍如何在 PayPal 开发者平台完成应用创建和 Webhook 配置，使 Tigshop 商城能够对接 PayPal 支付。

前置条件

• 已拥有 PayPal 商家账号（非个人账号）
• 商城已部署并支持 HTTPS 访问

第一步：注册 PayPal 开发者账号

访问 PayPal 开发者中心并登录：
https://developer.paypal.com/

如果没有账号，点击页面右上角 Sign Up 注册。注册完成后进入 Developer Dashboard。

第二步：创建应用，获取 Client ID 和 Secret

1. 在 Developer Dashboard 中，进入 Apps & Credentials 页面
2. 点击 Create App，输入应用名称（如 Tigshop）
3. 创建完成后，页面会显示 Client ID 和 Secret，请妥善保存这两个值，后续需要填写到商城后台

下图为沙箱（Sandbox）环境的示例，正式上线时请切换到 Live 模式获取正式环境的 Client ID 和 Secret。

第三步：配置 Webhook 回调地址

Webhook 用于 PayPal 在支付或退款完成后，主动通知商城更新订单状态。

1. 在应用详情页面，找到 Webhooks 区域，点击 Add Webhook
2. 需要分别添加以下两个 Webhook：

支付成功回调：

• URL：https://你的域名/api/order/pay/notify/paypal
• 监听事件：勾选 Checkout order approved

退款成功回调：

• URL：https://你的域名/api/order/pay/refundNotify/paypal
• 监听事件：勾选 Payment capture refunded

请将 你的域名 替换为商城实际的访问域名，例如：https://www.example.com/api/order/pay/notify/paypal

注意事项

1. 回调地址必须支持 HTTPS，HTTP 地址将无法接收 PayPal 的通知
2. 域名选择：PayPal 对部分非常规域名（如 .co 后缀）存在访问限制，建议使用 .com、.net 等主流域名后缀
3. 沙箱与正式环境：测试阶段可使用 Sandbox 模式，上线前务必切换到 Live 模式并重新获取 Client ID 和 Secret

完成以上配置后，请前往 Tigshop 商城后台填写 Client ID 和 Secret，具体操作见下一篇《商城 PayPal 设置》。