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 IDClient ID
SecretClient secret
Webhook IDWebhook ID

勾选启用并点击 保存 provider。

Webhook ID

填写同一 REST 应用、同一环境下的端点 ID。此栏需要标识符。
Kernlift 后台的 PayPal 配置字段

验证

  1. 用沙箱买家账号在 /pricing 购买套餐。
  2. 在 /admin/billing-webhooks 确认签名校验通过。
  3. 在 /admin/orders 找到同一订单,确认状态为已付款。

切换到正式环境

在正式账号创建凭据并登记正式域名的 Webhook。将新端点的验签值、同一环境的凭据和 https://api-m.paypal.com 一起保存。

常见问题

webhook 签名校验失败

确认 Webhook ID 属于当前 REST 应用及环境。PayPal 使用该 ID 和应用凭据校验通知。

下一步

接入支付服务商