paypal-integration

用途：在应用中接入 PayPal 作为支付方式，实现快捷结账、定期订阅计费、退款与支付争议处理，并支持国际支付与 PayPal 订阅。主要能力：PayPal Checkout 一次性支付与访客/账户支付；PayPal Subscriptions 循环计费、订阅计划与自动续订；PayPal Payouts 批量付款；客户端 JavaScript SDK 的 Smart Payment Buttons 与托管支付流程；服务端 REST API 的自主结账 UI 与高级功能；IPN 异步支付通知的验证与处理。使用方式：前端引入 SDK 并渲染按钮，示例为 https://www.paypal.com/sdk/js?client-id=YOUR_CLIENT_ID&currency=USD，在 createOrder 与 onApprove 中创建并捕获订单，并将 orderID 发送到后端验证；后端用 OAuth 获取 access token，调用 /v2/checkout/orders 创建订单、/capture 捕获、/v1/billing/plans 与 /v1/billing/subscriptions 创建订阅、/v2/payments/captures/{capture_id}/refund 发起退款。IPN 处理需回传 PayPal 验证，示例 sandbox 地址为 https://ipnpb.sandbox.paypal.com/cgi-bin/webscr，仅当返回 VERIFIED 才处理。适用场景：电商结账、SaaS 订阅、市场平台分账、跨境收款及退款与拒付处理。限制与注意：必须验证 IPN，不得直接信任通知；需做幂等处理防止重复通知；区分 sandbox 与生产 URL 及凭证；显式指定货币；进行充分 sandbox 测试；示例代码含占位符（CLIENT_ID、CLIENT_SECRET、PRODUCT_ID）需替换。其他细节暂未提供。