WooCommerce 商城
在 WordPress 后台直接安装 WordPress.org 上架的官方 Xcash for WooCommerce 插件,填入 App ID 与 HMAC 密钥即可开通加密货币结账,无需写代码。
插件安装与配置 →为 WooCommerce 商城增加加密货币结账,对接已有易支付 V1 系统,或通过 REST API 为自己的应用实现账单收款与充值收款。
在 WordPress 后台直接安装 WordPress.org 上架的官方 Xcash for WooCommerce 插件,填入 App ID 与 HMAC 密钥即可开通加密货币结账,无需写代码。
插件安装与配置 →应用已经支持易支付 V1 时,可使用兼容接口接入。按文档核对接口地址、参数、签名与通知处理逻辑。
易支付 V1 接口说明 →通过 REST API 实现自定义结账流程与用户充值,使用 HMAC-SHA256 签名认证,通过 Webhook 接收支付事件。
API 认证与签名 →官方 Xcash for WooCommerce 插件已上架 WordPress.org 插件目录;凭借易支付 V1 协议兼容,大量主流系统也能即插即用。
在 WordPress 后台「插件 → 安装插件」搜索 Xcash for WooCommerce 即可一键安装,为商店加上 USDT、USDC 等加密货币结账;支持区块结账与 HPOS,后续更新在后台直接推送。
只要支持标准易支付 V1 协议,无需改造原有对接逻辑,即可直接接入 Xcash。
Xcash 提供简洁的 RESTful 接口与 HMAC-SHA256 签名认证。几个 API 调用即可创建账单收款、生成专属充值地址;Webhook 实时推送收款事件,并携带 MistTrack 风险评分。
1import requests2import hmac, hashlib, json, time, uuid34API_BASE = "https://pay.xca.sh"5APPID = "XC-A3BK7NMG"6HMAC_KEY = "your_32_char_hmac_key_here"78def create_invoice():9 body = json.dumps({10 "out_no": "order-20240101-001",11 "title": "Premium Plan",12 "currency": "USD",13 "amount": "29.99"14 }, separators=(',', ':'), ensure_ascii=False)1516 timestamp = str(int(time.time()))17 nonce = str(uuid.uuid4())18 message = nonce + timestamp + body19 signature = hmac.new(20 HMAC_KEY.encode(), message.encode(), hashlib.sha25621 ).hexdigest()2223 resp = requests.post(24 f"{API_BASE}/v1/invoice",25 data=body,26 headers={27 "XC-Appid": APPID,28 "XC-Timestamp": timestamp,29 "XC-Nonce": nonce,30 "XC-Signature": signature,31 "Content-Type": "application/json"32 }33 )34 return resp.json()3536invoice = create_invoice()37print(f"Payment URL: {invoice['pay_url']}")
先选择符合业务的入账模式,再将支付状态与订单或余额系统连接起来。
为订单创建定额、限时的收款账单,使用业务订单号关联付款与订单状态。
创建收款账单 →为用户获取充值地址,在余额系统中处理到账事件,适用于用户随时转入的充值场景。
获取充值地址 →处理 Webhook 验签、重复投递与订单更新,需要核对账单状态时可结合查询接口对账。
处理 Webhook 回调 →在官方控制台创建项目,设置归集地址与支持的链币。
使用项目凭证配置插件或调用 API,设置支付通知接收地址。
完成一笔小额测试,核对订单更新、回调处理与实际到账,再向客户开放结账。