paypal-integration

用途：在应用中集成 PayPal 支付，覆盖一次性付款、快捷结账、订阅/循环计费、退款与争议处理，以及 IPN 异步通知。

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

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

适用场景：电商结账、SaaS 订阅、平台分账、国际收款、退款与拒付处理。

限制与注意：资料未提供具体收费、价格与平台支持范围；需自行准备 client_id/client_secret，区分 sandbox 与 live 环境；IPN 必须验证并做幂等处理，避免重复入账；不要仅依赖客户端回调，应结合 webhook；货币需显式指定。