搜索mozgbrasil / magento-braspag-php55
Braspag 集成
Requires
This package is auto-updated.
Last update: 2024-09-06 11:02:16 UTC
README
Mozg\Braspag
简介
集成 Braspag API V2 Braspag
演示
动机
满足 Magento 模块市场的需求，提供改进和优质支持
支持/疑问
要获取适当的支持，请点击此处，尽可能详细地描述发生的原因，并附上屏幕截图以便我们理解
价格
模块有哪些功能
- [✓] 交易
- [✓] 查询
- [✓] 捕获
- [✓] 退款
- [✓] 取消
技术特性
在结账时进行授权流程
在收到“交易已授权”的返回时，将重定向到成功页面
在成功页面上，将信息发送到交易通知资源
通过 CRON 处理交易通知，如果付款已确认，则应将订单状态更改为“处理中”，以释放处理账单和发货的操作
在发货之前，始终检查订单信息，如果显示交易状态为已确认支付，包括从金融机构确认交易已捕获，如果出现不一致的情况，则需要取消订单直到问题得到纠正
设置 CRON
要使用此方法，需要为 Magento 激活 CRON
点击此处 以查看 MOZG 的文档
确保每分钟执行一次此操作
此模块使用 cronjob 处理通知
模块执行至少 5 分钟前接收到的通知
安装 - 更新 - 卸载 - 禁用
--
此模块旨在使用 Composer 安装
在终端中执行以下命令，以查看 Composer 及其版本
composer --version
如果您的环境中没有 Composer，建议阅读以下文章 点击此处
--
服务器需要支持 ionCube PHP Loader 扩展
要查看该扩展是否在您的服务器上激活
请确保您的项目根目录中存在 phpinfo.php 文件
<?php phpinfo(); ?>
如果您的 Magento 项目根目录中没有 phpinfo.php 文件，请创建该文件并添加上述内容
通过浏览器访问该文件
然后搜索“ionCube PHP Loader”术语
如果您的服务器不支持此扩展，请点击此处
在“Loader Downloads API”中，下载与您的服务器兼容的包
解压缩包并将“loader-wizard.php”文件上传到您的服务器，该文件将演示激活扩展的步骤
点击此处 以查看执行过程
--
要使用 MOZG 的模块，需要接受最终用户许可协议
--
建议保持一个测试环境进行测试，并在经过适当的测试后，才在生产环境中应用相应的流程
--
建议备份 Magento 平台和数据库
--
在更新 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
}
}
如果 Magento 项目的根目录中没有 composer.json 文件，请创建该文件并添加以上内容
要安装模块，请在您的服务器终端的您的项目目录中执行以下命令
composer require mozgbrasil/magento-braspag-php55:dev-master
您可以通过前往后端来检查模块是否已安装
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--
要更新模块，请在您的服务器终端的您的项目目录中执行以下命令
在执行任何涉及 Magento 更新的过程之前，建议保持编译器和缓存处于禁用状态
composer clear-cache && composer update
发生错误时，请重命名 /vendor/mozgbrasil 文件夹并重新执行
要检查模块的日期，请执行以下命令
grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil
--
要卸载模块，请在您的服务器终端的您的项目目录中执行以下命令
composer remove mozgbrasil/magento-braspag-php55 && composer clear-cache && composer update
--
要禁用模块
-
在执行任何涉及 Magento 更新的过程之前，需要保持编译器和缓存处于禁用状态
-
如果您想禁用 MOZG 模块，请重命名以下文件夹 app/code/local/Mozg
禁用模块可以用来检测特定事件是否与模块有关
如何配置支付方式
要配置支付方式，请在后端访问
STORES -> Configuration -> Sales/Payment Methods -> Braspag (powered by MOZG)
您将看到以下字段
Braspag API V2 - 默认配置
必要的配置
• 测试模式或生产模式
必须指定相应环境
• 测试环境的商户 ID
在以下环境中进行注册以获取集成数据，如 MerchantId 和 MerchantKey：
https://cadastrosandbox.braspag.com.br/
• 测试环境的商户密钥
在以下环境中进行注册以获取集成数据，如 MerchantId 和 MerchantKey：
https://cadastrosandbox.braspag.com.br/
• 生产环境的商户 ID
信息应由 Braspag 提供
• 生产环境的商户密钥
信息应由 Braspag 提供
高级：处理 Magento 订单
• 订单状态：创建订单
新创建的订单状态，在运营商的服务器端支付结果通知确认之前
• 订单状态：支付授权
运营商支付授权通知确认后的订单状态
• 订单状态：支付确认
运营商支付确认通知确认后的订单状态
• 订单状态：订单取消
运营商取消通知确认后的订单状态
如果订单已经过账，则无法取消
• 订单状态：支付捕获（虚拟产品）
仅选择分配给已完成状态的订单状态，留空以使用与普通产品相同的状态
• 订单状态：退款
运营商退款通知确认后的订单状态
• 订单状态：部分退款
退款（部分）确认后，由运营商发送的REEMBOLSO_PARCIAL通知确认订单状态。我们建议不要定义此状态，让Magento自行决定。
• 订单状态：待处理订单
运营商发送待处理通知后订单状态
• 扣款类型
即时扣款是默认设置
如果您想稍后手动执行扣款，请设置为手动
• 创建待处理账单（仅适用于手动扣款）
如果收到AUTORIZAÇÃO通知，则会创建一个待处理账单。
注意：一旦创建账单，Mageot会自动将所有订单推送到“处理”状态，忽略其他所有设置。
• 订单状态：发货时扣款
如果您启用此功能，则在发货时将向运营商发起扣款请求。
• 启用取消订单
如果订单因某些原因被取消，但收到支付已授权的通知，则将自动取消订单。
• 订单取消时自动退款/退款
启用/禁用取消订单时的自动退款
• 账单电子邮件
启用/禁用电子邮件更新
• 发送订单状态通知电子邮件
启用/禁用所有订单状态变更的更新电子邮件给客户
• 启用调试日志
模块过程应存储在var/log/
文件
DATE_mozg.log
这是模块的日志，是一个包含所有过程的更详细日志，包括由模块的外部库执行的执行过程
文件
payment_METHOD.log
高级：Braspag通知
• 忽略退款通知
如果退款在运营商处完成，并且运营商向Magento发送退款通知，则将自动创建一个信用凭证。如果您将此设置设置为“是”，则不会发生这种情况，因为它不会处理任何接收到的退款通知。
高级：结账体验
• 取消后重定向目标
确定购买者在取消支付后如何被重定向。
• 支付方式渲染方法
确定支付方式是否以其徽标或仅名称显示。
• 本地化语言（可选）
这会替换Magento存储的默认客户区域设置。
留空以让Mageot决定（例如：nl_NL）
• ISO国家代码（可选）
这将在确定显示哪些支付方式时替换购买者账单地址的国家。
Braspag信用卡
• 启用
用于“启用”或“禁用”方法的使用
• 显示顺序
这是在订单关闭步骤中显示的交付方式顺序
• 标题
应显示的方法的名称
• 适用国家/地区的支付方式
您可以定义方法是否应适用于“所有接受的国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应功能的国家
• 信用卡类型
选择运营商释放的标志
• 可见性
确定此支付方式在前端和/或后端中的可见性
• 认证
定义购买者是否将被重定向到发卡行进行卡认证
对于这个选项，会发送ReturnUrl参数，按照Cielo的规定，不应适用于包含特殊字符的域名。
对于后端生成的订单，不要激活这个选项，因为不应将重定向到认证URL。
• 启用分期付款
定义分期的使用。
• 默认分期
在“货币”列中，请输入货币缩写，例如BRL。
在“总额（含）”列中，请输入显示分期的最低金额。
在“最大分期数”列中，请输入要显示的分期数，直到达到显示分期的预定义金额。
在“利率（%）”列中，请输入使用的利率。
分期的显示规则是基于价格区间定义的。
模块已经预先配置如下
100.00元及以下，1期付款
200.00元及以下，2期付款
600.00元及以下，3期付款
800.00元及以下，4期付款
10,000.00元及以下，5期付款
100,000.00元及以下，6期付款
根据需要修改
• 总金额为零时禁用
当报价总金额为0时，在结账时禁用这种支付方式。
Braspag借记卡
• 启用
用于“启用”或“禁用”方法的使用
• 显示顺序
这是在订单关闭步骤中显示的交付方式顺序
• 标题
应显示的方法的名称
• 适用国家/地区的支付方式
您可以定义方法是否应适用于“所有接受的国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应功能的国家
• 借记卡类型
选择运营商释放的标志
• 可见性
确定此支付方式在前端和/或后端中的可见性
• 总金额为零时禁用
当报价总金额为0时，在结账时禁用这种支付方式。
Braspag支票
• 启用
用于“启用”或“禁用”方法的使用
• 显示顺序
这是在订单关闭步骤中显示的交付方式顺序
• 标题
应显示的方法的名称
• 适用国家/地区的支付方式
您可以定义方法是否应适用于“所有接受的国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应功能的国家
• 支票类型
选择运营商释放的标志
• 未付款订单状态
使用支票支付时，可以支付少于总金额的金额。如果适用，请在此处选择状态。如果您留空，它将默认为已授权的支付订单状态。
• 超过付款金额的订单状态
使用支票支付时，可以支付超过总金额的金额。如果适用，请在此处选择状态。如果您留空，它将默认为已授权的支付订单状态。
• 可见性
确定此支付方式在前端和/或后端中的可见性
Braspag电子转账
• 启用
用于“启用”或“禁用”方法的使用
• 显示顺序
这是在订单关闭步骤中显示的交付方式顺序
• 标题
应显示的方法的名称
• 适用国家/地区的支付方式
您可以定义方法是否应适用于“所有接受的国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应功能的国家
• 电子转账类型
选择运营商释放的标志
• 未付款订单状态
使用支票支付时，可以支付少于总金额的金额。如果适用，请在此处选择状态。如果您留空，它将默认为已授权的支付订单状态。
• 超过付款金额的订单状态
使用支票支付时，可以支付超过总金额的金额。如果适用，请在此处选择状态。如果您留空，它将默认为已授权的支付订单状态。
• 可见性
确定此支付方式在前端和/或后端中的可见性
常见问题“FAQ”
如何取消订单
要使用magento取消订单，请访问预先创建的账单，然后点击“取消”按钮。接着访问订单并点击“取消”按钮。
如何退款
访问预先创建的账单并点击“退款”按钮。
注意：只有在进行过扣款后，“退款”按钮才会显示。
关于在产品展示页激活产品分期付款
在产品页面显示分期付款的需求下，以下模块可能满足您的需求。
https://www.magentocommerce.com/magento-connect/preco-parcelado-1.html
该模块可以通过composer安装
要使用composer安装模块，请在项目根目录下执行以下命令
composer require connect20/franciscoprado_precoparcelado
模块安装后做什么？
在
https://cadastrosandbox.braspagecommerce.braspag.com.br/
处创建一个测试账户
在此处将您的MerchantId和MerchantKey配置在方法中
进行测试
如果显示了完成页面，则表示已处理您的交易
与Braspag交互，请求对该集成进行测试，并请求用于生产环境的数据。
如何更改方法图片
可以添加以下任一命名的图片
- method-boleto.png
- method-creditcard.png
- method-debitcard.png
- method-eletronictransfer.png
并将图片添加到您的模板目录中
/skin/frontend//default/images/mozg_braspag
联系方式 - Braspag
implantacao.operacoes@braspag.com.br
Rodolfo de Lucena - rmoreira@braspag.com.br - 11 3320-9058
或访问
或访问
要联系Braspag
手册
http://www.braspag.com.br/suporte/desenvolvedores/
http://apidocs.braspag.com.br/
贡献者
Equipe Mozg
许可证
徽章
🐈