让 Shopware 5 和 6 接受加密货币付款。

安装

下载安装包并核对 SHA256SUMS，不要使用 GitHub 自动生成的源码 ZIP。

Shopware 5

whollycrypto-shopware5-1.0.0.zip

Configuration → Plugin Manager → Installed → Upload plugin

Shopware 6

whollycrypto-shopware6-1.0.0.zip

Extensions → My extensions → Upload extension

安装并启用插件，然后打开对应子商店或销售渠道的设置。

在商店的付款方式中启用 Wholly Crypto。使用 Shopware 6 时，还要将它分配给销售渠道。

连接商店

填写 API 和收银台源地址、项目和商店的 API UUID、仅限该项目的读写 API 凭据，以及商店的 IPN 签名密钥。在 Wholly 中启用 IPN，回调地址由插件提供。

同时填写商店的公开 HTTPS 网址，包括语言或安装子目录。

让 IPN 回调通过防火墙，不要要求验证码或浏览器登录。正式上线前，先在测试商店完成一笔付款测试。

钱包密钥保留在 Wholly Crypto 中。插件不收取额外百分比费用，处理额度的计费规则仍然适用。

检查支付流程

未确认或部分付款会保持待处理状态。匹配的已结算付款只更新订单一次。多付、迟付、无效付款或修改过的订单需要检查。浏览器跳转回来并不代表付款成功。

Shopware 5 的账单信息在订单内部备注中，Shopware 6 的则在订单的 Wholly Crypto 自定义字段中。

补回遗漏的更新

在商店目录中运行此命令，检查已保存的账单，不会创建重复账单。你可以安排每五分钟运行一次。

php bin/console whollycrypto:reconcile --limit=50