README

Xendit PG集成插件，用于Magento 2.x

安装

系统要求

此模块已针对以下技术栈进行测试

如何

A. 使用Composer安装

Magento® 2 使用Composer管理模块包和库。Composer是PHP的依赖管理器。Composer声明您的项目所依赖的库，并将为您管理（安装/更新）它们。

检查Composer状态

通过运行以下命令检查您的服务器是否已安装composer

composer –v

如果您的服务器没有安装composer，您可以轻松安装它。 https://composer.php.ac.cn/doc/00-intro.md#installation-linux-unix-osx

使用Composer安装

1. 运行您的SSH控制台以连接到您的Magento® 2商店
2. 定位您的Magento® 2商店的根目录。
3. 在根目录下输入命令行，等待composer为您下载扩展

composer require xendit/m2invoice

完成后，您可以使用以下命令行激活扩展、清除缓存并在您的Magento®环境中部署内容：

• php bin/magento module:enable Xendit_M2Invoice
• php bin/magento setup:upgrade
• php bin/magento cache:clean

如果Magento®运行在生产模式下，部署静态内容

php bin/magento setup:static-content:deploy

安装后。前往您的Magento®管理门户，到 商店 > 配置 > 销售与结算 > 支付方式 > Xendit。

通过Composer更新

1. 运行您的SSH控制台以连接到您的Magento® 2商店
2. 定位您的Magento® 2商店的根目录。
3. 输入以下命令行并等待composer下载更新

composer update xendit/m2invoice

1. 输入以下命令以启动Magento®更新过程

• php bin/magento setup:upgrade
• php bin/magento cache:clean

1. 如果Magento®运行在生产模式下，部署静态内容

php bin/magento setup:static-content:deploy

B. 通过CLI安装

要安装此插件，您可以将插件文件手动复制到您的商店的web服务器中并启用它

1. 下载并解压插件源代码
2. 将内部的Xendit文件夹复制到您的商店的web服务器上的MAGENTO_DIR/app/code目录。默认情况下，您可能没有code文件夹，您可以手动创建它。

或者，您可以从Magento市场获取我们的免费插件，并通过composer安装它

1. 从MAGENTO_DIR，执行composer require xendit/m2invoice
2. 输入您的认证密钥。公钥是您的Magento市场的用户名，您的私钥是您的密码。
3. 等待Composer完成依赖项的更新。

代码放入MAGENTO_DIR后，继续运行以下命令

1. 从MAGENTO_DIR，运行以下命令
   1. php bin/magento module:status。您应该在禁用模块列表中看到Xendit_M2Invoice
   2. php bin/magento module:enable Xendit_M2Invoice
   3. php bin/magento setup:upgrade
   4. 再次运行php bin/magento module:status以确保Xendit_M2Invoice已启用。
   5. 您应该使用php bin/magento cache:flush清除Magento缓存
   6. 使用php bin/magento setup:di:compile编译带有新添加模块的Magento
   7. 编译完成后，运行php bin/magento setup:static-content:deploy -f
   8. 然后再次使用php bin/magento cache:flush清除缓存
2. 通过导航到商店 -> 配置 -> 销售与结算 -> 支付方式，您可以看到Xendit的设置页面
3. 一旦您在设置页面启用了Xendit，您应该在结账流程的支付部分看到Xendit的支付方式（信用卡和银行转账）。

C. 通过市场安装

自动订单取消

如果Xendit付款链接已过期，将通过webhook自动取消订单。

支持的付款方式

• 信用卡和借记卡
  • 分期付款
  • 订阅
• 虚拟账户
  • BCA
  • BJB
  • BNI
  • BRI
  • BSI
  • Mandiri
  • Permata
  • CIMB
• 零售网点
  • Alfamart
  • Indomaret
  • 7-Eleven (菲律宾)
  • ECPay 贷款 (菲律宾)
  • ECPay 学校 (菲律宾)
  • Cebuana (菲律宾)
  • M Lhuillier (菲律宾)
  • Palawan Express Pera Padala (菲律宾)
  • LBC (菲律宾)
• 电子钱包
  • OVO
  • DANA
  • LinkAja
  • QRIS
  • ShopeePay
  • GrabPay (菲律宾)
  • GCash (菲律宾)
  • PayMaya (菲律宾)
  • JeniusPay
• PayLater
  • Kredivo
  • BillEase (菲律宾)
  • Cashalo (菲律宾)
  • Uangme
  • AstraPay
  • Akulaku
• 直接借记
  • BRI
  • BPI (菲律宾)
  • UBP (菲律宾)
  • ChinaBank (菲律宾)
  • BDO (菲律宾)

退款支持

从v1.3.0版本开始，支持通过信用卡渠道进行在线退款（全额和部分退款）。

多配送支持

从v2.0.0版本开始，支持所有付款方式的多配送结账。

分期付款 & 订阅

从v2.2.0版本开始，商家可以通过信用卡设置分期付款和订阅付款方式。

单元测试

要运行单元测试，请在您的 MAGENTO_DIR 中运行以下命令

php bin/magento dev:tests:run unit

目前，还没有找到在Magento环境外运行测试的方法。

所有权

团队: TPI Team

Slack频道: #integration-product

Slack提及: @troops-tpi