paypal-integration

概览

paypal-integration 技能让您的电商或网页应用实现无缝的 PayPal 支付处理。它支持快捷结账、周期订阅、退款管理以及 PayPal Webhook（IPN）实现实时支付更新。此技能专为希望快速添加 PayPal 支付选项、自动化账单周期或高效处理退款和纠纷的开发者和团队设计。

主要功能

• 以最简配置添加 PayPal 支付方式
• 支持一次性支付和快捷结账
• 启用周期计费和订阅管理
• 处理退款、纠纷及支付通知（IPN）
• 兼容客户端（JavaScript SDK）和服务器端（REST API）集成

适用人群

• 需要 PayPal 结账的电商网站所有者
• 提供订阅计费的 SaaS 平台
• 管理支付的市场或平台
• 构建自定义 PayPal 结账流程的开发者

适用场景

当您需要：

• 在线接受 PayPal 支付
• 实现快捷结账以提升转化
• 设置周期订阅或会员服务
• 自动化退款和处理支付纠纷
• 通过 IPN/Webhook 接收异步支付通知
  时，使用 paypal-integration 是理想选择。

使用指南

安装步骤

1. 使用 Skills CLI 将技能添加到项目中：

   npx skills add https://github.com/wshobson/agents --skill paypal-integration

2. 查看 SKILL.md 了解集成细节和工作流程示例。

3. 探索 README.md、AGENTS.md 以及 rules/、resources/、references/ 文件夹，了解高级用例和配置选项。

集成方式

客户端（JavaScript SDK）

• 使用 PayPal 智能支付按钮，快速实现托管结账体验。
• 后端代码需求极少，适合简单电商网站。

服务器端（REST API）

• 完全控制支付流程和界面。
• 适合高级功能、自定义结账或复杂计费逻辑。

核心概念

• 支付产品： 根据业务模式选择一次性支付、订阅或支付给付。
• IPN（即时支付通知）： 设置 IPN 以实时接收支付状态、退款和纠纷更新。

快速入门

• 从 SKILL.md 文件开始，获取概览和快速启动代码片段。
• 根据您的代码库、技术栈和运营需求调整示例工作流程。

常见问题

paypal-integration 是做什么的？

此技能简化了 PayPal 在线支付、订阅和退款处理的集成。支持前后端工作流，适用于多种电商和 SaaS 场景。

我需要同时集成客户端和服务器端吗？

您可根据需求选择任一方式。JavaScript SDK 适合简单托管结账，REST API 适合自定义或高级支付逻辑。

哪里可以找到安装示例和高级指南？

请查看 SKILL.md 获取快速入门示例。深入集成请参考仓库中的 README.md、AGENTS.md 以及 resources/ 和 references/ 文件夹。

如何处理退款和纠纷？

技能包含通过 PayPal API 和 IPN 通知处理退款和纠纷的指导。详见文档中的工作流程说明。

如何了解所有可用功能？

打开仓库的 Files 标签，浏览所有文档、辅助脚本和参考资料，全面了解 paypal-integration。