README

Shopware 5 的 Sezzle 插件

简介

本文档将帮助您安装 Sezzle 的 Shopware 5 插件。

如何安装插件？

有两种方式可以安装和升级插件。

• 使用 composer。
• 手动过程。

为了所有目的，假设 [Shopware] 是您的 Shopware 5 根目录。

Composer

• 打开终端并导航到 Shopware 根路径。
• 运行以下命令将插件添加到您的代码库：composer require sezzle/shopware5

手动

• 从 Sezzle 的 github 仓库下载 .zip 或 tar.gz 文件。
• 解压文件。
• 通过 SFTP 或 SSH 导航到 Shopware 的 [Shopware]/custom/plugins/。
• 创建 SezzlePayment 目录并将解压文件夹的内容复制到 [Shopware]/custom/plugins/SezzlePayment。
• 登录到 Shopware 5 后端并导航到 配置 > 插件管理 > 管理 > 已安装。
• 从 未安装 列表中选择 Sezzle 并点击 + 按钮安装插件。
• 安装完成后，您将在 不活跃 列表中看到 Sezzle。点击 x 按钮激活插件。
• 激活成功后，您将在 配置 > 支付方式 下看到 Sezzle。

如何升级插件？

Composer

• 更改 composer.json 中 sezzle/sezzlepay 的版本号。
• 打开终端并导航到 Shopware 根路径。
• 运行以下命令更新插件到新版本：composer update sezzle/sezzlepay

手动

• 从 Sezzle 的 github 仓库下载 .zip 或 tar.gz 文件。
• 解压文件。
• 从 [Shopware]/custom/plugins/SezzlePayment 中删除内容。
• 将解压文件夹中的 SezzlePayment 目录内容复制到 [Shopware]/custom/plugins/SezzlePayment/。
• 登录到 Shopware 后端并导航到 配置 > 缓存/性能。
• 通过选择 清除商店缓存 清除缓存存储。

配置 Sezzle

支付配置

• 确保您已从 Sezzle 商户仪表板 获得商户 UUID 和 API 密钥。您必须注册 Sezzle 以访问商户仪表板。
• 在您的 Shopware 后端中导航到 客户 > 支付 > Sezzle > 设置。
• 通过勾选 为此商店启用 复选框启用 Sezzle。
• 设置 公钥 和 私钥。
• 为了测试，通过勾选 启用沙箱 复选框启用沙箱模式。
• 您也可以通过点击 测试 API 设置 按钮验证您的 API 密钥。
• 设置 商户 UUID。
• 根据商店原产地设置 商户位置。
• 勾选 启用令牌化 复选框以在 Sezzle 结账中启用客户令牌化。如果客户同意被令牌化，则未来此客户的结账将不需要重定向到 Sezzle。
• 将 支付操作 设置为 仅授权 以进行支付授权，或将 授权并捕获 设置为进行即时捕获。
• 勾选 显示错误 复选框以在失败时在 Web URL 上显示与 Sezzle 相关的错误代码。
• 勾选 在 PDP 中启用小部件 复选框以将小部件脚本和 Sezzle 小部件 模态添加到产品展示页。
• 勾选Enable Widget in Cart复选框以将小部件脚本和Sezzle Widget模态框添加到购物车页面。
• 将Logging设置为ERROR仅记录错误消息，或将ALL设置为记录所有消息，包括错误、警告和通知。
• 保存设置并清除缓存。

您的商店现在可以接受通过Sezzle进行的付款。

前端功能

• 如果您已成功安装Sezzle插件，则Sezzle将被包含在结账页面中的付款方式中。
• 选择Sezzle并继续。
• 单击Complete Payment后，您将被重定向到Sezzle Checkout以完成结账。注意：如果您的账户已经过令牌化，则跳过下一步，因为您不会被重定向到Sezzle。
• [可选] 在Sezzle Checkout的最后一页，检查Approve {Store Name} to process payments from your Sezzle account for future transactions. You may revoke this authorization at any time in your Sezzle Dashboard以令牌化您的账户。
• 最后，单击Complete Order以完成您的购买。
• 订单成功提交后，您将被重定向到订单确认页面。

捕获付款

• 如果Payment Action设置为Authorize and Capture，则订单在Shopware中创建和验证后，插件将立即执行捕获。
• 如果Payment Action设置为Authorize，则需要从Shopware后端手动执行捕获。按照以下步骤进行捕获。
  • 转到订单并单击Sezzle选项卡。
  • 在Amount字段中输入一个值，然后单击Capture以在Sezzle中捕获付款。

退款付款

• 转到订单并单击Sezzle选项卡。
• 在Amount字段中输入一个值，然后单击Refund以在Sezzle中退款。

释放付款

• 转到订单并单击Sezzle选项卡。
• 在Amount字段中输入一个值，然后单击Release以在Sezzle中释放付款。

Shopware后端订单验证

• 登录到Shopware管理员并导航到Customers > Orders。
• 进入相应的订单。
• 当
  • 当前付款状态为Completely Paid时，Sezzle已成功捕获付款。
  • Capture Amount等于Auth Amount。
• 当
  • 当前付款状态为Open时，付款仅授权。
  • Auth Amount等于Order Amount。
  • Capture Amount等于0。
• 当
  • 当前付款状态为Re-crediting时，付款将被退款。
  • Refund Amount等于或小于Capture Amount。
• 当
  • 当前付款状态为“The process is cancelled for a full release”或“Open for a partial release”时，付款将被释放。
  • 金额将从Auth Amount中扣除，并应出现在Released Amount中。

Sezzle商户仪表板中的订单验证

• 登录到Sezzle商户仪表板并导航到Orders。
• 进入相应的订单。
• 付款成功捕获的状态为Approved。
• 付款已授权但未捕获的状态为Authorized, uncaptured。
• 付款已退款的状态为Refunded或Partially refunded。
• 付款在授权过期前未捕获的状态为Deleted due to checkout not being captured before expiration。

客户令牌化详情

• 登录到Shopware后端并导航到Customers > Customers。
• 选择客户以查看令牌化详情。
• Sezzle Customer UUID、Sezzle Customer UUID Expiry和Sezzle Customer UUID Status将出现在Free text fields下。

沙箱是如何工作的？

• 在您的 Shopware 后端设置页面中，进入 Sezzle 设置，从您的 Sezzle 商户沙箱仪表板 输入 Sandbox API 密钥，并勾选 启用沙箱 复选框，然后保存配置。请确保您在 dev/staging 网站上进行此操作。
• 在您的网站上，将商品添加到购物车，然后转到 结账 并选择 Sezzle 作为付款方式。
• 点击 完成付款 后，您将被重定向到 Sezzle 结账 页面以完成结账。注意：如果您的账户已经标记化，则跳过接下来的四个步骤，因为您不会被重定向到 Sezzle。
• 登录或注册以继续。
• 使用测试数据输入付款详情，然后转到最后一页。
• [可选] 勾选 批准 {商店名称} 从您的 Sezzle 账户处理未来的交易。您可以在任何时间在您的 Sezzle 仪表板中撤销此授权以标记化您的账户。
• 最后，单击Complete Order以完成您的购买。
• 沙箱测试完成。您可以通过登录到您的 Sezzle 商户沙箱仪表板 来查看您刚刚下订单。

故障排除/调试

• Sezzle 已启用日志记录以跟踪 Sezzle 操作。
• 如果商家遇到 商户成功 和 支持 团队所不了解的问题，他们可以要求这些日志并将它们转发给 平台集成 团队。
• 日志的名称将是 plugin_dev-<current-date>.log。始终建议发送 core_dev-<current-date> 以更好地跟踪问题。
• 日志可以在 [Shopware]/var/log/ 中找到。