README

Transbank Magento2 Webpay 插件

Webpay for Magento2 官方插件

描述

本插件是 Transbank 的官方插件，允许您轻松地将 Webpay 集成到您的 Magento2 站点中。它基于 PHP 官方 SDK 开发。

如何安装？

您可以在 transbankdevelopers.cl/plugin/magento/ 上查看安装说明和完整文档。

生产环境部署

安装插件后，该插件默认配置为在 Transbank 的测试环境中工作。要使用真实货币（生产环境），您需要

拥有自己的商户代码。如果没有，请在 transbank.cl 申请 Webpay Plus。
完成集成后，您需要使用您的商户代码生成凭据（私钥和公钥）。
将此集成表格发送到 soporte@transbank.cl，并附上公钥（在上一步生成）和您的 Logo（130x59 像素，GIF 格式）。这两个文件应作为链接包含，而不是附件，以避免传输问题。
当 Transbank 确认已加载您的公钥和 Logo 后，您需要进入 Prestashop 插件配置页面，输入您的商户代码、私钥、公钥，并将环境设置为 '生产'。
您需要在生产环境中进行一次价值 10 美元的购买以确认插件的正确运行。

您可以在此链接中查看更多有关此过程的信息。

开发

以下是为开发此插件所需的信息。

依赖

需要 Composer

该插件依赖于以下库

transbank/transbank-sdk
tecnickcom/tcpdf

注意

PHP SDK 版本位于 composer.json 文件中
插件版本位于 composer.json 和 etc/module.xml 文件中
如果您要修改代码，我们建议使用开发 Docker

安装

注意：您可以通过两种方式从 packagist.org 安装此插件：直接从 packagist.org 或直接从 git 仓库。

转到 Magento2 的基本目录
[选项 1] 执行以下命令直接从 packagist.org 安装插件
```
composer require transbank/webpay-magento2
```
等待依赖项更新。

[选项 2] 执行以下命令直接从 git 安装插件

composer config repositories.transbankwebpay vcs https://github.com/TransbankDevelopers/transbank-plugin-magento2-webpay.git
composer require transbank/webpay-magento2:dev-master

等待依赖项更新。

执行以下命令以启用模块

magento module:enable Transbank_Webpay --clear-static-content
magento setup:upgrade && magento setup:di:compile && magento setup:static-content:deploy

在 Magento2 管理界面中，在 Stores/Configuration/Payment Methods/Webpay 部分启用并配置 Webpay 插件。
配置必要的证书以使 Webpay 插件正常工作。

更新

转到 Magento2 的基本目录
执行以下命令以更新插件

magento module:disable Transbank_Webpay --clear-static-content
composer update
magento module:enable Transbank_Webpay --clear-static-content
magento setup:upgrade && magento setup:di:compile && magento setup:static-content:deploy

其他注意事项

Webpay solo trabaja con CLP! Si CLP no es tu moneda principal, no podrás usar este plugin en el proceso de checkout. Esto se encuentra en duro en payment model

Si no sabes como realizar esta configuracion puedes verlo en este documento

重新安装

转到 Magento2 的基本目录
执行以下命令以禁用和删除插件

magento module:disable Transbank_Webpay --clear-static-content
composer remove transbank/webpay-magento2:dev-master
rm -rf vendor/transbank/webpay*
rm -rf app/code/Transbank/Webpay*

遵循前面描述的安装过程。

开发环境

为了快速搭建开发环境，我们通过Docker Compose创建了容器规范。

要使用它，请遵循以下 README Magento 2

创建插件的安装程序

./package.sh

生成新版本

要生成新版本，需要创建一个PR（标题为"Prepare release X.Y.Z"，其中包含对应的X、Y和Z值）。必须遵循semver标准以确定是否增加X的值（如果有不兼容的更改）、Y（对于兼容的改进）或Z（如果只是修复了bug）。

在该PR中应包括以下更改

修改文件 CHANGELOG.md，在开头添加一个新条目（X.Y.Z），用西班牙语解释更改。
修改文件 etc/module.xml，将 setup_version 的值改为新的X.Y.Z。

在获得pull request的批准后，您需要合并到master并立即在GitHub上使用tag vX.Y.Z 生成一个release。在release的描述中，请添加与changelog中相同的内容。

这样Travis CI将自动生成新版本的插件，并使用zip文件更新GitHub上的Release。

transbank / webpay-magento2

维护者

详细信息