接入UUAPI
创建订单
在设定时间内，为用户创建一个唯一的TRC20钱包地址使用订单。
1. 请求地址
Request URI
curl -X POST \ https://{BASE_URI}/api/tron/recharge/create_recharge
2. 请求参数
示例
{
"using_user": "user_123",
"token_id": 1,
"landing": false
}
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| using_user | string | 是 | 商户侧的用户唯一标识 (User ID) |
| token_id | number | 是 | 币种 ID (如: 1=TRX, 具体请咨询) |
| landing | boolean | 否 | 是否需要生成带分页的收款地址 (默认: false) |
币种 ID 说明
token_id | 符号 | 类型 | 合约地址 |
|---|---|---|---|
| 1 | TRX | TRX | - |
| 2 | USDT | TRC20 | TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t |
3. 返回示例
Response.json
{
"code": 1000,
"message": "success",
"data": {
"no": "20231027001",
"using_user": "user_123",
"address": "TQCgLnDCtb3...",
"token_id": 1,
"start": 1698380000,
"end": 1698381800,
"valid_time": 1800
}
}
参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| no | string | 订单号 |
| using_user | string | 商户侧用户标识 |
| address | string | 收款地址 (用户需向此地址充值) |
| token_id | number | 币种ID |
| start | number | 地址生效时间 (时间戳) |
| end | number | 地址失效时间 (时间戳) |
| valid_time | number | 有效时长 (分钟) |
4. 请求示例
<?php
// 示例：创建 TRC20 收款订单（PHP 原生 cURL）
$baseUrl = 'https://{BASE_URI}';
$url = $baseUrl . '/api/tron/recharge/create_recharge';
// 请求体数据（根据接口要求填写）
$data = [
'using_user' => 'u_888', // 使用用户-商户侧用户唯一标识
'token_id' => 1 // Token ID
];
// 初始化 cURL
$ch = curl_init($url);
// 设置 POST 与请求体（JSON）
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
// 设置请求头
$headers = [
'Content-Type: application/json',
'uu-api-key: your_api_key', // 替换为你的 API Key
'User-Agent: sclink-client/1.0'
];
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
// 超时与返回体
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10); // 整体超时（秒）
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); // 连接超时（秒）
// 执行请求
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
// 错误处理
if ($response === false) {
$err = curl_error($ch);
curl_close($ch);
die('请求失败：' . $err);
}
curl_close($ch);
// 输出与解析
echo "HTTP 状态码: {$httpCode}\n";
echo "响应原文: {$response}\n";
// 如为 JSON，可解析为数组
$respData = json_decode($response, true);
if (json_last_error() === JSON_ERROR_NONE) {
print_r($respData);
} else {
echo "响应不是合法的 JSON。\n";
}
const axios = require('axios');
const data = {
using_user: 'u_888', // 使用用户-商户侧用户唯一标识
token_id: 1 // Token ID
};
axios.post(
'https://{BASE_URI}/api/tron/recharge/create_recharge', // 请求地址 URI
data,
{
headers: {
'Content-Type': 'application/json',
'uu-api-key': 'your_api_key'
},
},
);