搜索mozgbrasil / magento-braspag-php56
Braspag 集成
Requires
This package is auto-updated.
Last update: 2024-09-06 10:57:43 UTC
README
Mozg\Braspag
简介
集成 Braspag API V2
演示
动机
为了满足 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 之前，请始终保持 Compiler 和 Cache 禁用
--
请确认您的 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-php56:dev-master
您可以通过访问后端来检查模块是否已安装
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--
要更新模块，请在您的服务器终端中执行以下命令（在项目目录中）
在执行任何涉及 Magento 更新的过程之前，建议保持 Compiler 和 Cache 禁用
composer clear-cache && composer update
如果发生错误，请重命名 /vendor/mozgbrasil 文件夹并重新执行
要检查模块的日期，请执行以下命令
grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil
--
要 卸载 模块，请在您的服务器终端中执行以下命令（在项目目录中）
composer remove mozgbrasil/magento-braspag-php56 && composer clear-cache && composer update
--
要禁用模块
-
在执行任何涉及 Magento 更新的过程之前，必须保持 Compiler 和 Cache 禁用
-
如果您想禁用 MOZG 模块，请重命名以下文件夹 app/code/local/Mozg
模块的禁用可以用来检测特定事件是否与模块有关
如何配置支付方式
要配置支付方式，请访问后端
STORES -> Configuration -> Sales/Payment Methods -> Braspag (powered by MOZG)
您将看到以下字段
Braspag API V2 - 默认配置
所需配置
• 测试模式或生产模式
应指定相应环境
• 测试环境 Merchant ID
在以下环境中进行注册以获取集成数据，如 MerchantId 和 MerchantKey
https://cadastrosandbox.braspag.com.br/
• 测试环境 Merchant Key
在以下环境中进行注册以获取集成数据，如 MerchantId 和 MerchantKey
https://cadastrosandbox.braspag.com.br/
• 生产环境 Merchant ID
信息应由 Braspag 提供
• 生产环境 Merchant Key
信息应由 Braspag 提供
高级：处理 Magento 订单
• 订单状态：创建订单
新创建的订单状态，在操作员服务器通知支付结果确认之前
• 订单状态：支付授权
操作员授权通知确认后的订单状态
• 订单状态：支付确认
操作员授权通知确认后的订单状态
• 订单状态：订单取消
操作员取消通知确认后的订单状态
如果订单已开账，则无法取消
• 订单状态：支付捕获（虚拟产品）
仅选择分配给完成状态的订单状态，为使用普通产品的同一状态留空
• 订单状态：退款
退款确认后的订单状态由运营商的退款通知确认
• 订单状态：部分退款
退款（部分）确认后的订单状态由运营商的退款_部分通知确认。建议不要设置此状态，让Magento自行决定状态。
• 订单状态：待处理
运营商通知待处理后的订单状态
• 捕获类型
立即捕获是默认设置
如果您想稍后手动执行资金捕获，请设置为手动
• 创建待处理账单（仅适用于手动捕获）
如果收到授权通知，这将创建一个待处理账单。
注意：一旦创建账单，这将使Magento将所有订单推送到“处理中”状态，忽略所有其他设置。
• 订单状态：捕获发货时
如果您启用此功能，则在发货时将向运营商发出捕获请求。
• 启用取消订单
如果订单因某些原因被取消，但收到支付已授权的通知，则将自动取消订单。
• 取消订单时自动退款/退款
启用/禁用取消订单时的自动退款/退款
• 账单电子邮件
启用/禁用电子邮件更新
• 发送订单状态通知电子邮件
启用/禁用对客户所有订单状态更改的更新电子邮件
• 启用调试日志
应将模块处理过程存储在 var/log/ 中
文件
DATE_mozg.log
这是模块的日志，是一个包含所有过程（包括由模块的外部库执行的执行）的详细日志。
文件
payment_METHOD.log
高级：Braspag通知
• 忽略退款通知
如果退款在运营商处完成，并且运营商向Magento发送退款通知，则应自动创建一个信用memo。如果您将此配置设置为“是”，则不会发生这种情况，因为它不会处理接收到的任何退款通知。
高级：结账体验
• 取消支付后重定向目标
确定支付取消后买家如何重定向。
• 支付方式渲染方法
确定支付方式是否以徽标或仅名称显示。
• 本地语言（可选）
这会替换掉Magento存储中的默认客户本地语言。
留空以让Magento决定（例如：nl_NL）
• ISO国家代码（可选）
这将在确定哪些支付方式将显示时替换买家的账单地址国家。
Braspag信用卡
• 启用
用于“启用”或“禁用”方法的使用
• 显示顺序
这是在订单关闭步骤中显示的交付方法顺序
• 标题
要显示的方法名称
• 适用于国家的支付方式
您可以定义方法是否应对“所有接受国家”或“指定国家”生效
• 特定国家的支付方式
您必须选择方法应功能的国家
• 信用卡类型
选择运营商释放的标志
• 可见性
确定此支付方式在Magento前端和/或后端的可见性
• 验证
定义是否将买家导向发卡银行进行卡片验证
对于此选项，会发送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借记卡
• 启用
用于“启用”或“禁用”方法的使用
• 显示顺序
这是在订单关闭步骤中显示的交付方法顺序
• 标题
要显示的方法名称
• 适用于国家的支付方式
您可以定义方法是否应对“所有接受国家”或“指定国家”生效
• 特定国家的支付方式
您必须选择方法应功能的国家
• 借记卡类型
选择运营商释放的标志
• 可见性
确定此支付方式在Magento前端和/或后端的可见性
• 当总额为零时禁用
当总体报价总额为0时，在结账时禁用此支付方式
Braspag账单
• 启用
用于“启用”或“禁用”方法的使用
• 显示顺序
这是在订单关闭步骤中显示的交付方法顺序
• 标题
要显示的方法名称
• 适用于国家的支付方式
您可以定义方法是否应对“所有接受国家”或“指定国家”生效
• 特定国家的支付方式
您必须选择方法应功能的国家
• 账单类型
选择运营商释放的标志
• 未支付订单状态
使用账单支付可以支付低于总额的金额。如果适用，请在此选择状态。如果留空，则默认采用支付授权订单状态
• 支付超额订单状态
使用账单支付可以支付高于总额的金额。如果适用，请在此选择状态。如果留空，则默认采用支付授权订单状态
• 可见性
确定此支付方式在Magento前端和/或后端的可见性
Braspag电子转账
• 启用
用于“启用”或“禁用”方法的使用
• 显示顺序
这是在订单关闭步骤中显示的交付方法顺序
• 标题
要显示的方法名称
• 适用于国家的支付方式
您可以定义方法是否应对“所有接受国家”或“指定国家”生效
• 特定国家的支付方式
您必须选择方法应功能的国家
• 电子转账类型
选择运营商释放的标志
• 未支付订单状态
使用账单支付可以支付低于总额的金额。如果适用，请在此选择状态。如果留空，则默认采用支付授权订单状态
• 支付超额订单状态
使用账单支付可以支付高于总额的金额。如果适用，请在此选择状态。如果留空，则默认采用支付授权订单状态
• 可见性
确定此支付方式在Magento前端和/或后端的可见性
常见问题解答（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
罗尔多福·德·卢塞纳 - rmoreira@braspag.com.br - 11 3320-9058
或访问
或访问
联系 Braspag
手册
http://www.braspag.com.br/suporte/desenvolvedores/
http://apidocs.braspag.com.br/
贡献者
Mozg 团队
许可证
徽章
🐈