接口申请 URL : 跳转
参数 |
状态 |
解释 |
status |
success |
成功 |
status |
warning |
传入数据不合法或错误 |
status |
error |
系统错误,根据code(状态码)查看原因 |
状态码 |
说明 |
是否需要联系管理员 |
10000 |
请求成功 |
否 |
10001 |
系统错误,请重新请求 |
否 |
10002 |
usd提现(usdWithdraw),没有找到对应的用户(telegramID 没有创建钱包) |
否 |
10003 |
提现,余额不足 |
否 |
10004 |
提现,tron地址不合法 |
否 |
10005 |
检查订单(censorTxid), txid 不合法 |
否 |
10006 |
检查订单(censorTxid), 没有检测到入款信息 |
否 |
10007 |
检查用户(censorUserByTG), telegram ID 未注册钱包 |
否 |
11111 |
特殊错误 |
是 |
// 初始化数据
$api = new Troner('商户ID','商户TOKEN'); // **案例** $api = new Troner('20000','token');
// 构建参数
$data = [
'order' => 'yourorder',
];
// 调用接口
$result = $api->newAddress($data);
// 检查是否返回成功,如果没有返回成功则做出相应处理
if(!isset($result['status']) && $result['status'] != 'success'){
echo '接口请求出错或接口出错';
}
// 验证签名
if($api->checkSign($result)){
// 成功的逻辑代码
}else{
// 失败的逻辑代码
}
// 获取地址
$api = new Troner('商户ID','商户TOKEN');
// **案例** $api = new Troner('20000','token');
$data = [
'order' => 'yourorder',
];
$result = $api->newAddress($data);
参数名 |
必选项 |
解释 |
order |
Y |
订单号,order相同地址不变(唯一) |
id |
Y |
商户ID(sdk内部处理) |
sign |
Y |
数据签名(sdk内部处理) |
参数名 |
必选项 |
解释 |
status |
Y |
on status |
id |
Y |
商户ID |
code |
Y |
请求状态码 on code |
data[] |
Y |
返回数据的数组 |
data['api_order'] |
Y |
接口返回的订单号(用户其他功能,建议记录) |
data['order'] |
Y |
用户传入的订单号 |
data['address'] |
Y |
充值接收地址 |
sign |
Y |
数据签名 |
参数名 |
必选项 |
解释 |
id |
Y |
商户id |
data[] |
Y |
返回数据的数组 |
data['api_order] |
Y |
创建地址时生成的api_order |
data['order] |
Y |
创建地址是用户传入的order |
data['address] |
Y |
收款地址 |
data['amount] |
Y |
本次收款金额 |
data['txid] |
Y |
本次交易txid(唯一) |
data['datas] |
Y |
本地交易详情 |
data['coin_type] |
Y |
本次充值的币种(TRX,USDT) |
sign |
Y |
数据签名 |
USD 回调跟 TRX USDT 不同,需要单独处理,api_order是唯一值可以用于判断是否已处理
参数名 |
必选项 |
解释 |
id |
Y |
商户id |
data[] |
Y |
返回数据的数组 |
data['api_order] |
Y |
本站创建的 api_order 是唯一值 |
data['order] |
Y |
用户传入的order |
data['address] |
Y |
打款用户的TelegramID |
data['amount] |
Y |
本次收款金额 |
data['txid] |
Y |
本站创建的 api_order 是唯一值 |
data['datas] |
Y |
本站创建的 api_order 是唯一值 |
data['coin_type] |
Y |
USD |
sign |
Y |
数据签名 |
// usdt 提现
$api = new Troner('商户ID','商户TOKEN');
// **案例** $api = new Troner('20000','token');
$data = [
'address' => '合法的 tron 地址',
'amount' => '1',
'order' => '可选'
];
$result = $api->usdtWithdraw($data);
参数名 |
必选项 |
解释 |
address |
Y |
提现地址 |
amount |
Y |
提现金额 |
order |
N |
订单号 |
id |
Y |
商户ID(sdk内部处理) |
sign |
Y |
数据签名(sdk内部处理) |
参数名 |
必选项 |
解释 |
status |
Y |
on status |
id |
Y |
商户ID |
code |
Y |
请求状态码 [10004,10003] on code |
data[] |
Y |
返回数据的数组 |
data['api_order'] |
Y |
接口返回的订单号(用户其他功能,建议记录) |
data['order'] |
Y |
用户传入的订单号 |
data['address'] |
Y |
提现地址 |
data['amount'] |
Y |
提现金额 |
data['current_usdt'] |
Y |
USDT 剩余余额 |
data['coin_type'] |
Y |
币种(USDT) |
data['fee'] |
Y |
手续费 |
sign |
Y |
数据签名 |
// usdt 提现
$api = new Troner('商户ID','商户TOKEN');
// **案例** $api = new Troner('20000','token');
$data = [
'address' => '合法的 tron 地址',
'amount' => '1',
'order' => '可选'
];
$result = $api->trxWithdraw($data);
参数名 |
必选项 |
解释 |
address |
Y |
提现地址 |
amount |
Y |
提现金额 |
order |
N |
订单号 |
id |
Y |
商户ID(sdk内部处理) |
sign |
Y |
数据签名(sdk内部处理) |
参数名 |
必选项 |
解释 |
status |
Y |
on status |
id |
Y |
商户ID |
code |
Y |
请求状态码 [10004,10003] on code |
data[] |
Y |
返回数据的数组 |
data['api_order'] |
Y |
接口返回的订单号(用户其他功能,建议记录) |
data['order'] |
Y |
用户传入的订单号 |
data['address'] |
Y |
提现地址 |
data['amount'] |
Y |
提现金额 |
data['current_trx'] |
Y |
TRX 剩余余额 |
data['coin_type'] |
Y |
币种(TRX) |
data['fee'] |
Y |
手续费 |
sign |
Y |
数据签名 |
// usdt 提现
$api = new Troner('商户ID','商户TOKEN');
// **案例** $api = new Troner('20000','token');
$data = [
'telegramID' => 'telegramID',
'amount' => '1',
'order' => '可选'
];
$result = $api->usdWithdraw($data);
参数名 |
必选项 |
解释 |
telegramID |
Y |
用户的 telegramID,如果用户不存在返回 code:10002 |
amount |
Y |
提现金额 |
order |
N |
订单号 |
id |
Y |
商户ID(sdk内部处理) |
sign |
Y |
数据签名(sdk内部处理) |
参数名 |
必选项 |
解释 |
status |
Y |
on status |
id |
Y |
商户ID |
code |
Y |
请求状态码 [10002,10003] on code |
data[] |
Y |
返回数据的数组 |
data['api_order'] |
Y |
接口返回的订单号(用户其他功能,建议记录) |
data['order'] |
Y |
用户传入的订单号 |
data['telegramID'] |
Y |
用户传入的telegramID |
data['amount'] |
Y |
提现金额 |
data['current_usd'] |
Y |
USD 剩余余额 |
data['coin_type'] |
Y |
币种(USD) |
data['fee'] |
Y |
手续费 |
sign |
Y |
数据签名 |
查询订单返回的交易信息很有可能是你已经处理过的,所以请先判断交易是否处理过
// 通过 txid 检查收款情况
$api = new Troner('商户ID','商户TOKEN');
// **案例** $api = new Troner('20000','token');
$data = [
'txid' => '必须'
];
$result = $api->censorTxid($data);
参数名 |
必选项 |
解释 |
txid |
Y |
交易的txid |
id |
Y |
商户ID(sdk内部处理) |
sign |
Y |
数据签名(sdk内部处理) |
参数名 |
必选项 |
解释 |
status |
Y |
on status |
id |
Y |
商户ID |
code |
Y |
请求状态码 [10005,10006] on code |
data[] |
Y |
返回数据的数组 |
data['api_order] |
Y |
创建地址时生成的api_order |
data['order] |
Y |
创建地址是用户传入的order |
data['address] |
Y |
收款地址 |
data['amount] |
Y |
本次收款金额 |
data['txid] |
Y |
本次交易txid(唯一) |
data['datas] |
Y |
本地交易详情 |
data['coin_type] |
Y |
本次充值的币种(TRX,USDT) |
sign |
Y |
数据签名 |
// 通过 txid 检查收款情况
$api = new Troner('商户ID','商户TOKEN');
// **案例** $api = new Troner('20000','token');
$data = [
'address' => '必须'
];
$result = $api->isAddress($data);
参数名 |
必选项 |
解释 |
address |
Y |
tron 地址 |
id |
Y |
商户ID(sdk内部处理) |
sign |
Y |
数据签名(sdk内部处理) |
参数名 |
必选项 |
解释 |
status |
Y |
on status |
id |
Y |
商户ID |
code |
Y |
请求状态码 on code |
data[] |
Y |
返回数据的数组 |
data['address] |
Y |
地址 |
data['isAddress] |
Y |
地址是否合法(True or False) |
sign |
Y |
数据签名 |
// 通过 txid 检查收款情况
$api = new Troner('商户ID','商户TOKEN');
// **案例** $api = new Troner('20000','token');
$data = [
'telegramID' => '必须'
];
$result = $api->censorUserByTG($data);
参数名 |
必选项 |
解释 |
telegramID |
Y |
Telegram ID |
id |
Y |
商户ID(sdk内部处理) |
sign |
Y |
数据签名(sdk内部处理) |
参数名 |
必选项 |
解释 |
status |
Y |
on status |
id |
Y |
商户ID |
code |
Y |
请求状态码 [10007] on code |
data[] |
Y |
返回数据的数组 |
data['telegramID] |
Y |
传入的ID |
data['username] |
N |
用户名 |
data['nickname] |
N |
昵称 |
data['avatar] |
N |
头像 |
sign |
Y |
数据签名 |
// 获取地址
$api = new Troner('商户ID','商户TOKEN');
// **案例** $api = new Troner('20000','token');
$data = [
'order' => '123',
'amount' => '0.1',
'message' => '发大财',
];
$result = $api->payLink($data);
参数名 |
必选项 |
解释 |
amount |
Y |
充值金额 |
order |
N |
订单号 (充值成功后回调) |
message |
N |
消息 |
id |
Y |
商户ID(sdk内部处理) |
sign |
Y |
数据签名(sdk内部处理) |
参数名 |
必选项 |
解释 |
id |
Y |
商户id |
data[] |
Y |
返回数据的数组 |
data['api_order] |
Y |
创建充值链接时生成的订单号 |
data['order] |
Y |
传入的order |
data['tg_id] |
Y |
充值用户的 Telegram ID |
data['amount] |
Y |
本次收款金额 |
data['message] |
Y |
传入的 message |
data['coin_type] |
Y |
USD |
sign |
Y |
数据签名 |