README

Mozg\Pagseguro

概述

与Pagseguro API集成

演示

动机

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

支持/疑问

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

价格

点击这里

模块有哪些功能

• [✓] 交易
• [✓] 捕获
• [✓] 查询

技术特性

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

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

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

通过CRON处理交易通知，如果支付已确认，则应将订单状态更改为“处理中”，以便处理账单和发货

在发货商品之前，始终检查订单信息，如果显示交易状态表明已确认支付，包括金融运营商是否已捕获交易，如果出现不一致的情况，则必须取消订单，直到问题得到纠正

设置Cron

为了使用此方法，需要为CRON激活Magento

点击这里查看MOZG文档

确保每分钟执行一次操作

此模块使用cronjob来处理通知

模块执行至少5分钟前收到的通知

安装 - 更新 - 卸载 - 禁用

--

此模块旨在使用Composer安装

在终端中运行以下命令，以查看Composer及其版本是否存在

composer --version

如果您的环境中没有Composer，建议阅读以下文章点击这里

--

服务器需要支持ionCube PHP Loader扩展

为了查看此扩展是否在您的服务器上激活，请

请确认您的项目根目录下是否存在phpinfo.php文件

<?php phpinfo(); ?>

如果您的项目根目录中没有phpinfo.php文件，请创建它并添加上述内容

通过浏览器访问该文件

然后搜索“ionCube PHP Loader”

如果您的服务器不支持此扩展，请点击这里

在“Loader Downloads API”中，下载与您的服务器兼容的包

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

点击这里查看执行过程

--

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

--

建议保持一个测试环境进行测试，并在经过适当的测试后在生产环境中实施相应的程序

--

建议备份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
  }
}

如果项目根目录中没有composer.json文件，请创建一个并添加上述内容

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

composer require mozgbrasil/magento-pagseguro-php56: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-pagseguro-php56 && composer clear-cache && composer update

--

要禁用模块

1. 在执行任何涉及更新Magento的过程之前，需要保持编译器和缓存禁用

2. 如果您想禁用MOZG模块，请重命名以下文件夹app/code/local/Mozg

模块的禁用可以用来检测特定事件是否与模块相关

如何配置支付方式

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

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

您将看到以下字段

Pagseguro API V2 - 默认配置

必要的配置

• 测试模式或生产模式

应指定相应环境

• 测试环境邮箱

测试环境邮箱

• 测试环境token

测试环境token

• 生产环境邮箱

生产环境邮箱

• 生产环境token

生产环境token

高级：处理订单的流程

• 订单状态：创建订单

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

• 订单状态：支付授权

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

• 订单状态：支付确认

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

• 订单状态：取消订单

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

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

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

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

• 订单状态：退款

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

• 订单状态：部分退款

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

• 订单状态：待处理订单

运营商通知后订单状态

• 捕获类型

即时是默认值

如果您希望稍后手动执行资金捕获，请将其设置为手动

• 创建挂起账单（仅适用于手动捕获）

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

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

• 订单状态：发货时捕获

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

• 启用取消订单

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

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

启用/禁用取消订单时的自动退款

• 账单电子邮件

启用/禁用电子邮件更新

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

启用/禁用客户订单状态变更的电子邮件更新

• 启用调试日志

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

文件

DATE_mozg.log

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

文件

payment_METHOD.log

高级：Pagseguro通知

• 忽略退款通知

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

高级：结账体验

• 取消后重定向目标

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

• 支付方式渲染方法

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

• 本地语言（可选）

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

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

• ISO国家代码（可选）

这将在确定显示哪些支付方式时替换买家的账单地址国家。

Pagseguro信用卡

• 启用

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

• 显示顺序

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

• 标题

应显示的方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

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

• 信用卡类型

选择运营商释放的标志

• 可见性

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

• 认证

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

对于此选项，将发送ReturnUrl参数，不应为包含特殊字符的域使用，这违反了Cielo的规则

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

• 启用分期付款

定义分期付款的使用

• 默认分期付款

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

对于“总额（包含）”列，请输入显示分期付款的最小金额

对于“最大分期数”列，请输入显示分期付款直到之前输入的显示分期付款金额的分期数

对于“利率（%）”列，请输入使用的利率

模块已预先配置如下

100元以内，1期付款

200元以内，2期付款

600元以内，3期付款

800元以内，4期付款

10,000元以内，5期付款

100,000元以内，6期付款

根据您的需求进行修改

• 完全禁用总额为零的情况

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

Paypal借记卡

• 启用

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

• 显示顺序

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

• 标题

应显示的方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

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

• 借记卡类型

选择运营商释放的标志

• 可见性

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

• 启用分期付款

定义分期付款的使用

• 默认分期付款

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

对于“总额（包含）”列，请输入显示分期付款的金额

对于“最大分期数”列，请输入显示分期付款直到之前输入的显示分期付款金额的分期数

对于“利率（%）”列，请输入使用的利率

• 完全禁用总额为零的情况

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

Paypal账单

• 启用

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

• 显示顺序

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

• 标题

应显示的方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

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

• 账单类型

选择运营商释放的标志

• 订单未支付状态

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

• 订单支付超额状态

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

• 可见性

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

Paypal电子转账

• 启用

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

• 显示顺序

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

• 标题

应显示的方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

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

• 电子转账类型

选择运营商释放的标志

• 订单未支付状态

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

• 订单支付超额状态

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

• 可见性

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

常见问题解答（FAQ）

关于在橱窗中激活产品分期付款

在需要显示产品页面分期付款的情况下，以下模块可能满足您的需求

https://www.magentocommerce.com/magento-connect/preco-parcelado-1.html

可以通过composer安装

通过composer安装模块，请在项目根目录执行以下命令

composer require connect20/franciscoprado_precoparcelado

模块安装完成后做什么？

对于测试环境

登录到

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

然后访问

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

在此环境中将显示token

然后访问

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

始终使用以下买家和信用卡数据进行测试

对于生产环境

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

如何更改方法图片

可以添加以下任何一种命名的图片

• 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团队

许可证

商业许可证

徽章

🐈