README

Mozg\Braspag

简介

与 Braspag API V2 集成

动机

满足 Magento 模块市场的需求，提供改进和优质的客户支持

演示视频

支持/疑问

要获取适当的支持，请点击此处，尽可能详细地描述发生的原因，并附上屏幕截图以便我们理解

价格

点击此处

模块资源

[✓] 交易
[✓] 查询
[✓] 捕获
[✓] 退款
[✓] 取消

技术特性

在结账过程中执行授权过程

在收到“交易授权”的返回时，将重定向到成功页面

在成功页面上发送信息到交易通知资源

通过 CRON 应处理交易通知

在处理通知时，如果付款已确认，则必须将订单的“状态/状态”更改为“processing”，即“处理中”，以释放处理账单和发货的操作

在发货商品之前，请始终检查订单信息，如果显示交易状态正在显示付款已确认，包括操作员金融公司如果交易已被捕获，如果有任何不一致，则必须取消订单直到问题得到纠正

订单发货后，状态将更改为“complete”，即“完成”

已实现每 5 分钟查询交易状态以更新订单状态的自动化

设置 Cron

要使用此方法，必须激活 Magento 的 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(); ?>

如果项目根目录下不存在phpinfo.php文件，请创建该文件并添加以上内容：

通过浏览器访问该文件：

然后在浏览器中搜索"ionCube PHP Loader"：

如果您的服务器不支持该扩展，请联系您的托管服务提供商，要求他们激活该扩展：

如果您有权限并希望激活扩展，请点击此处：

在"Loader Downloads API"部分，下载与您的服务器兼容的包：

解压缩包，并将loader-wizard.php文件上传到您的服务器，该文件将演示激活扩展的步骤：

点击此处查看执行过程：

如果存在"ionCube PHP Loader"，请下载以下文件并将其放置在服务器根目录中，然后访问，如果工作正常，说明"ionCube"正在读取这种加密类型：

https://raw.githubusercontent.com/mozgbrasil/heroku-magento/master/phpinfo-ioncube-encoder10-x86-64-php_54.php

要使用MOZG模块，需要接受最终用户许可协议：

建议保留一个测试环境进行测试，并在进行适当测试后，才在生产环境中应用相应的操作：

建议备份Magento平台和数据库：

在更新Magento之前，始终确保Compiler和Cache处于禁用状态：

请确认在项目根目录下存在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-braspag-php_54:dev-master

您可以通过进入后台在以下位置检查模块是否已安装：

STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output

要更新模块，请在服务器上的项目目录终端中执行以下命令：

在进行任何涉及更新Magento的过程之前，建议保持Compiler和Cache处于禁用状态：

composer update

发生错误时，请重命名/vendor/mozgbrasil文件夹并重新执行：

要检查模块的日期，请执行以下命令：

grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil

要卸载模块，请执行以下命令：

composer remove mozgbrasil/magento-braspag-php_54

要禁用模块：

在进行任何涉及更新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决定状态。

• 订单状态：待处理订单

运营商待处理通知后的订单状态

• 捕获类型

需要使用此自动化时，应选择“自动”选项，该自动化将在通过CRON执行的通知处理中执行

需要手动捕获交易时，应选择“手动”选项，此操作通过访问订单账单并单击“捕获”按钮来完成

• 创建待处理账单（仅适用于手动捕获）

如果收到授权通知，则会创建一个待处理账单。

注意：这将导致一旦创建账单，Magento将忽略所有其他设置，将所有订单推送到“处理”状态。

• 订单状态：发货时捕获

如果启用此功能，则在发货时将向运营商发出捕获请求

• 激活取消订单

如果订单因某些原因被取消，但收到支付已授权的通知，则将自动取消订单

• 订单取消时自动退款/部分退款

激活/停用取消订单时的自动退款

• 账单电子邮件

激活/停用电子邮件更新

• 发送订单状态通知电子邮件

激活/停用对客户的所有订单状态更改的更新电子邮件

• 激活调试日志

应将模块过程存储在var/log/中

文件

DATE_mozg.log

这是模块日志，它是一个包含所有过程的详细日志，包括模块外部库的执行过程

文件

payment_METHOD.log

高级：Braspag通知

• 忽略退款通知

如果退款在运营商处完成，并且运营商向Magento发送退款通知，则应自动创建一个信用笔记。如果您将此配置设置为“是”，则不会发生此情况，因为它不会处理收到的任何退款通知。

高级：结账体验

• 取消后重定向目标

确定买家在取消支付后如何重定向。

• 支付方式渲染方法

确定支付方式是否以它们的标志或仅以名称显示。

• 本地化语言（可选）

这会替换掉默认的本地化存储客户。

留空以让Magento决定（例如：nl_NL）

• ISO国家代码（可选）

这将替换买家的收货地址国家，以确定显示哪些支付方式。

Braspag信用卡

• 激活

用于“激活”或“停用”该支付方式的使用

• 显示顺序

这是在订单结算步骤中显示的配送方式顺序

• 标题

应显示的支付方式名称

• 适用于国家的支付方式

您可以选择该方式是否适用于“所有接受的国家”或“指定国家”

• 特定国家的支付方式

您必须选择该方法应功能的国家

• 信用卡类型

选择运营商允许的标志

• 可见性

确定在Magento前端和/或后端中显示此支付方式的可见性

• 认证

定义买家是否将被定向到发卡银行进行卡片认证

对于此选项，将发送ReturnUrl参数，不应在符合Cielo规则的特殊字符域名上工作

对于后端制作的订单，不要激活此选项，因为它不应将重定向到认证URL

• 激活分期付款

定义分期付款的使用

• 默认分期付款

对于“货币”列，请提供货币缩写，例如BRL

对于“总额（含）”列，请提供显示分期的最低金额

对于“最大分期数”列，请提供将显示的分期数，直到达到之前为显示分期而提供的值

对于“利率（% 0.0）”列，请提供使用的利率

分期的显示规则基于价格区间

该模块已预配置，使用以下规则

在这个规则中

介于R$ 0,00至R$ 100,00显示1期

介于R$ 101,00至R$ 200,00显示2期

介于R$ 201,00至R$ 600,00显示3期

介于R$ 601,00至R$ 800,00显示4期

介于R$ 801,00至R$ 10,000,00显示5期

介于R$ 10,000,00至R$ 100,000,00显示6期

根据您的需要修改

• 总额为零时禁用

当报价总额为0时，在结账时停用此支付方式

Braspag借记卡

• 激活

用于“激活”或“停用”该支付方式的使用

• 显示顺序

这是在订单结算步骤中显示的配送方式顺序

• 标题

应显示的支付方式名称

• 适用于国家的支付方式

您可以选择该方式是否适用于“所有接受的国家”或“指定国家”

• 特定国家的支付方式

您必须选择该方法应功能的国家

• 借记卡类型

选择运营商允许的标志

• 可见性

确定在Magento前端和/或后端中显示此支付方式的可见性

• 总额为零时禁用

当报价总额为0时，在结账时停用此支付方式

Braspag支票

• 激活

用于“激活”或“停用”该支付方式的使用

• 显示顺序

这是在订单结算步骤中显示的配送方式顺序

• 标题

应显示的支付方式名称

• 适用于国家的支付方式

您可以选择该方式是否适用于“所有接受的国家”或“指定国家”

• 特定国家的支付方式

您必须选择该方法应功能的国家

• 支票类型

选择运营商允许的标志

• 未支付订单状态

使用支票可以支付少于总金额。如果适用，请选择此状态。如果您将其留空，它将采用默认的已授权支付订单状态

• 超额支付订单状态

使用支票可以支付超过总金额。如果适用，请选择此状态。如果您将其留空，它将采用默认的已授权支付订单状态

• 可见性

确定在Magento前端和/或后端中显示此支付方式的可见性

Braspag电子转账

• 激活

用于“激活”或“停用”该支付方式的使用

• 显示顺序

这是在订单结算步骤中显示的配送方式顺序

• 标题

应显示的支付方式名称

• 适用于国家的支付方式

您可以选择该方式是否适用于“所有接受的国家”或“指定国家”

• 特定国家的支付方式

您必须选择该方法应功能的国家

• 电子转账类型

选择运营商允许的标志

• 未支付订单状态

使用支票可以支付少于总金额。如果适用，请选择此状态。如果您将其留空，它将采用默认的已授权支付订单状态

• 超额支付订单状态

使用支票可以支付超过总金额。如果适用，请选择此状态。如果您将其留空，它将采用默认的已授权支付订单状态

• 可见性

确定在Magento前端和/或后端中显示此支付方式的可见性

常见问题解答“FAQ”

401未经授权

错误：客户端错误：`POST https://api.braspag.com.br/v2/sales/` 导致 `401未经授权` 响应

在认证失败时，应显示“401未经授权”的返回值

安装模块后做什么？

在

https://cadastrosandbox.braspag.com.br/

将提供您的MerchantId和MerchantKey

在Magento中配置该方法的MerchantId和MerchantKey

为了测试效果，可以使用以下测试卡

http://mozg.com.br/dicas/dicas-magento1#cartões-de-crédito-para-testes

在测试环境中完成订单处理的最终化

如果已经显示完成页面，说明您的交易已经处理

与Braspag互动，请求该集成验证，并请求用于生产环境的数据

https://suporte.braspag.com.br

如何取消订单

要取消由magento创建的订单，请访问预先创建的账单，然后点击“取消”按钮。接着访问订单并点击“取消”按钮。

如何退款

访问预先创建的账单并点击“退款”按钮

注意：“退款”按钮只有在完成扣款后才会显示

在订单查看页面点击“退款”按钮时，magento只显示“离线退款”按钮，点击该按钮只会对magento执行退款操作

在订单账单查看页面点击“退款”按钮时，magento应显示“离线退款”和“退款”按钮。点击“退款”按钮会触发“在线”操作，即向支付运营商发送与订单相关的交易“取消”操作

如何更改方法图像

可以添加以下命名之一的图像

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

或访问

http://braspag.tasker.com.br/

或访问

要联系Braspag

手册

http://www.braspag.com.br/suporte/desenvolvedores/

http://apidocs.braspag.com.br/

https://braspag.github.io/manual/braspag-pagador

贡献者

Mozg团队

许可证

商业许可证

徽章

🐈

mozgbrasil / magento-braspag-php_54

维护者

详细信息

README

Mozg\Braspag

简介

动机

演示视频

支持/疑问

价格

模块资源

技术特性

设置 Cron

在 Heroku 上测试

安装 - 更新 - 卸载 - 禁用

要在服务器上的项目目录终端中安装模块，请执行以下命令：

要更新模块，请在服务器上的项目目录终端中执行以下命令：

要卸载模块，请执行以下命令：

要禁用模块：

如何配置支付方式

Braspag API V2 - 标准配置

必要配置

• 测试模式或生产模式

• 测试环境Merchant ID

• 测试环境Merchant Key

• 生产环境Merchant ID

• 生产环境Merchant Key

高级：Magento订单处理

• 订单状态：订单创建

• 订单状态：支付授权

• 订单状态：支付确认

• 订单状态：订单取消

• 订单状态：支付捕获（虚拟产品）

• 订单状态：已退款

• 订单状态：部分退款

• 订单状态：待处理订单

• 捕获类型

• 创建待处理账单（仅适用于手动捕获）

• 订单状态：发货时捕获

• 激活取消订单

• 订单取消时自动退款/部分退款

• 账单电子邮件

• 发送订单状态通知电子邮件

• 激活调试日志

高级：Braspag通知

• 忽略退款通知

高级：结账体验

• 取消后重定向目标

• 支付方式渲染方法

• 本地化语言（可选）

• ISO国家代码（可选）

Braspag信用卡

• 激活

• 显示顺序

• 标题

• 适用于国家的支付方式

• 特定国家的支付方式

• 信用卡类型

• 可见性

• 认证

• 激活分期付款

• 默认分期付款

• 总额为零时禁用

Braspag借记卡

• 激活

• 显示顺序

• 标题

• 适用于国家的支付方式

• 特定国家的支付方式

• 借记卡类型

• 可见性

• 总额为零时禁用

Braspag支票

• 激活

• 显示顺序

• 标题

• 适用于国家的支付方式

• 特定国家的支付方式

• 支票类型

• 未支付订单状态

错误：客户端错误：`POST https://api.braspag.com.br/v2/sales/` 导致 `401未经授权` 响应