Documentation Index
Fetch the complete documentation index at: https://docs.xpaylabs.com/llms.txt
Use this file to discover all available pages before exploring further.
创建一个新的收款订单。网关为指定的区块链和代币生成一个唯一的充值地址。您的客户将资金发送到此地址，区块链扫描器自动检测交易。
POST http://your-gateway:3010/v1/order/createCollection
请求头
| 头部 | 值 |
|---|
Content-Type | application/json |
请求体参数（data 字段）
支付金额，十进制字符串格式，例如 "100.00"。必须大于零。
要接受的代币符号，例如 "USDT"。必须是指定链上支持的代币。
区块链网络：
TRON — TRC20 代币（USDT、USDC）ETH — Ethereum ERC20BSC — BNB Smart Chain BEP20POLYGON — PolygonAVAX_C_CHAIN — Avalanche C-ChainSUI — SUI Network
您的唯一订单标识符。V3 商家必填。用于将收款与您的内部订单系统关联。
您的内部用户标识符。V2 商家必填。不能为 "0"。
cURL
curl -X POST http://your-gateway:3010/v1/order/createCollection \
-H "Content-Type: application/json" \
-d '{
"sign": "a1b2c3d4e5f6...",
"timestamp": 1717000000,
"nonce": "550e8400-e29b-41d4-a716-446655440000",
"data": {
"amount": "250.00",
"symbol": "USDT",
"chain": "TRON",
"orderId": "order_1042"
}
}'
Node.js
import crypto from "crypto";
const MERCHANT_TOKEN = process.env.XPAYLABS_TOKEN;
function signRequest(data) {
return crypto
.createHmac("sha256", MERCHANT_TOKEN)
.update(JSON.stringify(data), "utf8")
.digest("hex");
}
const data = { amount: "250.00", symbol: "USDT", chain: "TRON", orderId: "order_1042" };
const payload = {
sign: signRequest(data),
timestamp: Math.floor(Date.now() / 1000),
nonce: crypto.randomUUID(),
data,
};
const response = await fetch("http://your-gateway:3010/v1/order/createCollection", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(payload),
});
const result = await response.json();
console.log(result.data.address); // 充值地址
console.log(result.data.paymentUrl); // 结账 URL
成功的请求返回 HTTP 200，带 R<PaymentAddress> 信封。
PaymentAddress 对象
此收款过期的 Unix 时间戳。过期后，充值地址不再对新交易有效。
托管结账页面的 URL，客户可在此查看支付说明和二维码。
示例响应
{
"code": 200,
"msg": "success",
"data": {
"address": "TWkKZkmuB8DpVeiMoHiKf99ZoFHzk73CqR",
"amount": "250.00",
"symbol": "USDT",
"chain": "TRON",
"orderId": "order_1042",
"uid": null,
"expiredTime": 1717086400,
"paymentUrl": "http://your-gateway:3010/checkout?orderId=order_1042"
}
}
错误响应
400 — 验证错误
| 消息 | 原因 |
|---|
"The amount cannot be left blank." | amount 缺失或为 null |
"The symbol cannot be left blank." | symbol 缺失或为空 |
"The chain cannot be left blank." | chain 缺失或无效 |
"The orderId cannot be left blank." | V3 商家需要 orderId 但缺失 |
"The uid cannot be left blank." | V2 商家需要 uid 但缺失 |
"The uid cannot be zero." | uid 被设置为 "0" |
429 — 超出速率限制
{
"code": 429,
"msg": "Too many requests. Please slow down.",
"data": null
}
