paypal-integration

用途：在项目中集成 PayPal 支付，覆盖快捷结账、订阅与退款管理，适用于实现 PayPal 支付选项、快捷结账流程、定期扣费、退款与支付纠纷处理、IPN 通知、国际支付及订阅等场景。

主要能力：支持 PayPal Checkout 一次性支付与访客/账户支付、PayPal Subscriptions 订阅计划与自动续费、PayPal Payouts 批量付款；提供客户端 JavaScript SDK（Smart Payment Buttons）与服务端 REST API 两种集成方式；包含 IPN 验证与处理、退款工作流、订阅计划创建、错误处理与沙箱测试。

使用方式：前端通过 https://www.paypal.com/sdk/js?client-id=YOUR_CLIENT_ID&currency=USD 加载 SDK 并渲染按钮；服务端使用 OAuth 获取 access_token，调用 /v2/checkout/orders 创建订单、/v2/checkout/orders/{order_id}/capture 捕获付款；IPN 需回传 cmd=_notify-validate 到 https://ipnpb.sandbox.paypal.com/cgi-bin/webscr 验证；退款调用 /v2/payments/captures/{capture_id}/refund；订阅先建产品与计划再创建订阅并跳转 approve 链接。

限制与注意：必须验证 IPN，处理重复通知需幂等，区分沙箱与生产环境凭据与 URL，显式指定货币，不能仅依赖客户端回调，需记录日志并充分测试。具体收费、价格与平台支持范围资料未提供。