页面导航
ZH
主机计费系统

WISECP 加密货币支付

在 WISECP 发票和订单上收取加密货币。客户选择「SnapEX Pay — crypto (USDT and other coins)」,在 SnapEX Pay 付款页面用 TRON、Ethereum、BSC 等网络上的 USDT 支付,或用兑换为 USDT 的其他币种支付,发票在 WISECP 中自动标记为已付款。

下载模块 GitHub

免费。版本 1.0.2。

功能

  • 无需运行钱包或节点:资金进入你的 SnapEX Pay 商户余额。
  • 付款通过签名 webhook 记录,或在客户从付款页面返回时立即记录,以先到者为准。两种情况下都会先从 SnapEX Pay API 重新读取发票:仅凭 webhook 内容不会将任何东西标记为已付款,同一笔付款也绝不会记录两次。
  • 在付款确认前返回的客户会看到一个状态页面,每 10 秒重新检查一次,确认后自动跳转到 WISECP 的「付款成功」页面。
  • 部分付款以待处理(pending)状态上报,收到的金额写在付款备注中,由你审核后再批准。
  • 测试模式:测试发票无需真实资金即可自动确认;开启期间只有已登录的管理员能看到付款按钮。
  • 不新增数据库表:模块将数据保存在 WISECP 的 checkout 中。后台文字支持英语、土耳其语和俄语。
  • 币种:USDT(TRC20、ERC20、BEP20)适用于任意金额的账单;网络手续费允许时,BTC、ETH、LTC 和 TRX 也可用于更小金额的账单;其他币种适用于 $8 起的账单。

安装

  1. 将压缩包内容上传到 WISECP 根目录,保持路径 coremio/modules/Payment/SnapexPay/。
  2. 在 WISECP 后台打开支付网关设置,在模块中找到 SnapEX Pay (Crypto),启用并打开其设置。WISECP 5:Payment Gateways → 在 Enabled Module Selection 中添加该模块,保存后打开它的卡片。
  3. 在 SnapEX Pay 商户后台创建一个具有 invoices.read 和 invoices.write 权限的 API 密钥,粘贴到 API key 字段。
  4. 在商户后台添加 webhook,URL 使用 Webhook secret 字段下方显示的地址(WISECP 3 为 https://<你的 WISECP>/payment/SnapexPay/<token>/callback,WISECP 5 为 …/payments/SnapexPay/<token>/callback;请从设置页面复制),并将 whsec_… 密钥粘贴到 Webhook secret。客户没有返回网站时,付款就通过 webhook 到达。
  5. 如果你的发票不是 USD,请在 WISECP 货币中保留 USD 并设置汇率:模块会按 WISECP 的汇率将金额换算为 USD。如果你把网关设置为转换为 USD,WISECP 会直接以 USD 传递金额,无需换算。
  6. 开启 Test mode,保持后台登录状态,在同一浏览器的客户区打开一张未付款发票,在 SnapEX Pay 页面用测试方式付款,确认发票变为已付款。然后关闭测试模式。

设置

API key来自 SnapEX Pay 商户后台。
Webhook secret商户后台 webhook 设置中的 whsec_…。webhook URL 显示在该字段下方。
Network fee paid byMerchant:客户只需支付发票金额。Client:网络费用加在金额之上。
Payment window, minutes付款页面的有效时长(1–1440,默认 60)。之后再次付款会打开新的页面。
Test mode测试发票,仅限已登录的管理员。关闭测试模式后,测试付款会被忽略。
Partner ID可选:为你安装模块的集成商的 Partner ID(SnapEX Pay 推荐计划)。自己安装则留空。
API URL保持不变。

常见问题

支持哪些 WISECP 版本?

WISECP 3 和 WISECP 5。已在真实的 WISECP 5.0-beta.3 环境中完整验证:webhook、客户返回以及返回之后迟到的 webhook,每种情况都只记录一笔付款。

为什么要添加 webhook?

如果客户付款后没有返回网站,付款就通过签名 webhook 到达 WISECP。客户返回时付款会立即记录,且绝不会重复记录。

我的发票不是 USD,能用吗?

可以。在 WISECP 货币中保留 USD 并设置汇率,模块会按 WISECP 的汇率换算金额。或者把网关设置为转换为 USD,WISECP 会以 USD 传递金额。

发票付款后 WISECP 中会显示什么?

付款以成功状态上报,WISECP 将发票(或订单)标记为已付款。交易 ID 为 SnapEX Pay 发票号(INV-…),付款备注中注明客户用什么币种支付。

客户支付金额少于发票金额怎么办?

如果客户没有及时补足,付款会以待处理(pending)状态上报,收到的金额写在备注中。请在批准前审核。

付款页面过期且未付款怎么办?

不会记录任何内容,客户可以重新付款。如果发票关闭后才收到款项,会在 WISECP 模块日志中记录一条;资金在你的 SnapEX Pay 余额中。

在哪里查看模块做了什么?

在 WISECP 模块日志中:API 错误和每笔已记录的付款都会写入日志。API 密钥和 webhook 密钥从不写入日志。

准备好接收加密货币了吗?

创建商户账户,获取 API 密钥并连接模块。每笔支付 1%,无月费。