sezzle-brasil/sezzlepay

适用于 Magento 2 的 Sezzle 扩展

1.0.0 2022-10-18 15:08 UTC

This package is auto-updated.

Last update: 2024-09-18 19:13:04 UTC


README

Sezzle

适用于 Magento 2 的 Sezzle 扩展

简介

本文档将帮助您安装 Sezzle's Magento 2 扩展。该插件也可以从 github 下载。

如何安装扩展?

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

  • 通过 composer。
  • 手动过程。

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

Composer

  • 打开终端并导航到 Magento 根路径。
  • composer require sezzle-brasil/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's github 仓库下载 .zip 或 tar.gz 文件。
  • 解压缩文件并按照以下说明操作。
  • 通过 SFTPSSH 导航到 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-brasil/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's 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 UUIDAPI 密钥。如果您尚未注册,请注册以获取必需品。
  • 在您的 Magento 管理后台中,导航到 商店 > 配置 > 销售 > 支付方式 > Sezzle > 支付设置
  • 将支付模式设置为 实时 以进行实时操作,将其设置为 沙箱 以进行沙箱操作。
  • 设置 Merchant UUID公钥私钥
  • 支付操作 设置为 仅授权 以进行支付授权,或设置为 授权和捕获 以进行即时捕获。
  • 最小结账金额 设置为限制低于该金额的 Sezzle 支付方式。
  • 适用的国家/地区 设置为 特定国家/地区
  • 启用客户令牌化 设置为 以允许 Sezzle 令牌化客户账户(如果他们批准)。如果客户希望令牌化其账户,则在下一次不需要将他们重定向到 Sezzle 结账页面以完成购买,而是在您的网站上完成。
  • 排序顺序设置为管理Sezzle在结账支付选项列表中的位置。
  • 保存配置并清除缓存。

上下文配置

  • 启用上下文解决方案设置为以激活上下文结账。
  • 根据您希望Sezzle结账如何托管,将上下文结账模式设置为IFrame弹出窗口

结算报告配置

  • 启用结算报告设置为以激活结算报告仪表板。
  • 设置范围以获取您想要获取的结算报告的值。
  • 启用自动同步设置为异步获取结算报告。
  • 设置上述自动同步的调度和时间。

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

小部件配置

  • 在PDP中启用小部件设置为,以在产品展示页中添加小部件脚本,这将有助于在PDP中启用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管理中转到销售 > 订单
  • 选择您想要退款支付的订单。
  • 转到“发票”并选择要退款的那张发票。
  • 点击贷项单并在创建贷项单页面核实您的输入。
  • 保存它,并在Sezzle中启动退款。
  • Sezzle商户仪表板中,“订单状态”显示为已退款”表示已全额退款;“订单状态”显示为部分退款”表示已部分退款。
  • 支付也可以通过Magento 2退款API进行退款。

释放支付

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

在Magento管理员中进行订单验证

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

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

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

客户令牌化详情

  • 登录到Magento管理员并导航到客户 > 所有客户
  • 进入您想要查看令牌化详情的客户。
  • 如果客户已令牌化,将出现Sezzle标签页。
  • 将显示客户UUID过期日期状态

结算报告

  • 登录到Magento管理员并导航到报告 > 销售 > Sezzle结算
  • 将显示最新的结算报告列表。
  • 为了快速同步,输入日期,然后点击同步
  • 操作列中点击下载以下载结算报告。
  • 要查看特定结算报告的详细信息,请从操作列点击查看
  • 也可以通过进入结算报告查看页面来下载结算报告详情。
  • 结算报告可以通过CSVExcel下载,而结算报告详情将通过CSV下载。

沙盒如何工作?

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

故障排除/调试

  • Sezzle已启用日志记录以跟踪Sezzle操作。
  • 如果商户遇到商户成功支持团队不知道的问题,他们可以要求这些日志并将它们转发给平台集成团队。
  • 日志的名称将是sezzlepay.log。始终建议发送system.logexception.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