FOB PayPal Pro
Wpcmf CMS 的现代化 PayPal 支付插件
该插件集成了 PayPal 智能按钮，实现无缝的内联结账体验，支持 Webhook 以获取实时支付更新，并提供可自定义的按钮样式选项。
系统要求
Wpcmf 核心版本 7.3.0 或更高
PHP 8.2 或更高
已激活支付插件
安装方法
1. 通过后台面板安装
进入 后台管理面板 (Admin Panel)，点击 插件 (Plugins) 选项卡。
点击 “添加新插件 (Add new)” 按钮。
找到 FOB PayPal Pro 插件，点击 “安装 (Install)” 按钮。
2. 手动安装
从 Wpcmf 市场下载插件。
解压下载的文件，并将解压后的文件夹上传至 platform/plugins 目录。
进入 后台 > 插件，点击 “激活 (Activate)” 按钮。
主要功能
智能按钮 (Smart Buttons)：网站内联 PayPal 结账，无需离开网站（弹窗体验）。
Webhook 支持：实时支付状态更新，确保订单处理的可靠性。
可定制按钮：配置布局、颜色、形状和标签，以匹配您的品牌风格。
多币种支持：支持所有 PayPal 支持的货币，并自动回退为美元 (USD) 转换。
退款支持：直接在后台面板进行全额或部分退款。
安全处理：服务端创建订单，客户端渲染按钮。
支付详情：在后台订单页面查看 PayPal 交易详情。
使用说明
对于商店管理员
进入 后台 > 设置 > 支付方式 (Payment Methods)。
找到 PayPal 并点击展开设置。
输入您的 PayPal API 凭据（Client ID 和 Client Secret）。
配置按钮外观选项。
启用该支付方式。
对于客户
将商品加入购物车并前往结账页面。
选择 “通过 PayPal 在线支付 (Pay online via PayPal)” 作为支付方式。
点击 PayPal 按钮或 “借记卡或信用卡 (Debit or Credit Card)”。
在 PayPal 弹窗中完成支付。
自动重定向至订单确认页面。
配置选项
在 后台 > 设置 > 支付方式 > PayPal 中进行配置：
Client ID：您的 PayPal 应用程序客户端 ID。
Client Secret：您的 PayPal 应用程序密钥。
Live Mode (生产模式)：在沙盒 (Sandbox) 和生产环境之间切换。
Button Layout (按钮布局)：垂直 (Vertical) 或 水平 (Horizontal) 排列。
Button Color (按钮颜色)：金色 (Gold)、蓝色 (Blue)、银色 (Silver)、白色 (White) 或 黑色 (Black)。
Button Shape (按钮形状)：矩形 (Rectangle) 或 圆角矩形 (Pill)。
Button Label (按钮标签)：PayPal、结账 (Checkout)、立即购买 (Buy Now) 或 支付 (Pay)。
Webhook ID：可选的 Webhook 签名验证。
Webhook 设置 (可选)
进入 PayPal 开发者仪表盘 (PayPal Developer Dashboard)。
选择您的应用程序并进入 Webhooks 页面。
添加 Webhook URL：
https://yoursite.com/payment/fob-paypal-pro/webhook
选择以下事件：
PAYMENT.CAPTURE.COMPLETED (支付捕获完成)
PAYMENT.CAPTURE.DENIED (支付捕获拒绝)
PAYMENT.CAPTURE.REFUNDED (支付捕获退款)
将生成的 Webhook ID 复制到插件设置中。