mozgbrasil / magento-userede-php_56
与userede集成
Requires
- mozgbrasil/magento-payment-php_56: dev-master
This package is auto-updated.
Last update: 2024-09-06 12:04:32 UTC
README
Mozg\Userede
简介
集成Userede
动机
满足市场对Magento模块的需求,提供改进和优秀的支持
演示视频
支持/疑问
为了获得适当的支持,请点击这里,尽可能详细地描述发生的原因,并附上屏幕截图以便我们理解
价格
模块资源
- [✓] 交易
- [✓] 查询
- [✓] 捕获
- [✓] 退款
- [✓] 取消
技术特性
在结账时进行授权过程
在收到“交易授权”返回时,将重定向到成功页面
在成功页面上向交易通知资源发送信息
通过CRON处理交易通知
在处理通知时,如果支付被确认,则必须将订单的“状态/状态”更改为“processing”,即“处理中”,以释放处理账单和发货的操作
当订单发货时,状态将更改为“complete”,即“完成”
在发货商品之前,始终检查订单信息,如果显示交易状态已确认支付,包括金融运营商是否捕获交易,如果存在不一致,则必须取消订单直到问题得到纠正
设置CRON
点击这里查看MOZG的文档
确保每分钟执行一次该操作
该模块使用cronjob处理通知
该模块执行至少5分钟前接收到的通知
在Heroku上测试
我想展示我为Heroku平台提供的应用程序
只需单击一次,应用程序即可创建使用电子商务平台Magento的虚拟商店并安装MOZG模块
https://github.com/mozgbrasil/heroku-magento#descrição
安装 - 更新 - 卸载 - 禁用
--
建议“打印”执行的所有步骤的屏幕
如有任何困难,请将屏幕截图发送给我们
--
此模块旨在使用Composer安装
在终端中执行以下命令,以查看Composer的存在及其版本
composer --version
如果您的环境中没有Composer,建议阅读以下文章点击这里
--
服务器必须支持ionCube PHP Loader扩展
在终端中执行以下命令,以查看该环境中PHP CLI的扩展是否存在
php -v
为了查看这个扩展是否在PHP WEB环境中激活,请进行以下操作
请确认您的项目根目录中是否存在phpinfo.php文件
<?php phpinfo(); ?>
如果您的Magento项目根目录中没有phpinfo.php文件,请创建该文件并添加上述内容
通过浏览器访问该文件
然后搜索“ionCube PHP Loader”
如果您的服务器不支持该扩展,请联系您的托管公司,让他们激活该扩展
如果您有权限并想激活该扩展,请点击此处
在“Loader Downloads API”中,下载与您的服务器兼容的包
解压包并将loader-wizard.php文件上传到您的服务器,该文件将演示激活扩展的步骤
点击此处查看执行过程
--
当存在“ionCube PHP Loader”时,请下载以下文件并将其放置在您的服务器根目录下,然后访问,如果功能正常,则表示“ionCube”正在读取这种加密类型
--
为了使用MOZG的模块,您需要接受最终用户许可协议
--
建议您保持一个测试环境以进行测试,并且只有在经过适当的测试后,才在生产环境中应用必要的程序
--
建议您备份Magento平台和数据库
--
在更新Magento之前,始终确保编译器和缓存处于禁用状态
--
请确认您的项目根目录中是否存在composer.json文件,并且该文件应具有类似于以下JSON模式的参数
{
"minimum-stability": "dev",
"prefer-stable": true,
"license": [
"proprietary"
],
"repositories": [
{
"type": "composer",
"url": "https://packages.firegento.com"
}
],
"extra": {
"magento-root-dir": "./",
"magento-deploystrategy": "copy",
"magento-force": true
}
}
如果您的项目根目录中没有composer.json文件,请创建该文件并添加上述内容
为了安装模块,请在您的服务器终端中执行以下命令,在您的项目目录下
composer require mozgbrasil/magento-userede-php_56:dev-master
您可以通过进入后端来检查模块是否已安装
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--
为了更新模块,请在您的服务器终端中执行以下命令,在您的项目目录下
在进行任何涉及更新Magento的过程之前,建议保持编译器和缓存处于禁用状态
composer update
如果发生错误,请重命名/vendor/mozgbrasil文件夹并再次执行
为了检查模块的日期,请执行以下命令
grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil
--
为了卸载模块,请在您的服务器终端中执行以下命令,在您的项目目录下
composer remove mozgbrasil/magento-userede-php_56
--
为了禁用模块
-
在进行任何涉及更新Magento的过程之前,必须保持编译器和缓存处于禁用状态
-
如果您想禁用MOZG的模块,请重命名以下文件夹app/code/local/Mozg
模块的禁用可以用来检测特定事件是否与模块有关
如何配置支付方式
为了配置支付方式,请访问后端
STORES -> Configuration -> Sales/Payment Methods -> Userede (powered by MOZG)
您将看到以下字段
Userede API V2 - 默认设置
必要设置
• 测试模式或生产模式
必须提供相应的环境
• 测试环境的Merchant ID
在以下环境中进行注册以获取集成数据,如MerchantId和MerchantKey:
https://cadastrosandbox.userede.com.br/
• 测试环境的Merchant Key
在以下环境中进行注册以获取集成数据,如MerchantId和MerchantKey:
https://cadastrosandbox.userede.com.br/
• 生产环境的Merchant ID
信息应由Userede提供
• 生产环境的Merchant Key
信息应由Userede提供
高级:处理Magento订单
• 订单状态:创建订单
新创建订单的状态,在运营商服务器通知的支付结果确认之前
• 订单状态:支付授权
运营商授权通知确认后的订单状态
• 订单状态:支付确认
运营商授权通知确认后的订单状态
• 订单状态:订单取消
运营商取消通知确认后的订单状态
如果订单已开账,则无法取消
• 订单状态:支付抓取(虚拟产品)
仅选择分配给完成状态的订单状态,留空以使用与普通产品相同的状态
• 订单状态:已退款
运营商退款通知确认后的订单状态
• 订单状态:部分退款
运营商部分退款通知确认后的订单状态。建议不要定义此状态,让Magento决定状态。
• 订单状态:挂起订单
运营商挂起通知确认后的订单状态
• 抓取类型
即时是默认值
如果您想稍后手动执行资金抓取,请将其设置为手动
• 创建挂起账单(仅限手动抓取)
如果收到授权通知,将创建一个挂起账单。
注意:一旦创建账单,这会使Magento将所有订单推送到“处理”状态,忽略所有其他设置。
• 订单状态:发货时抓取
如果您启用此功能,在发货时将向运营商发送抓取请求
• 激活取消订单
如果由于某些原因取消订单,但收到支付已授权的通知,则会自动取消订单
• 取消订单时的自动退款/退款
激活/禁用取消订单时的自动退款/退款
• 账单电子邮件
激活/禁用电子邮件更新
• 发送订单状态通知电子邮件
激活/禁用所有订单状态变更的更新电子邮件,通知客户
• 激活调试日志
应将模块处理过程存储在 var/log/
文件
DATE_mozg.log
这是模块的日志,是一个包含所有过程(包括由模块的外部库执行的执行)的更详细日志
文件
payment_METHOD.log
高级:使用通知
• 忽略退款通知
如果退款在运营商处完成,并且运营商向Magento发送退款通知,则将自动创建一个信用额度。如果您将此配置设置为“是”,则不会发生这种情况,因为它不会处理收到的任何退款通知。
高级:结账体验
• 取消支付后的重定向目标
确定在取消支付后如何重定向买家。
• 支付方法渲染方式
确定支付方法是否显示其标志或仅显示名称。
• 本地化语言(可选)
这会替代Magento存储的默认客户本地化。
留空让Magento决定(例如:nl_NL)
• ISO国家代码(可选)
这将替换买方收货地址中的国家,以确定将显示哪些支付方式。
用户ede信用卡
• 启用
用于“启用”或“禁用”该方法的使用
• 显示顺序
这是在订单结算步骤中显示的送货方法顺序
• 标题
应显示的该方法名称
• 适用于国家的支付方式
您可以定义该方法是否应适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应功能的国家
• 信用卡类型
选择运营商批准的标志
• 可见于
确定此支付方法在前端和/或后端的Magento中的可见性
• 认证
定义买家是否将被重定向到发卡银行进行信用卡认证
对于此选项,将发送ReturnUrl参数,不应适用于符合Cielo规则的包含特殊字符的域名
对于在后台制作的订单,请勿启用此选项,因为它不应将重定向到认证URL
• 启用分期付款
定义分期付款的使用
• 默认分期付款
对于“货币”列,请提供货币缩写,例如BRL
对于“总额(含)”列,请提供显示分期的最小值
对于“最大分期数”列,请提供将显示的分期数,直到达到显示分期的预定义值
对于“利率(%)”列,请提供使用的利率
分期的显示规则是基于价格区间定义的
该模块已预先配置如下
100.00 R$以内为1期
200.00 R$以内为2期
600.00 R$以内为3期
800.00 R$以内为4期
10,000.00 R$以内为5期
100,000.00 R$以内为6期
根据您的需求进行更改
• 当总计为零时禁用
当报价总计为0时,在结账时禁用此支付方式
用户ede借记卡
• 启用
用于“启用”或“禁用”该方法的使用
• 显示顺序
这是在订单结算步骤中显示的送货方法顺序
• 标题
应显示的该方法名称
• 适用于国家的支付方式
您可以定义该方法是否应适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应功能的国家
• 借记卡类型
选择运营商批准的标志
• 可见于
确定此支付方法在前端和/或后端的Magento中的可见性
• 当总计为零时禁用
当报价总计为0时,在结账时禁用此支付方式
用户ede汇票
• 启用
用于“启用”或“禁用”该方法的使用
• 显示顺序
这是在订单结算步骤中显示的送货方法顺序
• 标题
应显示的该方法名称
• 适用于国家的支付方式
您可以定义该方法是否应适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应功能的国家
• 汇票类型
选择运营商批准的标志
• 未付款订单状态
使用汇票可以支付少于总金额。如果适用,请选择此状态。如果您留空,它将默认采用支付授权订单状态
• 超额付款订单状态
使用汇票可以支付多于总金额。如果适用,请选择此状态。如果您留空,它将默认采用支付授权订单状态
• 可见于
确定此支付方法在前端和/或后端的Magento中的可见性
电子转账用户ede
• 启用
用于“启用”或“禁用”该方法的使用
• 显示顺序
这是在订单结算步骤中显示的送货方法顺序
• 标题
应显示的该方法名称
• 适用于国家的支付方式
您可以定义该方法是否应适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应功能的国家
• 电子转账类型
选择运营商批准的标志
• 未付款订单状态
使用汇票可以支付少于总金额。如果适用,请选择此状态。如果您留空,它将默认采用支付授权订单状态
• 超额付款订单状态
使用汇票可以支付多于总金额。如果适用,请选择此状态。如果您留空,它将默认采用支付授权订单状态
• 可见于
确定此支付方法在前端和/或后端的Magento中的可见性
常见问题解答“FAQ”
401未授权
错误:客户端错误:对POST https://api.userede.com.br/v2/sales/
的响应为401未授权
应在认证失败时显示返回“401未授权”
模块安装后做什么?
在
https://cadastrosandbox.userede.com.br/
此处将提供您的MerchantId和MerchantKey
在Magento中配置方法时,请配置您的MerchantId和MerchantKey
为了测试效果,可以使用以下测试卡
http://mozg.com.br/dicas/dicas-magento1#cartões-de-crédito-para-testes
在测试环境中完成订单,该环境将进行交易处理
如果显示了结束页面,则表示已处理您的交易
与Userede进行交互,请求该集成的一致性,并请求用于生产环境的数据
https://suporte.userede.com.br
如何取消订单
要取消订单,请访问预先创建的账单并单击“取消”按钮,然后访问订单并单击“取消”按钮
如何进行退款
访问预先创建的账单并单击“退款”按钮
注意。只有在完成捕获后,“退款”按钮才应显示
在订单查看中单击“退款”按钮时,Magento只会显示名为“离线退款”的按钮,单击该按钮只会进行退款操作,即对Magento执行退款操作
在订单账单查看中单击“退款”按钮时,Magento应显示名为“离线退款”和“退款”的按钮,单击“退款”按钮将触发“在线”操作,即触发为支付运营商“取消”与订单相关的交易的操作
如何更改方法图像
可以添加包含以下任何名称的图像
- method-boleto.png
- method-creditcard.png
- method-debitcard.png
- method-eletronictransfer.png
并将图像添加到您的模板目录中
/skin/frontend//default/images/mozg_userede
如何自定义phtml文件
您可以通过编辑文件并在之后将其添加到模板目录结构中来自定义phtml文件
以下我们应用了一个特定模板的支持
cp -r app/design/frontend/base/default/template/mozg_userede/ app/design/frontend/smartwave/porto/template
联系方式 - Userede
implantacao.operacoes@userede.com.br
罗尔多·德·卢卡纳 - rmoreira@userede.com.br - 11 3320-9058
或访问
或访问
要联系Userede,请访问
手册
http://www.userede.com.br/suporte/desenvolvedores/
http://apidocs.userede.com.br/
贡献者
Mozg团队
许可
徽章
🐈