paypal-integration

PayPal Integration - PayPal 支付集成技能

技能概述

PayPal Integration 是一个专业的支付集成技能，帮助开发者快速实现 PayPal 快速结账、订阅计费和退款管理功能，支持 JavaScript 和 Python 两种方式接入。

适用场景

1. 电商平台支付集成

无论是独立站、跨境电商还是传统电商平台，都可以使用此技能快速接入 PayPal 支付。支持一次性支付和 Express Checkout 快速结账，让用户无需创建账户即可完成付款，提升转化率。

2. 订阅和会员系统

SaaS 产品、内容付费平台、会员网站等需要周期性收费的场景，可以使用此技能设置 PayPal 订阅计划，实现自动续费、订阅管理和计费周期配置。

3. 市场平台和多方支付

对于需要向多个收款方分付款项的平台（如自由职业平台、市场型电商），此技能提供 PayPal Payouts 功能，支持批量付款和复杂的资金流转。

核心功能

1. Express Checkout 快速结账

提供客户端 JavaScript SDK 和服务端 REST API 两种接入方式。客户端方式使用 Smart Payment Buttons，最小化后端代码；服务端方式可完全自定义结账流程，支持订单创建、支付捕获和订单查询等完整操作。

2. IPN 通知处理

实时接收 PayPal 支付状态变更通知，支持支付完成、退款、退款撤销、争议等所有交易类型的自动处理。内置通知验证机制，确保通知来源真实可靠，防止伪造交易。

3. 订阅与退款管理

完整的订阅计费解决方案，支持创建订阅计划、管理订阅生命周期。提供退款 API，支持全额或部分退款，并可以追踪退款状态。所有操作都有完善的错误处理和日志记录机制。

常见问题

如何开始集成 PayPal 支付到我的网站？

首先在 PayPal Developer 注册开发者账号，创建应用获取 Client ID 和 Client Secret。然后选择集成方式：客户端集成使用 JavaScript SDK 添加智能按钮，服务端集成使用 REST API 创建和捕获订单。建议先在沙盒环境测试，确认无误后再切换到生产环境。

PayPal Express Checkout 和普通支付有什么区别？

Express Checkout（快速结账）是 PayPal 的优化支付体验，允许用户无需注册 PayPal 账户即可完成支付，支持保存支付信息以便下次快速结账。普通支付则需要用户登录 PayPal 账户。Express Checkout 能显著减少支付步骤，提高支付成功率，特别适合移动端和追求转化率的场景。

如何验证 PayPal IPN 通知的真实性？

收到 IPN 通知后，必须将其原样发送回 PayPal 进行验证。具体做法是将接收到的所有参数加上 cmd=_notify-validate 参数，POST 回 PayPal 的验证服务器。PayPal 会返回 "VERIFIED" 或 "INVALID"。只有收到 "VERIFIED" 响应才处理该通知，同时建议检查交易金额、收款邮箱等信息是否匹配，防止钓鱼攻击。