Integrations

将 Xcash 接入你的业务

为 WooCommerce 商城增加加密货币结账,对接已有易支付 V1 系统,或通过 REST API 为自己的应用实现账单收款与充值收款。

Paths

选择适合你的接入方式

01

WooCommerce 商城

在 WordPress 后台直接安装 WordPress.org 上架的官方 Xcash for WooCommerce 插件,填入 App ID 与 HMAC 密钥即可开通加密货币结账,无需写代码。

插件安装与配置 →
02

易支付 V1 系统

应用已经支持易支付 V1 时,可使用兼容接口接入。按文档核对接口地址、参数、签名与通知处理逻辑。

易支付 V1 接口说明 →
03

自研应用

通过 REST API 实现自定义结账流程与用户充值,使用 HMAC-SHA256 签名认证,通过 Webhook 接收支付事件。

API 认证与签名 →
Plugins

接入你现有的技术栈

官方 Xcash for WooCommerce 插件已上架 WordPress.org 插件目录;凭借易支付 V1 协议兼容,大量主流系统也能即插即用。

WordPress · WooCommerce

Xcash for WooCommerce

WordPress.org 官方目录

在 WordPress 后台「插件 → 安装插件」搜索 Xcash for WooCommerce 即可一键安装,为商店加上 USDT、USDC 等加密货币结账;支持区块结账与 HPOS,后续更新在后台直接推送。

WordPressWooCommerce区块结账HPOS
易支付生态

兼容易支付 V1 的系统

即插即用

只要支持标准易支付 V1 协议,无需改造原有对接逻辑,即可直接接入 Xcash。

XboardV2boardNew API独角数卡异次元发卡 WHMCS 开发中
查看接入文档
API

简洁的 REST API
几分钟完成接入

Xcash 提供简洁的 RESTful 接口与 HMAC-SHA256 签名认证。几个 API 调用即可创建账单收款、生成专属充值地址;Webhook 实时推送收款事件,并携带 MistTrack 风险评分。

PythoncURLNode.jsPHPGo
1import requests
2import hmac, hashlib, json, time, uuid
3
4API_BASE = "https://pay.xca.sh"
5APPID = "XC-A3BK7NMG"
6HMAC_KEY = "your_32_char_hmac_key_here"
7
8def 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)
15
16 timestamp = str(int(time.time()))
17 nonce = str(uuid.uuid4())
18 message = nonce + timestamp + body
19 signature = hmac.new(
20 HMAC_KEY.encode(), message.encode(), hashlib.sha256
21 ).hexdigest()
22
23 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()
35
36invoice = create_invoice()
37print(f"Payment URL: {invoice['pay_url']}")
REST API

通过 REST API 构建收款流程

先选择符合业务的入账模式,再将支付状态与订单或余额系统连接起来。

账单收款

为订单创建定额、限时的收款账单,使用业务订单号关联付款与订单状态。

创建收款账单 →

充值收款

为用户获取充值地址,在余额系统中处理到账事件,适用于用户随时转入的充值场景。

获取充值地址 →

支付通知

处理 Webhook 验签、重复投递与订单更新,需要核对账单状态时可结合查询接口对账。

处理 Webhook 回调 →
Go live

从配置到第一笔收款

  1. 01

    在官方控制台创建项目,设置归集地址与支持的链币。

  2. 02

    使用项目凭证配置插件或调用 API,设置支付通知接收地址。

  3. 03

    完成一笔小额测试,核对订单更新、回调处理与实际到账,再向客户开放结账。

Xcash,天生安全

开始用 Xcash 收款

官方云服务几分钟开通,免部署、免运维;每月首 $500 交易 0 手续费。