README

Transbank Magento2 Webpay 插件

Webpay 的 Magento2 官方插件

描述

此官方插件允许您轻松地将 Webpay 集成到您的 Magento2 网站中。它基于官方 PHP SDK 开发。

如何安装？

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

进入生产环境

安装插件后，它会默认配置为在 Transbank 测试环境中以 '集成' 模式运行。若要使用真实货币进行操作（生产环境），您必须

拥有自己的商户代码。如果没有，请在 transbank.cl 申请 Webpay Plus。
完成验证表单。您必须选择 用于插件集成 的链接。
在插件设置中配置 Transbank 提供的 API Key。
您需要在生产环境中进行一次价值 50 美元的购买以确认插件运行正常。

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

开发

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

依赖

需要 Composer

该插件依赖于以下库

transbank/transbank-sdk
tecnickcom/tcpdf

注意

PHP SDK 版本位于 composer.json 文件中
插件版本位于 composer.json 和 etc/module.xml 文件中
建议在修改代码时使用开发 docker

安装

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

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

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

composer config repositories.transbankwebpay vcs https://github.com/TransbankDevelopers/transbank-plugin-magento2-webpay-rest.git
composer require transbank/webpay-magento2-rest: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，则无法在此插件中使用的结账过程中使用此插件。这在支付模型中是硬编码的

如果您不知道如何进行此配置，请参阅此文档

重新安装

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

magento module:disable Transbank_Webpay --clear-static-content
magento module:uninstall 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描述中，应填写与changelog中相同的内容。

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

rocket-ad / webpay-magento2-rest-pending

维护者

详细信息