账单收款 + 充值收款,资金直达你的归集地址
全程不托管资金,支持主流 EVM 链与 Tron。资金经智能合约直达你的钱包,即便数据库被拖库也无法被盗。订阅套餐即可使用,交易免手续费,链上 Gas 按实耗结算。
TU9UkV…Ji13U
智能合约
这是一套非托管收款网关:不依赖任何私钥或助记词来存放资产。所有收款经智能合约直接流入你的商户钱包,资金流向被写死、只会也只能流向你。平台只负责账单匹配、状态流转与通知,全程不接触、也不托管资金。正因为从不以私钥保管任何资产,即便数据库被拖库、服务器被入侵,也没有可供盗取的资金。
从不以私钥或助记词托管资金,资金直接进入你的商户钱包——系统里没有保管资产的钥匙,自然无从被盗。
收款经智能合约把流向写死为你的商户钱包,只会、也只能流向你,攻击者改不动。
收款合约只做一件事:把资金送到你的归集地址。逻辑越少,可乘之机越少。
两种入账方式覆盖全部收款场景,接入前先区分,按业务选择即可。
每笔交易创建一张定额、限时的账单,买家付款后账单完成。支持钱包直收与智能合约:可直接收进项目钱包,也可为每张账单分配独立合约地址并自动归集。
为每个用户分配专属充值收款地址,多链共享、实时监控。用户可随时转入,区块确认后即时入账,无需创建订单,体验同交易所。
从建单、收款、归集到通知,一套系统全部覆盖。
系统按延迟与金额门槛批量归集,单次归集接近普通转账,只需少量链上 Gas,资金自动落到你的归集地址。
覆盖主流 EVM 链,支持任意 ERC-20 代币,以及 Tron 上的 USDT 与原生 TRX。
可为每笔账单生成独立合约地址,付款确认后自动归集,地址互不冲突,归集开销接近普通转账。
单实例隔离管理多个商户与项目,各自独立的鉴权、签名密钥与归集地址。
对收款来源地址做风险评分,API 与 Webhook 均携带 risk_level 与 risk_score。
实时推送账单收款与充值收款事件,失败自动重试,基于 nonce 幂等去重。
支持标准易支付协议,便于从旧系统平滑迁移,无需重写对接逻辑。
提供免签名的账单状态查询接口,便于前端轮询展示支付结果,也可用于对账核销。
把常见加密收款方案放在一起,差异一目了然。
| 本平台 | 第三方托管服务商 | BTCPay Server | |
|---|---|---|---|
| 资金托管 | 非托管,直达你的钱包 | 代收后按结算周期放款 | 非托管 |
| 平台手续费 | 0 / 免手续费 | 通常按笔抽取 0.4%–1% | 0 |
| KYC / 开户审核 | 无 | 通常需要 | 无 |
| EVM + Tron 稳定币 | 任意 ERC-20,含 Tron USDT | 视服务商而定 | 以 BTC 为主,插件扩展 |
| 交易所式充值地址 | 内置 | 少见 | — |
| 易支付 V1 协议 | 兼容 | — | — |
| 订阅与预付费计费 | 内置 | 按平台规则 | 需自行扩展 |
对比基于各方案公开资料,仅供选型参考。
EVM 链支持任意 ERC-20 代币,可接入 USDT、USDC 或其他链上资产;Tron 支持 USDT 与原生 TRX。
支持的链与币种会持续增加,具体可用组合以商户中心展示为准。
提供 RESTful 接口与 HMAC-SHA256 签名认证。几个调用即可创建账单收款、生成专属充值地址;Webhook 实时推送收款事件并携带风险评分。
import hashlib, hmac, json, time, uuid, requests
API_BASE = "https://pay.example.com"
APPID = "XC-XXXXXXXX"
HMAC_KEY = "your_hmac_key"
body = json.dumps({
"out_no": "order-20260101-001",
"title": "Premium Plan",
"currency": "USD",
"amount": "29.99",
"duration": 15,
}, separators=(",", ":"), ensure_ascii=False)
timestamp = str(int(time.time()))
nonce = uuid.uuid4().hex
signature = hmac.new(
HMAC_KEY.encode(),
(nonce + timestamp + body).encode(),
hashlib.sha256,
).hexdigest()
resp = requests.post(
f"{API_BASE}/v1/invoice",
data=body.encode("utf-8"),
headers={
"Content-Type": "application/json",
"XC-Appid": APPID,
"XC-Timestamp": timestamp,
"XC-Nonce": nonce,
"XC-Signature": signature,
},
)
print(resp.json()["pay_url"]) # 跳转到该地址完成付款
BODY='{"out_no":"order-20260101-001","title":"Premium Plan","currency":"USD","amount":"29.99"}'
TS=$(date +%s)
NONCE=$(openssl rand -hex 16)
SIG=$(printf '%s' "${NONCE}${TS}${BODY}" | openssl dgst -sha256 -hmac "$HMAC_KEY" -hex | awk '{print $2}')
curl -sS -X POST "$API_BASE/v1/invoice" \
-H "Content-Type: application/json" \
-H "XC-Appid: $APPID" \
-H "XC-Timestamp: $TS" \
-H "XC-Nonce: $NONCE" \
-H "XC-Signature: $SIG" \
-d "$BODY"
<?php
$body = json_encode([
'out_no' => 'order-20260101-001',
'title' => 'Premium Plan',
'currency' => 'USD',
'amount' => '29.99',
'duration' => 15,
], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
$timestamp = (string)time();
$nonce = bin2hex(random_bytes(16));
$signature = hash_hmac('sha256', $nonce . $timestamp . $body, $hmacKey);
$ch = curl_init($apiBase . '/v1/invoice');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $body,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'XC-Appid: ' . $appid,
'XC-Timestamp: ' . $timestamp,
'XC-Nonce: ' . $nonce,
'XC-Signature: ' . $signature,
],
]);
$result = json_decode(curl_exec($ch), true);
header('Location: ' . $result['pay_url']);
import hashlib, hmac, time, uuid, requests
from urllib.parse import urlencode
timestamp = str(int(time.time()))
nonce = uuid.uuid4().hex
# GET 请求没有 body,签名时用空字符串拼接
signature = hmac.new(
HMAC_KEY.encode(),
(nonce + timestamp).encode(),
hashlib.sha256,
).hexdigest()
params = {"uid": "user-10001", "chain": "base", "crypto": "USDC"}
resp = requests.get(
f"{API_BASE}/v1/deposit/address",
params=params,
headers={
"XC-Appid": APPID,
"XC-Timestamp": timestamp,
"XC-Nonce": nonce,
"XC-Signature": signature,
},
)
print(resp.json()["deposit_address"]) # 展示给用户充值
TS=$(date +%s)
NONCE=$(openssl rand -hex 16)
SIG=$(printf '%s' "${NONCE}${TS}" | openssl dgst -sha256 -hmac "$HMAC_KEY" -hex | awk '{print $2}')
curl -sS -G "$API_BASE/v1/deposit/address" \
--data-urlencode "uid=user-10001" \
--data-urlencode "chain=base" \
--data-urlencode "crypto=USDC" \
-H "XC-Appid: $APPID" \
-H "XC-Timestamp: $TS" \
-H "XC-Nonce: $NONCE" \
-H "XC-Signature: $SIG"
<?php
$timestamp = (string)time();
$nonce = bin2hex(random_bytes(16));
$signature = hash_hmac('sha256', $nonce . $timestamp, $hmacKey);
$url = $apiBase . '/v1/deposit/address?' . http_build_query([
'uid' => 'user-10001',
'chain' => 'base',
'crypto' => 'USDC',
]);
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'XC-Appid: ' . $appid,
'XC-Timestamp: ' . $timestamp,
'XC-Nonce: ' . $nonce,
'XC-Signature: ' . $signature,
],
]);
$result = json_decode(curl_exec($ch), true);
echo $result['deposit_address'];
import hashlib, hmac
from flask import Flask, request
app = Flask(__name__)
seen = set() # 生产环境请换成 Redis 等持久化去重
@app.post("/xcash/webhook")
def webhook():
raw = request.get_data()
nonce = request.headers.get("XC-Nonce", "")
timestamp = request.headers.get("XC-Timestamp", "")
signature = request.headers.get("XC-Signature", "")
expected = hmac.new(
HMAC_KEY.encode(),
nonce.encode() + timestamp.encode() + raw,
hashlib.sha256,
).hexdigest()
if not hmac.compare_digest(expected, signature):
return "invalid signature", 401
if nonce in seen: # 按 nonce 幂等去重
return "ok", 200
seen.add(nonce)
payload = request.get_json()
if payload.get("type") == "invoice":
data = payload["data"]
credit(data["out_no"], data["pay_amount"]) # 按商户单号入账
return "ok", 200 # 必须是 200 + 响应体 ok
# 用同一套 HMAC 口径本地复算签名,比较后再处理业务
RAW=$(cat /tmp/webhook_body.json)
TS="1735689600"
NONCE="6f1c2f2b8a5e4d3f9c0a1b2c3d4e5f60"
SIG=$(printf '%s' "${NONCE}${TS}${RAW}" | openssl dgst -sha256 -hmac "$HMAC_KEY" -hex | awk '{print $2}')
# 与请求头 XC-Signature 比对一致后,返回:
# HTTP 200
# 响应体:ok
printf 'ok'
<?php
$raw = file_get_contents('php://input') ?: '';
$nonce = $_SERVER['HTTP_XC_NONCE'] ?? '';
$timestamp = $_SERVER['HTTP_XC_TIMESTAMP'] ?? '';
$signature = $_SERVER['HTTP_XC_SIGNATURE'] ?? '';
$expected = hash_hmac('sha256', $nonce . $timestamp . $raw, $hmacKey);
if (!hash_equals($expected, $signature)) {
http_response_code(401);
exit;
}
// 幂等:同一个 XC-Nonce 只处理一次
if (!nonceSeenBefore($nonce)) {
$payload = json_decode($raw, true);
if (($payload['type'] ?? '') === 'invoice') {
$data = $payload['data'] ?? [];
credit($data['out_no'], $data['pay_amount']); // 按商户单号入账
}
}
echo 'ok'; // 必须是 200 + 响应体 ok,否则网关判定投递失败
只要支持标准易支付 V1 协议,无需改造原有对接逻辑,即可直接接入;也可按 REST API 自行对接任意技术栈。
Xboard、V2board、异次元发卡、WHMCS 等支持易支付协议的系统可直接接入。
WordPress / WooCommerce 等系统通过易支付插件即可对接,无需二次开发。
所有套餐均免交易手续费,只按套餐收订阅费;套餐决定成功支付账单数上限与支持服务。
注册即为免费套餐,可随时升级;套餐变更即时生效。