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/sezzlepayphp bin/magento setup:upgradephp bin/magento setup:di:compilephp bin/magento setup:static-content:deployphp bin/magento cache:clean
手动
- 从
Sezzle'sgithub 仓库下载 .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/sezzlepayphp bin/magento setup:upgradephp bin/magento setup:di:compilephp bin/magento setup:static-content:deployphp bin/magento cache:clean
手动
- 从
Sezzle'sgithub 仓库下载 .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