PayPal
通过 PayPal 收款。
- 结账 Orders,仅一次性付款
- 订阅 不支持
- 客户门户 不支持
- 退款 不支持
准备工作
准备公网 HTTPS 站点、/admin/plans 中已上架的套餐,以及能管理商户设置的账号。
完成后,能通过签名通知核对一笔订单。
在 PayPal 完成准备
创建沙箱 REST 应用
打开 PayPal。在 Apps & Credentials → Sandbox 中创建 REST 应用。
复制应用凭据
打开应用,复制 Client ID 和 Secret。
订阅订单事件
在 Webhooks 登记以 /api/billing/webhook/paypal 结尾的 HTTPS 地址,订阅 CHECKOUT.ORDER.APPROVED、CHECKOUT.ORDER.COMPLETED 和 CHECKOUT.ORDER.VOIDED。
复制 Webhook ID
打开已保存的端点,复制 Webhook ID。
官方说明 · 创建 REST 应用 · 订阅 Webhook
填写项目配置
回到 Kernlift 后台,打开 /admin/config/payment。选择 PayPal,填写公网成功 URL、取消 URL,将 API base URL 设为 https://api-m.sandbox.paypal.com。
| 来源 | 后台字段 |
|---|---|
| Client ID | Client ID |
| Secret | Client secret |
| Webhook ID | Webhook ID |
勾选启用并点击 保存 provider。
Webhook ID
填写同一 REST 应用、同一环境下的端点 ID。此栏需要标识符。
验证
- 用沙箱买家账号在
/pricing购买套餐。 - 在
/admin/billing-webhooks确认签名校验通过。 - 在
/admin/orders找到同一订单,确认状态为已付款。
切换到正式环境
在正式账号创建凭据并登记正式域名的 Webhook。将新端点的验签值、同一环境的凭据和 https://api-m.paypal.com 一起保存。
常见问题
webhook 签名校验失败
确认 Webhook ID 属于当前 REST 应用及环境。PayPal 使用该 ID 和应用凭据校验通知。