paypal-integration

概覽

paypal-integration 技能讓您的電子商務或網頁應用能無縫處理 PayPal 付款。支援快速結帳、定期訂閱、退款管理，以及 PayPal 網路掛勾（IPN）以獲取即時付款更新。此技能專為想快速新增 PayPal 付款選項、自動化帳單週期，或有效處理退款與爭議的開發者與團隊設計。

主要功能

• 以最少設定新增 PayPal 付款方式
• 支援一次性付款與快速結帳
• 啟用定期帳單與訂閱管理
• 處理退款、爭議及付款通知（IPN）
• 同時相容於客戶端（JavaScript SDK）與伺服器端（REST API）整合

適用對象

• 需要 PayPal 結帳的電子商務網站擁有者
• 提供訂閱計費的 SaaS 平台
• 管理付款的市集或平台
• 建立自訂 PayPal 結帳流程的開發者

適用時機

當您需要：

• 在線接受 PayPal 付款
• 實作快速結帳以提升轉換率
• 設置定期訂閱或會員資格
• 自動化退款並處理付款爭議
• 透過 IPN／網路掛勾接收非同步付款通知

使用說明

安裝步驟

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 通知處理退款與爭議的指引。詳見文件中的工作流程說明。

如何探索所有可用功能？

打開程式庫的檔案標籤，瀏覽所有文件、輔助腳本與 paypal-integration 的參考資料。