README

此插件为PayPal集成Craft Commerce，包括PayPal Pro、PayPal Express Checkout和PayPal REST。

仅在美国和英国支持使用REST网关进行信用卡支付。

弃用通知

PayPal已弃用PayPal Express作为结账流程。他们建议项目应考虑实现PayPal Checkout集成以保持最新。因此，此插件现在已弃用，转而使用新的Commerce PayPal Checkout插件。

需求

此插件需要Craft 3.6和Craft Commerce 3.3或更高版本。

安装

您可以从插件商店或使用Composer安装此插件。

从插件商店

转到项目的控制面板中的插件商店，搜索“Craft Commerce的PayPal”。然后在其模态窗口中单击“安装”按钮。

使用Composer

打开您的终端，并运行以下命令

# go to the project directory
cd /path/to/my-project.test

# tell Composer to load the plugin
composer require craftcms/commerce-paypal

# tell Craft to install the plugin
./craft install/plugin commerce-paypal

设置

要添加PayPal支付网关，请转到“ commerce”→“设置”→“网关”，创建一个新的网关，并将网关类型设置为“ PayPal Pro”、“PayPal REST”或“PayPal Express”。

提示：现在可以将PayPal Express API用户名、API密码和API签名设置为环境变量。同样，可以将PayPal Pro API用户名、API密码和API签名设置为环境变量。PayPal REST客户端ID和密钥设置现在可以设置为环境变量。有关更多信息，请参阅Craft文档中的环境配置。

查找您的PayPal Express凭证

1. 登录到您的PayPal卖家账户
2. 在上面的菜单栏中点击“配置文件”并选择“配置文件和设置”
3. 点击“我的销售偏好”
4. 点击“API访问”（点击“更新”）
5. 您需要的是NVP/SOAP API集成（经典）部分
6. 然后转到“管理API凭证”
7. 如果您还没有任何凭证，则可以生成一些。

匹配不同信息到网关设置中的字段可能很复杂，因为有时标签会更改。此表应该会提供帮助。

在网关设置中还有一个下拉菜单“解决方案类型”。我们认为这可能是个人的和商业PayPal账户之间的区别。在我的案例中，“标记”有效，“Solo”无效。

“着陆页”控制用户被引导到PayPal时显示的表单类型。选择“账单”将显示一系列信用卡字段，并可选择登录到PayPal（据记忆这是一个有点隐藏的选项）。选择“登录”将显示一个没有信用卡字段的PayPal登录表单。

品牌名称、页头图片URL、标志图片URL和边框颜色都是您着陆页的定制选项。使用包含域名的完整图片资源URL。

重要

如果您打算使用PayPal Express支付网关，您需要更改Craft配置中的默认tokenParam值。[Craft配置](https://docs.craftcms.com/api/v3/craft-config-generalconfig.html#%24tokenParam-detail "Craft配置")

选择除token之外的其他token名称，例如您可以将它设置为craftToken。否则，来自PayPal的重定向将会失败。