README

Mozg\Braspag

摘要

Braspag API V2集成Braspag

动机

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

演示视频

支持/疑问

要获取相应的支持，请点击这里，尽可能详细地描述问题原因，并附上屏幕截图以便我们理解

价格

点击这里

模块资源

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

技术特性

在结账时进行授权流程

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

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

通过CRON处理交易通知

在处理通知时，如果付款已确认，则应将订单的“状态/状态”更改为“processing”或“处理中”，以便处理账单和发货

在发货商品之前，始终检查订单信息，如果显示交易状态已确认，包括与金融机构的确认，如果出现不一致的情况，则需要取消订单直到问题得到修正

当订单发货时，状态将更改为“complete”或“完整”

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

设置CRON

使用此方法需要激活CRON以供Magento使用

点击这里查看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_56.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_56:dev-master

您可以通过访问后端来检查模块是否已安装：

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

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

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

composer update

在发生错误时，请重命名/vender/mozgbrasil文件夹，然后再次执行。

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

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

要卸载模块，请在服务器上项目的目录中执行以下命令：

composer remove mozgbrasil/magento-braspag-php_56

要禁用模块：

在进行涉及更新Magento的任何过程之前，必须保持Compiler和Cache禁用。
如果您想禁用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/

• 测试环境 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，则将自动创建一个信用 memo。如果您将此配置设置为“是”，则不会发生这种情况，因为它不会处理接收到的任何退款通知。

高级：结账体验

• 取消支付后重定向目标

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

• 支付方式渲染方式

确定支付方式是否显示其标志或仅显示名称。

• 本地语言（可选）

这将替换默认的 Magento 存储的客户端位置。

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

• ISO 国家代码（可选）

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

Braspag 信用卡

• 启用

用于“启用”或“禁用”方法的使用

• 显示顺序

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

• 标题

应显示的方法的名称

• 适用于国家的支付方式

您可以定义该方法是否应适用于“所有接受国家”或“指定国家”

• 特定国家的支付方式

您必须选择该方法应适用的国家

• 信用卡类型

选择运营商释放的标志

• 可见性

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

• 验证

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

对于此选项，将发送 ReturnUrl 参数，不应适用于包含特殊字符的域，因为这些域符合 Cielo 的规则

对于在后台完成的订单，请勿启用此选项，因为不应将重定向到验证 URL

• 启用分期付款

定义使用分期的使用

• 默认分期

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

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

对于“最大分期数”列，请提供将显示的分期的最大数量，直到达到之前提到的显示分期的金额

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

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

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

在此规则中

从 0.00 R$ 到 100.00 R$ 显示 1 期

从 101.00 R$ 到 200.00 R$ 显示 2 期

从 201.00 R$ 到 600.00 R$ 显示 3 期

从 601.00 R$ 到 800.00 R$ 显示 4 期

从 801.00 R$ 到 10,000.00 R$ 显示 5 期

从 10,000.00 R$ 到 100,000.00 R$ 显示 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应显示名为“离线退款”和“退款”的按钮，点击“退款”按钮会触发“在线”操作，即向支付操作员发送取消与订单相关的交易的操作

如何更改支付方式的图片

可以添加包含以下任一名称的图片

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

或访问

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_56

维护者

详细信息

README

Mozg\Braspag

摘要

动机

演示视频

支持/疑问

价格

模块资源

技术特性

设置CRON

在Heroku上进行测试

安装 - 更新 - 卸载 - 禁用

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

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

要卸载模块，请在服务器上项目的目录中执行以下命令：

要禁用模块：

如何配置支付方式

Braspag API V2 - 默认设置

所需设置

• 测试模式或生产模式

• 测试环境的商家ID

• 测试环境 Merchant Key

• 生产环境 Merchant ID

• 生产环境 Merchant Key

高级：Magento 订单处理

• 订单状态：创建订单

• 订单状态：支付授权

• 订单状态：支付确认

• 订单状态：订单取消

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

• 订单状态：退款

• 订单状态：部分退款

• 订单状态：待处理订单

• 捕获类型

• 创建待处理账单（仅限手动捕获）

• 发货时捕获

• 激活取消订单

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

• 账单电子邮件

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

• 激活调试日志

高级：Braspag 通知

• 忽略退款通知

高级：结账体验

• 取消支付后重定向目标

• 支付方式渲染方式

• 本地语言（可选）

• ISO 国家代码（可选）

Braspag 信用卡

• 启用

• 显示顺序

• 标题

• 适用于国家的支付方式

• 特定国家的支付方式

• 信用卡类型

• 可见性

• 验证

• 启用分期付款

• 默认分期

• 总金额为零时禁用

Braspag 银行卡

• 启用

• 显示顺序

• 标题

• 适用于国家的支付方式

• 特定国家的支付方式

• 借记卡类型

• 可见性

• 总金额为零时禁用

Braspag 票据

• 启用

• 显示顺序

• 标题

• 适用于国家的支付方式

• 特定国家的支付方式

• 票据类型

• 未付款订单状态

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