README

Transbank Magento2 Webpay 插件

Webpay 的 Magento2 官方插件

描述

此官方插件允许您轻松地将 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 文件中

安装

注意：插件可以通过两种方式从 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仅支持CLP！如果CLP不是您的货币主要，您将无法在此 checkout 过程中使用此插件。这已在支付模型中硬编码。

如果您不知道如何进行此配置，可以在此文档中查看。

重装

进入 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（如果只是修复了错误）的值。

在此PR中应包含以下更改

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

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

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

rocket-ad / webpay-magento2

维护者

详情