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
适用于 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 文件。 - 解压缩文件并按照以下说明操作。
- 通过
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-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 UUID
和API 密钥
。如果您尚未注册,请注册以获取必需品。 - 在您的
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结算
。 - 将显示最新的结算报告列表。
- 为了快速同步,输入
从
和到
日期,然后点击同步
。 - 在
操作
列中点击下载
以下载结算报告。 - 要查看特定结算报告的详细信息,请从
操作
列点击查看
。 - 也可以通过进入结算报告查看页面来下载结算报告详情。
- 结算报告可以通过
CSV
或Excel
下载,而结算报告详情将通过CSV
下载。
沙盒如何工作?
- 在您的
Magento
管理员中的Sezzle
配置页面,输入来自您的Sezzle商户沙盒仪表板
的沙盒API密钥
,并将支付模式
设置为沙盒
,然后保存配置。请确保您在dev/staging
网站上执行此操作。 - 在您的网站上,将商品添加到购物车,然后转到
结账
并选择Sezzle
作为支付方式。 - 使用Sezzle支付
- 如果客户未令牌化,则点击
继续到Sezzle
。 - 如果客户已令牌化,则点击
下订单
。 - 如果是在上下文结账,则点击
使用Sezzle支付
。
- 如果客户未令牌化,则点击
- 对于上下文结账,Sezzle结账将在配置的模式中托管,即
iFrame
或Popup
。否则,您将被重定向到Sezzle结账页面。 - 登录或注册以继续。
- 使用测试数据输入付款详情,然后转到最终页面。
- 检查
Approve {网站名称}以处理从您的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