在 WooCommerce 和 Shopify 中接入加密货币支付
如果您已经在 WooCommerce 或 Shopify 上经营店铺,添加加密货币并不需要推倒重来。它只是一种新的付款方式,与现有的付款方式并列,接入的方法也只有两种:安装插件并粘贴 API 密钥,或者在自己的代码中调用网关的 REST API。选哪一种,与其说取决于技术能力,不如说取决于您想掌控多少收银流程。
首先,想清楚为什么要做
加密货币很少能取代银行卡。满足下面任意一条时,它值得添加;一条都不满足时,可以先不做:
- 您的客户所在的地区,银行卡收单不稳定或成本很高。
- 您销售数字商品,拒付欺诈是实实在在的成本。链上付款无法撤销。
- 您的客户已经持有稳定币,并且主动要求用它付款。
- 您希望有一种不依赖单一收单关系的付款方式。
把原因想清楚,也就知道这次集成值得投入多少精力。“有几个客户问过”指向插件方式。“我们三分之一的市场就是这么付款的”则值得认真做好。
方式一:使用插件
在现成的平台上,最快的路径是使用对应的 VisualPay 插件。安装插件,粘贴商户 API 密钥,选择要接受的币种和网络,加密货币就会作为一个选项出现在结账页。不需要写代码。
当您经营的是标准店铺,主题的结账页接近默认状态,并且希望本周而不是本季度就上线加密货币时,这是合适的选择。
设置步骤依次为:
- 创建 VisualPay 账户并开启两步验证。这是创建商户的前提。
- 创建商户,并为您打算接受的每个币种和网络填写自己的钱包地址。结算款会发送到这里。
- 从面板中的商户详情页复制商户 API 密钥。
- 在店铺中安装插件并粘贴密钥。
- 选择币种和网络,并设置支付手续费由谁承担。
- 在对外公布之前,先完整地下一笔小额的真实订单。
方式二:直接调用 API
如果您的店铺是无头架构,结账流程经过大量定制,或者只有一部分业务跑在平台上,直接调用 API 可以让您完全掌控。创建交易只需要一次 POST,得知已付款只需要一个 Webhook。
POST https://visualpay.net/api/v1/merchant/transaction/create
x-api-key: YOUR_MERCHANT_API_KEY
Content-Type: application/json
{
"currency_symbol": "USDT",
"network_code": "trc20",
"amount_usd": 149.00,
"ttl": 30,
"order_id": 10432,
"email": "buyer@example.com",
"callback_url": "https://yourstore.com/checkout/crypto/return"
}
响应会给您收款地址、精确的加密货币金额和一个跟踪码。因为没有任何东西强制跳转,您可以把这些内容呈现在自己的结账步骤里:同样的主题、同样的域名、同样的语言。把跟踪码与订单关联保存,从此以后它就是您追踪这笔付款的凭据。
当您希望加密货币这一步看起来与结账流程的其他部分一致,当您的订单流程无法干净地套进平台的支付网关抽象,或者您本来就习惯维护 Webhook 接口时,这是合适的选择。
把付款状态映射到订单状态
集成最常在这里出问题,值得说清楚。加密货币交易有一些您的店铺原生无法理解的状态,所以在动手之前先确定映射关系:
- 待付款:账单已开启但尚未付款。让订单保持挂起状态。不要无限期占用稀缺库存,有效期窗口会告诉您什么时候释放。
- 已确认:已付款并在链上完成结算。把订单改为处理中或已完成,并履行订单。这是唯一应当触发履约的状态。
- 超额支付:付款被接受,收到的金额多于应付金额。按已付款处理,并对多出的部分执行您的政策:店铺余额或手动退款。
- 已过期:窗口关闭时仍未付款。取消订单并释放库存。没有产生任何扣费。
- 已取消:买家主动放弃。处理方式与已过期相同。
无论选哪种方式,API 指南中的规则都依然适用:把买家带回成功页面的回调跳转只是用户体验,不是付款证明。请依据 Webhook 或服务端的状态查询来履约,绝不能仅凭浏览器加载了某个 URL。
选择币种和网络
选项并不是越多越好。有十四个下拉选项的结账页,转化率不如只有三个选项的,而且每多一个网络,就多一个必须填对的钱包地址。
对大多数店铺来说,可以先从 TRC20 上的 USDT(手续费低,持有者非常多)、BEP20 上的 USDT(同样便宜,在交易所用户中很常见)开始;如果您的买家偏好 USDC,再加上 ERC20 上的 USDC。只有客户真的提出需求时再增加。VisualPay 支持按商户启用币种和网络,所以这份清单只是一项设置,不需要重做;如果您经营多个店铺,每个店铺都可以有自己的清单。
定价与手续费
VisualPay 对每笔成功的交易收取一个固定比例,没有月费,也没有出款佣金。您可以选择由收银流程的哪一方承担。把手续费转给买家,账单金额会相应上调,您的订单全额入账,账务保持清晰。由商户承担,买家看到的就是他们预期的整数金额,这在面向消费者的店铺里通常转化率更高。
由于结算是非托管的,一旦各网络的阈值达到,已确认的付款就会直接进入您填写的钱包地址,通常在一分钟内完成,只扣除链上本身的网络费。中间没有出款周期,也没有提现申请。
对外公布之前先测试
这一步不要跳过,也不要只测试顺利的情况:
- 下一笔小额的真实订单并完成付款。确认订单会自动变为已付款,不需要任何人去后台操作。
- 创建一个订单,让它在未付款的情况下过期。确认订单被取消、库存被释放。
- 故意少付一小笔金额。确认实际表现与您设置的少付容差一致。
- 检查确认邮件和面向客户的订单页面,对加密货币订单来说是否都说得通。
- 确认结算款确实到了您自己的钱包,而不只是订单显示已付款。
该选哪种方式
如果您的店铺接近默认配置,并且希望以最少的维护成本快速上线加密货币,请选择插件方式。如果您的结账流程是定制的,采用无头架构,或者让买家在付款环节始终留在自己的域名上对您很重要,请选择 API 方式。
两种方式连接的是同一个网关,结算到同样的钱包。插件用一点控制权换来了大量的速度;API 用一天的工作量换来了对体验的完全掌控。无论先选哪一种,以后都可以改用另一种。