为 Magento 2 接收加密货币付款。

安装

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

将 ZIP 解压到 Magento 根目录，然后以店铺文件所有者的身份运行这些命令。将 en_US 换成你的店铺语言代码。

php bin/magento module:enable WhollyCrypto_Payment
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f en_US
php bin/magento cache:flush

连接商店

打开 Stores → Configuration → Sales → Payment Methods → Wholly Crypto，选择店铺视图并启用该支付方式。

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

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

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

检查支付流程

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

Magento 只记录一张已付款发票。你可以在订单的 Payment Information 和备注中查看 Wholly 发票 ID 及验证结果。

补回遗漏的更新

Magento cron 每五分钟检查一次已保存的发票。你也可以在店铺目录中手动运行检查。

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