paypal

用途：在网站中集成 PayPal 支付，支持 PayPal、Venmo、Pay Later 以及信用卡/借记卡，通过智能支付按钮按买家偏好自适应展示。

主要能力：加载 JavaScript SDK 后可渲染支付按钮、独立按钮（指定 fundingSource）和 CardFields 卡字段；支持订单创建与捕获、订阅（createSubscription）、按钮样式定制（layout、color、shape、label、height、tagline）以及卡字段样式。服务端提供 Node.js SDK（npm install @paypal/paypal-server-sdk）与 REST API，用于创建订单、捕获订单、创建/取消订阅计划，并可通过 Webhook 接收 CHECKOUT.ORDER.APPROVED、PAYMENT.CAPTURE.COMPLETED、BILLING.SUBSCRIPTION.* 等事件。React 可用 @paypal/react-paypal-js（npm install @paypal/react-paypal-js）配合 PayPalScriptProvider 与 PayPalButtons。

使用方式：引入脚本 https://www.paypal.com/sdk/js?client-id=YOUR_CLIENT_ID&currency=USD，在容器中调用 paypal.Buttons({...}).render('#paypal-button-container')；卡字段需加载 components=card-fields 并检查 isEligible()。服务端通过 client-id 与 client-secret 获取 access token，调用沙箱 https://api-m.sandbox.paypal.com 或生产 https://api-m.paypal.com。环境变量包括 PAYPAL_CLIENT_ID、PAYPAL_CLIENT_SECRET、PAYPAL_WEBHOOK_ID 及沙箱对应变量。

适用场景：电商结账、订阅计费、需要同时支持多种支付方式的网站。

限制：资料建议始终在服务端捕获支付、验证 Webhook 签名、在沙箱测试、处理 onError 与 onCancel、保存交易 ID 并保证 Webhook 处理幂等；具体费率、地区可用性与合规要求暂未提供。