概述
VibeFox PayPal Gateway 为 OpenCart 3 和 OpenCart 4 结账添加 PayPal 智能付款按钮（PayPal Smart Payment Buttons）。在 Confirm Order 步骤，顾客点击 PayPal 按钮，在 PayPal 窗口中使用 PayPal 账户或 PayPal 提供的其他资金来源批准付款，订单随即在您的店铺中完成。您的服务器会读取 PayPal 订单，检查其状态、金额和币种，然后才会捕获或授权付款。OpenCart 在付款前就会创建订单，但只有在 PayPal 作出响应后，订单才会获得状态，因此未付款的尝试仍会保持为缺失订单。
如果您希望使用自己的 PayPal REST API 应用接受 PayPal 付款，本扩展适合您：测试时使用沙盒，真实付款时使用正式模式。本扩展没有 PayPal Webhook，因此在 PayPal 账户中进行的争议和退款不会同步到 OpenCart。它不提供 Pay Later 信息、银行卡输入栏、Venmo、Apple Pay 或 Google Pay，不支持保存的付款方式或订阅，也不会在商品或购物车页面显示 PayPal 按钮。
主要功能
服务器端验证：在收取任何款项之前，系统会检查 PayPal 订单的状态、金额、币种和归属。金额始终在服务器端计算。如果订单总额在批准后发生变化，则不会捕获任何款项，顾客需要批准新的总额。
捕获或授权：立即向顾客扣款，或只预留资金，稍后在订单选项卡中捕获或撤销。
不会重复扣款：一笔付款只对应一个购物车，捕获请求具有幂等性；如果之前的尝试因响应丢失而被 PayPal 完成，则会使用该尝试而不是新建一笔；购物车锁可防止重复提交。
待处理的捕获：处于 PayPal 审核中的捕获会获得您的待付款状态；Check PayPal payment status 可重新读取该状态。
订单页面退款：在订单的 VibeFox PayPal Gateway 选项卡中进行全额和部分退款，退款金额不超过 PayPal 实际收取的金额，并发送至付款所在的 PayPal 环境（沙盒或正式环境）。
24 种 PayPal 币种：HUF、JPY 和 TWD 的金额会按照 PayPal 的要求不带小数位发送。对于不受支持的币种，付款方式会隐藏。
您自己的订单状态：为已付款、待付款、已授权、搁置、已撤销、已退款和付款失败等情况分别选择 OpenCart 状态。
OpenCart 条件：地理区域、最低订单金额和排序。日志不包含凭据或顾客数据。
系统要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 OpenCart 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本。一个下载包同时包含两个版本的安装包。一个 PayPal Business 账户，并附带 REST API 应用（Client ID 和 Secret），用于沙盒和/或正式环境。店铺币种须为 PayPal 支持的币种。来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。