pagseguro / magento2
Requires
- php: ~5.5.0|~5.6.0|~7.0.0
- pagseguro/pagseguro-php-sdk: 4.*
This package is not auto-updated.
Last update: 2023-05-03 12:29:02 UTC
README
我们推荐使用新的Magento 2 PagSeguro模块,网址:[https://github.com/pagseguro/payment-magento](https://github.com/pagseguro/payment-magento)
[已废弃] Magento 2.x的PagSeguro集成模块
描述
安装并配置好模块后,您可以在您的商店中提供PagSeguro作为支付选项。此模块利用PagSeguro提供的以下功能API
要求
安装
强烈建议您在更新生产环境中的商店之前,在测试环境中验证更改和更新。还建议在执行任何更新/安装程序之前备份您的商店和重要信息。
导航到您的Magento 2安装的根目录,并按照以下步骤操作
模块的安装使用Composer完成。要下载并安装Composer到您的环境,请访问https://getcomposer.org.cn/download/,如果对如何使用它有疑问,请查阅Composer官方文档。
-
通过packagist安装
composer require pagseguro/magento2
- 此时,可能会要求您提供Magento的认证凭证。如果您有任何疑问,可以在此链接中找到操作步骤。
-
执行以下命令
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy
或php bin/magento setup:static-content:deploy pt_BR
,具体取决于您的商店配置。
-
给var/ pub/文件夹赋予权限
chmod -R 777 var/ pub/
更新
强烈建议您在更新生产环境中的商店之前,在测试环境中验证更改和更新。还建议在执行任何更新/安装程序之前备份您的商店和重要信息。
PagSeguro模块的更新通过composer
完成,可以有多种方式,具体取决于您的偏好。一种方式是通过以下命令
composer update pagseguro/magento2
composer update pagseguro/pagseguro-php-sdk
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy
或php bin/magento setup:static-content:deploy pt_BR
,具体取决于您的商店配置。- 检查并配置正确的权限给您的目录。
- 在完成过程后,可能需要更新您的商店的缓存。
- 通过您的店铺管理界面访问PagSeguro部分,检查PagSeguro的信息和配置以及支付方式,然后点击按钮保存。
注意
- 在某些情况下,Magento不会更新生成的静态文件,可能需要通过管理界面、终端命令或直接从pub/static/frontend/Magento/seu_tema/seu_idioma/UOL_PagSeguro文件夹删除内容来更新这些文件。
- 然后,再次执行命令
php bin/magento setup:static-content:deploy
或bin/magento setup:static-content:deploy pt_BR
,具体取决于您的店铺配置。
配置
要访问和配置模块,请访问菜单PagSeguro -> 配置。以下是对可用的选项的描述。
常规配置
- 环境:指定交易将在哪个环境中进行 (生产/sandbox)。
- 电子邮件:在PagSeguro上注册的电子邮件。
- 令牌:在PagSeguro上注册的令牌。
- 重定向URL:在PagSeguro的支付流程结束时,您的客户将自动重定向到您的店铺的确认页面或您在此字段中提供的URL。要激活支付结束时的重定向,需要激活通过API的支付服务。注意:此URL将自动提供,除非您希望客户重定向到其他位置,否则请不要更改。
- 通知URL:每当交易状态发生变化时,PagSeguro都会向您的店铺发送通知。模块应使用以下默认值:http://www.minhaloja.com.br/index.php/pagseguro/notification/response
- 注意:只有当您希望在其他位置接收通知时,才应更改此URL。
- 字符集:您的系统的编码(ISO-8859-1或UTF-8)。
- 启用日志记录:启用/禁用日志生成。
- 目录:请告知从Magento安装根目录开始创建日志文件的位置和文件名。例如:var/log/pagseguro.log。
- 默认情况下,模块将配置为将日志文件保存在var/log/pagseguro.log中。.
- 列出已弃置的交易?:启用/禁用在PagSeguro结账中弃置的交易搜索。
- 交易 -> 已弃置:允许查询在过去10天内弃置的交易,这样您可以发送销售恢复电子邮件。电子邮件将包含一个链接,该链接将买家重定向到支付流程,正好在停止的地方。
- 启用购物车恢复:启用PagSeguro购物车恢复。 (默认情况下是禁用的)
- 列出分期付款:启用在产品查看屏幕上显示分期付款列表。 (将在产品查看屏幕上显示产品的最大分期付款)
配置结账类型 在此部分,您将配置要在您的店铺中提供的PagSeguro支付方式。
请查阅您的PagSeguro账户以了解已启用的支付方式。
-
PagSeguro (标准或lightbox)
- 启用:启用/禁用PagSeguro支付方式(标准或lightbox)。
- 结账:指定将使用的结账模型。可以选择标准结账或lightbox结账。
- 显示名称:定义结账屏幕上使用的支付方式的名称。
- 结账屏幕上的位置(排序顺序):配置此支付方式在您的店铺中的显示顺序。此顺序相对于您店铺中配置的所有其他支付方式。
- 为...提供折扣:启用/禁用通过支付方式结账的折扣(信用卡、支票、在线借记、账户存款和PagSeguro余额)
- 折扣百分比:定义所选支付方式的折扣百分比(接受0.01到99.99的值)
-
透明结账 - 信用卡
- 激活:激活/停用透明结账 - 信用卡支付方式。
- 显示名称:定义结账页面中使用的该支付方式的名称。
- 结账屏幕上的位置(排序顺序):配置此支付方式在您的店铺中的显示顺序。此顺序相对于您店铺中配置的所有其他支付方式。
-
透明结账 - 银行汇票
- 激活:激活/停用透明结账 - 银行汇票支付方式。
- 显示名称:定义结账页面中使用的该支付方式的名称。
- 结账屏幕上的位置(排序顺序):配置此支付方式在您的店铺中的显示顺序。此顺序相对于您店铺中配置的所有其他支付方式。
-
透明结账 - 网上借记
- 激活:激活/停用透明结账 - 网上借记支付方式。
- 显示名称:定义结账页面中使用的该支付方式的名称。
- 结账屏幕上的位置(排序顺序):配置此支付方式在您的店铺中的显示顺序。此顺序相对于您店铺中配置的所有其他支付方式。
交易
要查询和其他操作,请访问PagSeguro菜单 -> 交易,其中交易可以选择以下选项:对账、已放弃、取消、退款。以下是对可用的选项的描述
- 已放弃:允许在指定的天数范围内搜索已放弃的交易。
- 取消:此搜索将返回所有状态为“待审核”和“待支付”的交易,在指定的天数范围内。这样您可以请求取消这些交易。
- 对账:允许查询过去30天内通过PagSeguro完成的交易。搜索将返回与您的本地数据库中交易状态和PagSeguro当前交易状态的比较,这样您可以识别并更新状态不一致的交易。
- 退款:此搜索将返回所有状态为“已支付”、“可用”和“争议”的交易,在指定的天数范围内。这样您可以请求为您的买家退款。
建议在使用退款或取消功能之前,先进行交易对账以获取最新的状态。
输入
买家信息 | 类型 | 期望 |
---|---|---|
电子邮件 | {Pattern - ^([a-zA-Z0-9_])+([@])+([a-zA-Z0-9_])+([.])+([a-zA-Z0-9_])} | email@email.em |
名称 / 姓名 | {String} | 姓名 |
姓氏 / 姓 | {String} | 姓 |
公司 / 企业 | {String} | 企业 |
| 4行地址配置: | 地址1 / 地址1 / 街道 | {String} |地址(街道)| | 地址2 / 地址2 / 号码 | {Integer} |号码 | | 地址3 / 地址3 / 补充信息 | {String} |补充信息 | | 地址4 / 地址4 / 街道 | {String} |街道 | | 标准Magento 2地址配置(2行): | 地址 / 地址 | {String, Integer} |地址,号码| | 地址2 / 街道 / 地址(第二行) | {String} |街道 | | 邮编 / CEP | {Integer or String} | 99999999 / 99999-999 | | 城市 / 城市 | {String} |城市 | | 国家 / 国家 | {String} |国家 | | 州或省 / 州 | {String} |州 | | 其他信息 / 其他信息 | {String} |补充信息 | | 电话 / 家庭电话 | {Integer} - {DDD+NUMBER} | 99999999999 | | 手机 / 手机 | {Integer} - {DDD+NUMBER} | 99999999999 |
疑问?
如有疑问或需要支持,请访问我们的论坛。
变更日志
要查看变更日志,请访问CHANGELOG.md文件。
许可
版权所有 2016 PagSeguro Internet LTDA。
本文件基于Apache许可证第2.0版(以下简称“许可证”);除非按照许可证规定,否则不得使用此文件。您可以在以下地址获取许可证副本:
https://apache.ac.cn/licenses/LICENSE-2.0
除非适用法律要求或书面同意,否则在许可证下分发的软件按“原样”提供,不提供任何形式的明示或暗示保证。有关许可证的具体语言规定、许可和限制,请参阅许可证。
注释
- PagSeguro仅接受使用巴西雷亚尔(BRL)货币进行的支付。
- 请确保提供的电子邮件和令牌与拥有卖家或企业档案的账户相关联。
- 请确保根据系统的编码(ISO-8859-1或UTF-8)正确设置了charset。这可以防止交易产生可能的错误或崩溃,或者特殊字符以不同于常规的方式显示。
- 为了正常生成日志,请确保日志目录和文件具有读写权限。
贡献
发现了错误或想贡献某个功能?
- 进行Fork。
- 添加您的功能或错误修复。
- 在GitHub上提交一个pull request。
- 注意:Pull Request不应发送到master分支,而是应发送到对应版本或开发分支。