paypal-integration

用途：在应用中集成 PayPal 支付，覆盖快捷结账、订阅（定期扣费）与退款管理，并处理 IPN 通知与支付纠纷。

主要能力：支持 PayPal Checkout 一次性支付与访客/账户支付、PayPal Subscriptions 订阅计划与自动续费、PayPal Payouts 批量付款；提供客户端 JavaScript SDK（Smart Payment Buttons）与服务端 REST API 两种集成方式；支持 IPN 异步通知的验证与处理，以及退款、拒付（chargeback）流程。

使用方式：前端引入 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 捕获付款；订阅需先创建产品与计划（/v1/billing/plans），再创建订阅（/v1/billing/subscriptions）并跳转 approve 链接；退款调用 /v2/payments/captures/{capture_id}/refund。IPN 需回传 cmd=_notify-validate 到 PayPal 验证，返回 VERIFIED 才可信。

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

限制与注意：必须验证 IPN，处理需幂等以防重复通知；区分 sandbox 与生产环境 URL 与凭证；显式指定币种；不要仅依赖客户端回调，应配合 webhook；需完善错误处理与日志。资料未提供具体收费、价格与平台支持范围。