README

Sezzle for Magento 2 扩展

简介

本文档将帮助您安装 Sezzle 的 Magento 2 扩展。这是一个认证的扩展，已在市场这里列出。插件也可以从github下载。

如何安装扩展？

有两种方式可以安装和升级扩展。

• 通过 Composer。
• 手动过程。

假设 [Magento] 为您的 Magento 2 根目录。

Composer

• 打开终端并导航到 Magento 根路径。
• composer require sezzle/sezzlepay
• php bin/magento setup:upgrade
• php bin/magento setup:di:compile
• php bin/magento setup:static-content:deploy
• php bin/magento cache:clean

手动

• 从 Sezzle 的 github 仓库下载 .zip 或 tar.gz 文件。
• 解压文件并按照以下说明进行操作。
• 通过 SFTP 或 SSH 导航到 Magento 的 [Magento]/app/code/。
• 将解压文件夹中的 Sezzle 目录复制到 [Magento]/app/code/。
• 打开终端。
• 运行以下命令以启用 Sezzle: php bin/magento module:enable Sezzle_Sezzlepay
• 运行 Magento 安装升级: php bin/magento setup:upgrade
• 运行 Magento 依赖注入编译: php bin/magento setup:di:compile
• 运行 Magento 静态内容部署: php bin/magento setup:static-content:deploy
• 登录到 Magento 管理后台并导航到 系统 > 缓存管理。
• 通过选择 清除缓存存储 来清除缓存存储。

现在您可以直接从配置页面导航到注册 Sezzle。为此，您需要点击 注册 Sezzle，这将重定向到 Sezzle 商户注册 页面。如果您已经有了详细信息，您可以简单地点击 我已经设置了 Sezzle，我想编辑我的设置 以继续。

如何升级扩展？

Composer

• 打开终端并导航到 Magento 根路径。
• composer update sezzle/sezzlepay
• php bin/magento setup:upgrade
• php bin/magento setup:di:compile
• php bin/magento setup:static-content:deploy
• php bin/magento cache:clean

手动

• 从 Sezzle 的 github 仓库下载 .zip 或 tar.gz 文件。
• 解压文件并按照以下说明进行操作。
• 将解压文件夹中的 Sezzle 目录复制到 [Magento]/app/code/。确保您正在覆盖文件。
• 打开终端。
• 运行以下命令以启用 Sezzle: php bin/magento module:enable Sezzle_Sezzlepay
• 运行 Magento 安装升级: php bin/magento setup:upgrade
• 运行 Magento 依赖注入编译: php bin/magento setup:di:compile
• 运行 Magento 静态内容部署: php bin/magento setup:static-content:deploy
• 登录到 Magento 管理后台并导航到 系统 > 缓存管理。
• 通过选择 清除缓存存储 来清除缓存存储。

配置 Sezzle

支付配置

• 将 启用 设置为 是 以激活 Sezzle 作为支付选项。
• 确保您已从Sezzle 商户仪表板 获取了 Merchant UUID 和 API 密钥。如果您尚未注册，请注册以获取必需品。
• 在您的 Magento 管理后台中，导航到 商店 > 配置 > 销售与支付 > Sezzle > 支付设置。
• 将支付模式设置为 实时 以进行实时操作，将其设置为 沙盒 以进行沙盒操作。
• 设置 Merchant UUID、公钥 和 私钥。
• 将 支付操作 设置为 仅授权 以进行仅支付授权，或设置为 授权并捕获 以进行即时捕获。
• 将 最小结账金额 设置为限制 Sezzle 支付方式低于该金额。
• 将 适用的国家/地区的支付 设置为 特定国家/地区。
• 将 特定国家/地区的支付 设置为 美国 或 加拿大，因为 Sezzle 目前仅在美国和加拿大提供。
• 将启用客户令牌化设置为是，以允许Sezzle在客户同意的情况下对客户账户进行令牌化。如果客户希望对他们的账户进行令牌化，下次他们不需要跳转到Sezzle结账来完成购买，而是在您的网站上完成。
• 将排序顺序设置为管理Sezzle在结账支付选项列表中的位置。
• 保存配置并清除缓存。

上下文配置

• 将启用上下文解决方案设置为是以激活上下文结账。
• 将上下文结账模式设置为IFrame或弹出窗口，具体取决于您希望Sezzle结账以何种方式托管。

结算报告配置

• 将启用结算报告设置为是以激活结算报告仪表板。
• 将范围设置为基于您想要获取结算报告的值的值。
• 将启用自动同步设置为异步获取结算报告。
• 设置上述自动同步的日程安排和每日时间。

注意：自动同步需要启用cron。

小部件配置

• 将在产品详情页中启用小部件设置为是，在产品详情页中添加小部件脚本，这将有助于在产品详情页中启用Sezzle小部件模态。
• 将在购物车页面上启用小部件设置为是，在购物车页面上添加小部件脚本，这将有助于在购物车页面上启用Sezzle小部件模态。
• 将在结账页面上启用分期付款小部件设置为是，如果您想在结账页面的Sezzle支付选项下显示Sezzle分期付款小部件。
• 设置价格元素路径。这是在结账页面上检测订单总文本值的元素路径。
• 保存配置并清除缓存。

开发者配置

• 启用日志跟踪器以跟踪Sezzle结账过程。
• 将发送日志到Sezzle设置为是，如果您希望定期基本发送日志到Sezzle。为此需要启用cron。
• 如果您有任何，可以通过点击Sezzle日志下载最新日志。
• 保存配置并清除缓存。

您的店铺现在可以接受通过Sezzle的付款。

前端功能

• 如果您已正确设置Sezzle，您将在结账页面上看到Sezzle作为支付方式。
• 选择Sezzle并继续。
• 一旦您点击继续到Sezzle或下单，您将被重定向到Sezzle结账以完成结账。
• 在Sezzle结账的最后页面，检查批准{网站名称}以从您的Sezzle账户处理未来的交易支付。您可以在Sezzle仪表板中随时撤销此授权以对您的账户进行令牌化，然后点击完成订单以完成您的购买。
• 如果您的账户已经令牌化，订单将直接下单，否则您将重定向到Sezzle结账以完成购买。
• 在下订单成功后，您将被重定向到订单确认页面。

捕获付款

• 如果支付操作设置为授权并捕获，则在订单在Magento中创建和验证后，将从扩展程序立即进行捕获。
• 如果支付操作设置为授权，则需要从Magento管理员手动进行捕获。按照以下步骤操作。
  • 转到订单并点击发票。
  • 在创建发票页面中验证您的输入并点击保存以创建发票。
  • 这将在Sezzle中自动捕获付款。
  • 支付还可以通过 Magento 2 发票 API 进行抓取。

退款支付

• 在 Magento 管理后台中，转到 销售 > 订单。
• 选择您想退款支付的订单。
• 转到发票并选择要退款的发票。
• 点击 信用memo 并在 创建信用memo 页面上验证您的输入。
• 保存并退款将在 Sezzle 中启动。
• 在 Sezzle 商户仪表板 中，订单状态 为 已退款 表示已全额退款，订单状态 为 部分退款 表示已部分退款。
• 支付还可以通过 Magento 2 退款 API 进行退款。

释放支付

• 在 Magento 管理后台中，转到 销售 > 订单。
• 选择您想释放支付的订单。
• 点击 作废 并确认您的操作。
• 在 Sezzle 商户仪表板 中，订单状态 为 因结账未在过期前抓取而删除 表示已全额释放。
• 仅支持从 Magento 进行全额释放。
• 支付还可以通过 Magento 2 作废 API 进行释放。

在 Magento 管理后台中进行订单验证

• 登录到 Magento 管理后台并导航到 销售 > 订单。
• 进入相应的订单。
• 如果订单状态为 处理中 且 总支付金额 等于 订单总额，则表示已成功通过 Sezzle 抓取到支付。
• 如果订单状态为 待处理 且 总支付金额 不等于 订单总额，则表示支付已授权但尚未抓取。
• 如果订单状态为 关闭，则表示已退款。
• 如果订单状态为 已取消，则表示已释放。

在 Sezzle 商户仪表板中进行订单验证

• 登录到 Sezzle 商户仪表板 并导航到 订单。
• 进入相应的订单。
• 状态为 批准 表示已成功通过 Sezzle 抓取到支付。
• 状态为 已授权，未抓取 表示支付已授权但尚未抓取。
• 状态为 已退款 表示已退款。
• 状态为 因结账未在过期前抓取而删除 表示支付未及时抓取或已释放。

客户令牌化详细信息

• 登录到 Magento 管理后台并导航到 客户 > 所有客户。
• 进入您想查看令牌化详细信息的客户。
• 如果客户已令牌化，将出现 Sezzle 选项卡。
• 将显示 客户UUID、到期日期 和 状态。

结算报告

• 登录到 Magento 管理后台并导航到 报告 > 销售 > Sezzle 结算。
• 将显示最新的结算报告列表。
• 要快速同步，请输入 从 和 到 日期并单击 同步。
• 单击 操作 列中的 下载 以下载结算报告。
• 要查看特定结算报告的详细信息，请从 操作 列单击 查看。
• 通过进入结算报告查看页面，也可以下载结算报告的详细信息。
• 结算报告可以通过 CSV 或 Excel 下载，而结算报告细节将通过 CSV 下载。

沙盒是如何工作的？

• 在您的 Magento 管理后台的 Sezzle 配置页面上，输入从您的 Sezzle 商户沙盒仪表板 获取的 沙盒 API 密钥，并将 支付模式 设置为 沙盒，然后保存配置。请确保您在 dev/staging 网站上执行此操作。
• 在您的网站上，将一个商品添加到购物车中，然后转到 结账 并选择 Sezzle 作为支付方式。
• 使用 Sezzle 支付
  • 如果客户未令牌化，请单击 继续到 Sezzle。
  • 如果客户已进行令牌化，请点击 下单。然而，如果客户令牌化已过期，点击 下单 时，Sezzle 将创建一个新的结账流程。
  • 如果在上下文结账中，请点击 使用Sezzle支付。
• 对于上下文结账，Sezzle结账将在配置的模式下托管，即 iFrame 或 弹出窗口。否则，您将被重定向到Sezzle结账页面。
• 登录或注册以继续。
• 使用测试数据输入付款详情，然后转到最终页面。
• 检查 批准 {网站名称} 以处理来自您Sezzle账户的未来交易付款。您可以在Sezzle仪表板中的任何时间撤销此授权以令牌化您的账户。
• 如果您的账户已经令牌化，订单将直接下单，否则您将重定向到Sezzle结账以完成购买。
• 在Sezzle完成付款后，您将被引导至您网站的付款成功页面。
• 沙盒测试已完成。您可以通过登录到您的 Sezzle商户沙盒仪表板 来查看您刚刚放置的测试订单。

故障排除/调试

• Sezzle已启用日志记录以跟踪Sezzle操作。
• 如果商户遇到未知于商户成功和支持团队的问题，他们可以请求这些日志并将它们转发给平台集成团队。
• 日志名称为 sezzlepay.log。始终建议发送 system.log 和 exception.log 以更好地跟踪问题。

设置Docker环境

开始

• 克隆仓库。
• 执行 docker-compose up -d --build 以启动Magento服务器。
• 服务器将在 localhost:8085 上运行。如果您想更改此端口，请编辑 docker-compose.yml。

安装Magento

docker exec -it sezzle_magento2 process install

Sezzle将同时安装。

样本数据部署

docker exec -it sezzle_magento2 process install-sampledata

数据库升级

docker exec -it sezzle_magento2 process upgrade

编译

docker exec -it sezzle_magento2 process compile

部署静态文件

docker exec -it sezzle_magento2 process deploy

设置开发者模式

docker exec -it sezzle_magento2 process developer

缓存清除

docker exec -it sezzle_magento2 process clear

清理环境

docker-compose down --rmi local -v --remove-orphans