paypal-integration

用途：在项目中集成 PayPal 支付能力，涵盖快捷结账（Express Checkout）、订阅/定期扣费、退款与争议处理，以及 IPN 支付通知。

主要能力：支持一次性支付与 PayPal Checkout、订阅计划与自动续费、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 必须验证并做幂等处理，避免重复；需显式指定币种，并处理所有支付状态。