README

（由 Federico Stange 提供）

第一步

要使用此插件，您需要在 https://www.mercadopago.com/developers/ 创建一个 mercado pago 开发者账户

创建您的开发者账户并在登录状态下，在 https://www.mercadopago.com/mla/herramientas/aplicaciones 获取 MercadoPago 凭据

使用提供的 MercadoPago 凭据在您的 ShopWare 后端配置 MercadoPago 插件

根据您的位置（阿根廷、巴西、古巴等），请确保将“应用程序货币”设置为正确的国家货币。

注意：阿根廷接受两种货币，USD 和 ARS

插件安装

手动

目前，由于我尚未将其提交到 ShopWare 插件商店，该插件将不会在后台插件列表中显示。

要安装它，请进入您的 shopware 目录，例如：cd /var/www/shopware

现在进入 custom/plugins 文件夹

运行以下命令

git clone https://github.com/pthreat/StangeMercadoPago.git

现在进入插件目录

cd StangeMercadoPago

运行：../../../composer.phar install

返回到您的 shopware 目录（本例中为 /var/www/shopware）

运行 php bin/console sw:plugin:refresh

运行 php bin/console sw:plugin:install --activate StangeMercadoPago

Composer

只需运行

composer require stange/shopware-mercadopago

运行该命令后，将 vendor/stange/shopware-mercadopago 文件夹移动到 custom/plugins/StangeMercadoPago

以防万一，cd 到 custom/plugins/StangeMercadoPago，然后运行 composer install

配置插件

登录到您的后台并打开插件管理器

在“已安装插件”选项卡下配置插件并保存配置。

刷新商店缓存（在配置 -> 缓存/性能 -> 清除商店缓存）

就这样！您应该可以使用 MercadoPago 结算插件了！

IPN：即时支付通知

在 MercadoPago 后端无需配置任何 URL。只需确保您的商店对公网开放，您就会收到即时支付通知。

UI 模式配置

已移除 UI 模式选项，以提供简化和正确的插件操作。

应用程序货币配置

根据您的地理位置，设置与您的 mercadopago 账户匹配的正确货币非常重要。

结账模式配置

该插件接受两种配置模式，生产模式和沙盒模式

（2017-03-05）截至此日期，“沙盒模式”无法正确工作。MercadoPago 提供的解决方案是使用生产模式并使用此处提供的测试信用卡和测试用户

https://www.mercadopago.com.ar/developers/es/solutions/payments/custom-checkout/test-cards/

控制台命令

此插件提供了以下控制台命令

创建 mercado pago 测试用户

php bin/console stange:mercadopago:create:test-user

检查两种货币之间的汇率

php bin/console stange:mercadopago:currency:exchange <from_curency> <to_currency> [amount]

使用测试卡和测试用户

在测试之前，您需要创建两个测试用户，然后再使用测试信用卡。

一旦插件安装和配置完成，您可以通过 Shopware 的命令行创建这些用户。

为此，我创建了一个简单的控制台命令来完成这项工作。

请运行


php bin/console stange:mercadopago:create:test-user

运行两次，一次用于创建买家测试用户，再次用于创建卖家用户

在创建测试用户后，使用销售用户登录到mercadopago并获取您的应用凭据。

重新配置Shopware后端以使用测试用户客户端ID和客户端密钥。

完成结账流程，当被重定向到mercadopago页面时，使用您的买家凭据登录。

在此处找到属于您国家的任何测试卡。

https://www.mercadopago.com.ar/developers/es/solutions/payments/custom-checkout/test-cards/

在结账过程中使用该卡，不用担心PIN码（您可以在那里输入任何三位数）。

同样适用于过期日期，但请记住，过期日期应该设置为未来。

运行测试

为了运行集成测试，您的插件必须正确配置。在测试过程中，请使用位于shopware-folder/vendor/bin/phpunit的Shopware提供的phpunit二进制文件。

针对开发者

编码风格

代码的缩进风格必须得到尊重。我只使用制表符。请将您的编辑器设置为制表符停止为3，以便在编辑器中正确显示代码。

命名空间

我的个人偏好是使用命名空间声明包围。

namespace StangeMercadoPago{
   class Test{
	}
}

我认为这样可以让您意识到您正在命名空间内工作，而不是在全局命名空间中。

协作

只需通过github发送一个pull request，给我发一封电子邮件或在github中添加一个问题。

变更日志

版本1.0.1

为了简洁和正确插件操作移除了UI模式
添加了成功、取消和待支付页面。当用户在mercadopago完成购买后，用户将被重定向到您的商店的成功、取消或待支付页面。请注意，由于mercadopago有5秒的延迟，在这段时间内客户可能会关闭窗口，因此这些页面不能被信任用于完成结账过程。因此，首选即时支付通知。
添加了小型本地化.ini文件（德语、英语）

待办事项

通过后端启用允许的结账方式编辑
启用编辑结账方式偏好设置（信用卡分期付款等）

stange / shopware-mercadopago

维护者

详细信息