该技能用于将 PayPal 集成为支付选项，适用场景包括：实现 Express Checkout 快速结账流程、设置 PayPal 循环计费与订阅、处理退款与支付争议、处理 PayPal IPN 类 webhook 通知、支持国际支付。核心概念区分三类产品：PayPal Checkout（一次性付款、访客与账户支付）、PayPal Subscriptions（循环计费、订阅计划、自动续订）、PayPal Payouts（多收款人付款、市场与平台支付）；集成方式分为客户端 JavaScript SDK（Smart Payment Buttons，后端代码少）与服务端 REST API（完全控制流程、可自定义结账 UI）。用法上，前端可引入 https://www.paypal.com/sdk/js?client-id=YOUR_CLIENT_ID¤cy=USD 并调用 paypal.Buttons({...}).render('#paypal-button-container')；服务端通过 OAuth client_credentials 获取 access token，调用 /v2/checkout/orders 创建订单、/v2/checkout/orders/{order_id}/capture 捕获付款，订阅走 /v1/billing/plans 与 /v1/billing/subscriptions，退款走 /v2/payments/captures/{capture_id}/refund。IPN 处理需将消息加上 cmd=_notify-validate 回传 PayPal 校验，仅接受 VERIFIED 结果，并按 payment_status、txn_type 分派，同时做重复交易检查。最佳实践：始终校验 IPN、幂等处理、完善错误处理与日志、充分使用 sandbox、不单纯依赖客户端回调、显式指定货币。常见陷阱：未校验 IPN、重复处理、混淆沙箱与生产 URL/凭据、遗漏部分支付状态、硬编码配置。注意：部分引用与资产文件（如 references/express-checkout.md、assets/paypal-client.py 等）属外部前置依赖，技能未内置，使用前应从原始来源或既有安装获取并检查；所需文件不存在时不要执行或声称完成依赖步骤。具体费用、价格与平台信息资料暂未提供。
paypal-integration
编程与开发
更新于 10-15 23:25