跳到正文

WHMCS 网关模块

在 WHMCS 中接受加密货币支付

让客户以加密货币支付 WHMCS 账单,款项直接进入您自己的钱包。本模块为预发布版:请先在“Test Mode”下试用。

示例

预发布版。已在 WHMCS 模拟环境中检验,尚未在已授权的 WHMCS 正式安装上试用。收取真实付款前,请先在测试模式下试用,并告诉我们效果如何。

功能介绍

WHMCS 版 ArionPay

WHMCS 版 ArionPay 是用于客户账单的支付网关模块。客户点击付款按钮,在 ArionPay 页面付款,资金直接进入您自己的钱包:ArionPay 从不持有这笔钱。
阅读更多ArionPay 确认付款后,会通过回调 URL 通知 WHMCS,付款随即添加到账单中。2.1.0 版尚未在已授权的 WHMCS 正式安装上试用,因此请先使用“Test Mode”。
  • 仅当 ArionPay 账单的金额和货币与 WHMCS 账单的余额和货币完全一致时,才会添加付款。
  • 再次点击付款按钮时,会沿用仍待支付的 ArionPay 账单。
  • ArionPay 账单 ID 即为该付款在 WHMCS 中的交易 ID。
  • 每次更新都会写入 Billing > Gateway Log,但绝不会写入任何密钥(key 或 secret)。
  • 无需向 ArionPay 粘贴任何内容:每张账单都会告诉 ArionPay 将付款更新发往何处。
  • 直接替换旧版 ArionPay 模块,并保留您已保存的“Public Key”、“Secret Key”和“API Base URL”。
示例

要求与许可证

适用于
WHMCS 8.x · PHP 7.4 或更高版本,需 cURL
测试情况
已在 WHMCS 模拟环境中检验,尚未在已授权的 WHMCS 正式安装上试用
费用
插件免费。ArionPay 每笔付款收取 0.5% 手续费,无月费。
源代码
在 GitHub 上开源(MIT),版本 2.1.0。

设置

5 步完成设置

设置位置:System Settings > Payment Gateways > All Payment Gateways > ArionPay Crypto
  1. 第 1 步

    复制文件

    将 zip 包中的内容复制到 WHMCS 主目录(即包含 configuration.php 的目录)。这会添加网关文件、回调文件和 arionpay 文件夹。

  2. 第 2 步

    启用网关

    进入 System Settings > Payment Gateways > All Payment Gateways,启用“ArionPay Crypto”。

  3. 第 3 步

    填入您的密钥

    将 ArionPay 控制台中的密钥分别粘贴到“Public Key”(pk_)、“Secret Key”(sk_)和“Webhook Secret”(whsec_)中。“API Base URL”保持原样。

  4. 第 4 步

    用模拟资金测试

    勾选“Test Mode”,在客户区用测试付款按钮支付一张未付账单,并确认它变为 Paid。Billing > Gateway Log 会显示具体经过。

  5. 第 5 步

    正式上线

    请确认您的 ArionPay 店铺设置中“Old ArionPay (v1) integration compatibility”已关闭。收取真实付款前,请取消勾选“Test Mode”。

设置完成后

账单状态如何变化

  • 付款按钮会创建一张 ArionPay 账单(或沿用仍待支付的那张),并将客户引导至 ArionPay 页面。
  • ArionPay 确认付款后,会通过回调 URL 通知 WHMCS,付款随即添加到账单中。
  • 金额准确的付款会自动确认;差额在您店铺付款容差(默认 1%)以内的付款同样如此。
  • 其他任何金额都会让账单保持未支付,并进入 Payment Radar,由您决定。如果您接受,这里的账单也会变为已支付。
  • 如果金额或货币与账单余额不一致,Gateway Log 会注明这一点,账单不会被标记为已支付。
  • 从支付页面返回并不会将账单标记为已支付。

9 个网络上的 16 种币和代币

全部币种
  • BTCBitcoin
  • ETHEthereum
  • USDTEthereum
  • USDCEthereum
  • BNBBNB Smart Chain
  • USDTBNB Smart Chain
  • USDCBNB Smart Chain
  • POLPolygon
  • USDTPolygon
  • USDCPolygon
  • TRXTRON
  • USDTTRON
  • LTCLitecoin
  • DOGEDogecoin
  • BCHBitcoin Cash
  • DASHDash

关于 WHMCS 版 ArionPay 的问题

安装前需要了解的简短解答。

这是预发布版。它在一个模拟网关所用 WHMCS 函数的替身环境和一台真实的 ArionPay 服务器上通过了 29 项检查,但尚未在已授权的 WHMCS 正式安装上试用。请先使用“Test Mode”。