README

Mozg\Pagseguro

简介

集成Pagseguro API

动机

满足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_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-pagseguro-php_56: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-pagseguro-php_56

要禁用模块

在执行任何涉及更新Magento的过程之前，必须保持Compiler和Cache禁用
如果您想禁用MOZG模块，请重命名以下文件夹app/code/local/Mozg

模块禁用可以用来检测特定问题是否与模块有关

如何配置支付方式

要配置支付方式，请访问后端

STORES -> Configuration -> Sales/Payment Methods -> Pagseguro (powered by MOZG)

您将看到以下字段

Pagseguro API V2 - 默认配置

必需的配置

• 测试模式或生产模式

应指定相应环境

• 测试环境的电子邮件

测试环境的电子邮件

• 测试环境的token

测试环境的token

• 生产环境的电子邮件

生产环境的电子邮件

• 生产环境的token

生产环境的token

高级：处理Magento订单

• 订单状态：创建订单

新创建的订单状态，在支付结果通过运营商服务器通知确认之前

• 订单状态：支付授权

运营商确认授权通知后的订单状态

• 订单状态：支付确认

运营商确认授权通知后的订单状态

• 订单状态：订单取消

运营商确认取消通知后的订单状态

如果订单已开账，则无法取消

• 订单状态：支付抓取（虚拟产品）

仅选择分配给已完成状态的订单状态，留空以使用与普通产品相同的设置

• 订单状态：已退款

运营商确认退款通知后的订单状态

• 订单状态：部分退款

运营商确认退款（部分）通知后的订单状态。我们建议不要定义此状态，让 Magento 决定状态。

• 订单状态：待处理订单

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

• 抓取类型

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

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

• 创建挂起的账单（仅限手动抓取）

如果收到授权通知，这将创建一个挂起的账单。

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

• 发货时抓取

如果您启用此功能，则在发货时将向运营商发送抓取请求

• 激活取消订单

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

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

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

• 账单电子邮件

激活/停用电子邮件更新

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

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

• 激活调试日志

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

文件

DATE_mozg.log

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

文件

payment_METHOD.log

高级：Pagseguro 通知

• 忽略退款通知

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

高级：结账体验

• 取消支付后重定向目标

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

• 支付方法渲染方法

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

• 本地化语言（可选）

这将以 Magento 存储的默认客户本地化替代。

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

• ISO 国家代码（可选）

此操作将替换买家收货地址的国家，以确定显示哪些付款方式。

PayPal支付

• 启用

用于“启用”或“禁用”该付款方式

• 显示顺序

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

• 标题

应显示的付款方式名称

• 适用于国家的付款方式

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

• 特定国家的付款方式

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

• 信用卡类型

选择运营商允许的标志

• 可见性

确定在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时，在结账时禁用此付款方式

借记卡PayPal支付

• 启用

用于“启用”或“禁用”该付款方式

• 显示顺序

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

• 标题

应显示的付款方式名称

• 适用于国家的付款方式

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

• 特定国家的付款方式

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

• 借记卡类型

选择运营商允许的标志

• 可见性

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

• 启用分期付款

定义分期付款的使用

• 默认分期付款

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

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

对于“最大分期数”列，请提供显示分期付款的最大分期数

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

• 当总额为零时禁用

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

Boleto PayPal支付

• 启用

用于“启用”或“禁用”该付款方式

• 显示顺序

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

• 标题

应显示的付款方式名称

• 适用于国家的付款方式

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

• 特定国家的付款方式

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

• 汇票类型

选择运营商允许的标志

• 未付款订单状态

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

• 支付超过订单金额的状态

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

• 可见性

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

电子转账PayPal支付

• 启用

用于“启用”或“禁用”该付款方式

• 显示顺序

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

• 标题

应显示的付款方式名称

• 适用于国家的付款方式

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

• 特定国家的付款方式

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

• 电子转账类型

选择运营商允许的标志

• 未付款订单状态

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

• 支付超过订单金额的状态

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

• 可见性

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

常见问题解答（FAQ）

模块安装后应做什么？

对于测试环境

登录到

https://pagseguro.uol.com.br/

然后访问

https://sandbox.pagseguro.uol.com.br/vendedor/configuracoes.html

在此环境中显示令牌

然后访问

https://sandbox.pagseguro.uol.com.br/comprador-de-testes.html

始终使用这些买家数据和信用卡进行测试

对于标准方法和lightbox，请访问

https://sandbox.pagseguro.uol.com.br/transacoes/configuracoes.html

并设置一个状态

对于透明支付方法，请访问

https://sandbox.pagseguro.uol.com.br/transacoes/configuracoes.html

并且不要设置您的交易将具有的状态

对于生产环境

登录到

https://pagseguro.uol.com.br/

然后访问

https://pagseguro.uol.com.br/preferencias/integracoes.jhtml

在此环境中显示令牌

为了测试目的，创建一个价值R$ 1.00的产品，并用一张有效的信用卡完成支付

交易状态：已取消：交易在没有完成的情况下被取消。

按照

https://pagseguro.uol.com.br/v2/guia-de-integracao/api-de-notificacoes.html#!rmcl

这也发生在买家选择使用信用卡支付，但支付没有被PagSeguro或运营商批准的情况下。

如何更改方法图片

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

method-boleto.png
method-creditcard.png
method-debitcard.png
method-eletronictransfer.png

并将图片添加到您的模板目录中

/skin/frontend//default/images/mozg_pagseguro

联系信息 - Pagseguro

要联系Pagseguro

手册

https://dev.pagseguro.uol.com.br/documentacao

https://dev.pagseguro.uol.com.br/documentacao/pagamento-online/pagamentos

https://dev.pagseguro.uol.com.br/documentacao/pagamento-online/pagamentos/pagamento-transparente

贡献者

Mozg团队

许可

商业许可

徽章

🐈

mozgbrasil /

维护者

详细信息

README

Mozg\Pagseguro

简介

动机

演示

支持/疑问

价格

模块功能

技术特征

设置Cron

在Heroku上进行测试

安装 - 更新 - 卸载 - 禁用

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

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

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

要禁用模块

如何配置支付方式

Pagseguro API V2 - 默认配置

必需的配置

• 测试模式或生产模式

• 测试环境的电子邮件

• 测试环境的token

• 生产环境的电子邮件

• 生产环境的token

高级：处理Magento订单

• 订单状态：创建订单

• 订单状态：支付授权

• 订单状态：支付确认

• 订单状态：订单取消

• 订单状态：支付抓取（虚拟产品）

• 订单状态：已退款

• 订单状态：部分退款

• 订单状态：待处理订单

• 抓取类型

• 创建挂起的账单（仅限手动抓取）

• 发货时抓取

• 激活取消订单

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

• 账单电子邮件

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

• 激活调试日志

高级：Pagseguro 通知

• 忽略退款通知

高级：结账体验

• 取消支付后重定向目标

• 支付方法渲染方法

• 本地化语言（可选）

• ISO 国家代码（可选）

PayPal支付

• 启用

• 显示顺序

• 标题

• 适用于国家的付款方式

• 特定国家的付款方式

• 信用卡类型

• 可见性

• 认证

• 启用分期付款

• 默认分期付款

• 当总额为零时禁用

借记卡PayPal支付

• 启用

• 显示顺序

• 标题

• 适用于国家的付款方式

• 特定国家的付款方式

• 借记卡类型

• 可见性

• 启用分期付款

• 默认分期付款

• 当总额为零时禁用

Boleto PayPal支付

• 启用

• 显示顺序

• 标题

• 适用于国家的付款方式

• 特定国家的付款方式