README

要求

安装 Magento 2.3（已在 Community Edition 2.3.2 和 PHP 7.2 上进行测试）
Magento < 2.3 应该也可以工作，但未进行测试。
您的 BTCPay 服务器必须设置 HTTPS

特性

允许您在 Magento 2 商店使用 BTCPay Server 进行支付
Magento 接收发票更新并更新订单状态
支持自定义 Magento 订单状态
在 Magento 管理员中查看创建的 BTC Pay 发票
Magento 还会轮询发票更新，作为实时更新未达到 Magento 时的安全措施
多站和多商店兼容

目标

此模块的目标是在没有其他第三方的情况下，允许 Magento 2 进行比特币、莱特币和其他加密货币支付。此模块还旨在设计为健壮、低维护和强大的基础，以供未来的定制使用，如果您的业务需要。

如何安装

安装过程与其他使用 composer 安装的任何其他 Magento 2 模块一样。以下是一些典型步骤

通过运行 composer 添加 Storefront_BTCPay 模块

composer require storefront/magento2-btcpay-module

启用新模块

php bin/magento module:enable Storefront_BTCPay

运行新模块的安装脚本

php bin/magento setup:upgrade

如何配置

安装后，在“商店 > 配置 > 销售 > 支付方式”中将可见新的支付方式。在那里配置字段。

您需要从 BTCPay Server 获取配对代码并输入。

它是如何工作的？

当在 Magento 中下订单并选择 BTCPay 作为支付方式时，客户将被重定向到您的 BTCPay Server 上的支付页面。
客户可以那里支付，或取消他的订单。
当他取消时，未支付的订单将被取消，释放预留库存，并将客户发送回购物车页面。此模块将恢复购物车的内容，因此客户不需要从头开始。
当客户支付时，BTCPay Server 将通知付款并向 Magento 信号更改的发票状态。
BTCPay Server 将支付状态更改推送到 Magento，但 Magento 也可以自行轮询发票更改。我们将其构建为安全措施，以防 BTCPay Server 无法连接到 Magento（例如，在开发期间，在防火墙后面）。
从 BTCPay Server 到 Magento 的发票更新是瞬时的。
Magento 每 5 分钟轮询 BTCPay Server 以获取更新。

支持哪些支付方式？

这取决于您对 BTCPay Server 的配置。您在 BTCPay Server 上激活的所有支付方式都将可供客户使用。

不支持什么？

只能为 BTCPay Server 配置一个域名，因此您不能有多个 BTCPay Server。一个用于整个 Magento 安装。

谁创建了此模块？

此模块由 Storefront 创建，Storefront 是一家来自比利时的小型 Magento 集成商，拥有超过 10 年的经验。访问我们的网站 www.storefront.be 了解更多信息。

此模块不包含任何广告，100% 开源且免费使用。

您为什么创建此模块？

现有的模块代码质量很差，没有遵循 Magento 2 最佳实践
支持度低（与 BTCPay Server 结合使用）
由于之前的模块基本上是为BitPay设计的，因此设置起来有些令人困惑。
我们现在有一个专门针对BTCPay的模块，因此BTCPay Server和此模块都可以自由创新，无需考虑BitPay的兼容性。
代码质量更高意味着维护更少，与未来Magento版本的兼容性也更容易。

如果我的BTCPay Server或Magento离线了一段时间，并且发票更新可能没有同步，我该怎么办？

Magento每5分钟轮询一次BTCPay Server以更新非完成的发票，因此基本上您不需要做任何事情。这由cronjob处理。如果您不想等待5分钟或者想了解正在发生的事情，我们准备了一个控制台命令来手动运行发票同步。

bin/magento btcpay:invoice:update

我能否从命令行进行配对？

是的，只需运行以下命令：

bin/magento btcpay:pair YOUR-PAIRING-CODE

未来的路线图是什么？

由于这是一个首次发布，我们希望从实际日常使用中学习更多，并首先专注于稳定性。
我们希望为您提供更简单的自动化测试，但为此我们需要在BTCPay Server中进行一些更改：[btcpayserver/btcpayserver#917](https://github.com/btcpayserver/btcpayserver/discussions/917)
支持配置多个BTCPay Server，因此您可以针对不同的网站/商店进行单独安装（优先级较低）。
实际上不需要其他任何东西，因为这个模块以稳健和可靠的方式完成了它需要做的事情。

如果我需要帮助怎么办？

就像任何其他开源软件一样，您可以从社区中得到帮助，或者在这里的GitHub上打开一个问题。

您可以在BTCPay Server Mattermost的#development频道与Wouter Samaey交谈。

如果您更喜欢专业的付费支持，您可以通过以下方式联系Storefront：info@storefront.be。

如果这个模块支持您的业务，请考虑获取付费支持（我们确实免费构建了这个模块），并捐赠给BTCPay Server的发展：https://btcpayserver.org/#makeADonation

designcoil / magento2-btcpay-module

维护者

详情