ZH
网店

CS-Cart 加密货币支付

在 CS-Cart 中接收加密货币。客户在结账时选择加密货币,在 SnapEX Pay 页面使用 TRON、Ethereum、BSC 等网络上的 USDT,或兑换为 USDT 的其他币种付款,订单自动变为 Processed。

下载模块

免费。版本 1.1.0。

功能

  • 无需运行钱包或节点:资金进入您的 SnapEX Pay 商户余额。
  • CS-Cart 和 CS-Cart Multi-Vendor:在 Multi-Vendor 中,包含多个卖家的订单只需支付一次;插件结算父订单,CS-Cart 再把状态传递给各卖家订单。
  • 订单通过四种独立方式结算:签名 Webhook、客户从支付页面返回、可选的 cron 检查(每笔待处理付款最多每 10 分钟一次,持续 5 天),以及管理员打开订单。丢失的 Webhook 不会让已付订单停留在未支付状态,付款也不会被重复应用。
  • 金额始终从 SnapEX Pay API 重新读取;仅凭 Webhook 内容不会更改任何订单。
  • 测试模式:测试账单无需真实资金即可自动确认。

安装

  1. Add-ons → Manage add-ons → +(Upload & install add-on)→ snapexpay-cscart-1.1.0.zip。(或将 app/、design/、var/ 复制到店铺根目录,然后从列表中安装 SnapEX Pay。)
  2. Administration → Payment methods → + → 处理器 SnapEX Pay (crypto),模板 cc_outside.tpl,名称例如 "Crypto (USDT and other coins)"。
  3. 在 Configure 选项卡中填入来自 SnapEX Pay 商户后台的 API 密钥(权限 invoices.read 和 invoices.write)。
  4. Webhook(推荐):在后台设置 Webhook secret 下方显示的 Webhook URL(https://<store>/index.php?dispatch=payment_notification.webhook&payment=snapexpay),并填入 whsec_… 密钥。
  5. 可选:将 Payment check 下方显示的 cron 行添加到服务器 crontab。
  6. 测试:开启 Test mode,将该支付方式限制给测试用户组,下单,在 SnapEX Pay 页面用测试方式付款,检查订单变为 Processed。然后关闭测试模式。

设置

API key来自 SnapEX Pay 后台。
Webhook secret后台 Webhook 设置中的 whsec_…。没有它,订单仍会在客户返回时、cron 检查时以及管理员打开订单时结算。
Network fee paid byMerchant:客户准确支付订单金额,手续费从您的到账金额中扣除。Customer:SnapEX Pay 手续费和网络费用加在其上。
Payment window, minutes支付页面的有效时长(1–1440,默认 60)。之后重新支付会打开新的页面。
Test mode测试账单。关闭后测试付款永不生效。
Partner ID可选:为您配置此模块的集成商的 Partner ID(SnapEX Pay 推荐计划)。如果是您自己安装,请留空。

常见问题

支持 CS-Cart Multi-Vendor 吗?

支持。包含多个卖家的订单只需支付一次:插件结算父订单,CS-Cart 再把状态传递给各卖家订单。

我的店铺币种不是 USD,可以使用吗?

可以,只要 USD 在店铺币种中(可以是次要币种)。订单金额按店铺自己的 USD 汇率(Administration → Currencies)换算,请保持该汇率为最新。

插件会设置哪些订单状态?

客户返回前为 Incomplete,付款确认期间为 Open,全额付款后为 Processed。过期未付的 Open 订单变为 Failed;Incomplete 订单保持不变,以便客户重新支付。

如果客户付款少于订单金额怎么办?

如果客户未及时补足,SnapEX Pay 会将账单关闭为部分支付,订单被设为 Open,并附注提示您在 SnapEX Pay 后台核对付款并手动完成订单。

可以从 CS-Cart 退款吗?

不可以。退款在 SnapEX Pay 后台进行。

卸载插件会怎样?

使用 SnapEX Pay 的支付方式会被停用,其 SnapEX Pay 设置会被清除;付款历史表(snapexpay_invoices)会保留,以便日后重新安装。

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

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