当商户使用 请求提币订单（需二次确认） 的接口时，平台会调用该回调接口向商户确认提币单的详细信息。

此接口仅适用于回调类型 2（NOTIFY_REQUEST_WITHDRAW）。商户需根据回调内容，确认提币单的详细信息。 虽与 Webhook 回调接口共用同一套请求和响应的参数模板，但此接口的 URL 是独立的。

​
接口范例

  • 接口名称：https://xxxx/api/v1/uu/withdraw/info

​
请求说明

​
请求方法

POST

​
请求头

名称类型必填示例值说明
Content-Typestring是application/x-www-form-urlencoded请求格式，表单编码格式。
X-API-KEYstring是your-api-key授权密钥，用于身份验证。

​
请求体参数

以下为请求体的参数模板：

属性名类型必填示例值说明
tenantUserIdString是tenant123商户用户标识。
requestUUIDString是2137890请求的唯一标识符。
trackingIdString是track-4567订单追踪 ID。
typeInteger是2回调类型（见下方枚举）。
businessInteger是0所属租户类型（暂无实际控制作用）
callBackIdString否12345回调 ID。
toAddressString否TUekuiBgdk...目标地址。
chainNameString否TRON区块链名称。
txIdString否22e1c72076...交易 ID。
symbolString否USDT货币符号。
amountString否0.5金额。
txIndexInteger否20交易索引。
tagString否WITHDRAW_SUCCESSS标签。
fromAddressString否TUekuiBgdk...源地址。
newAddressString否TUekuiBgdk...新地址（仅在类型为 4 时使用）。
riskLevelFromInteger否15存币来源地址风险评分（类型为 1 时存在）。
riskLevelToInteger否15存币目标地址风险评分（类型为 1 时存在）。

​
请求示例

{
  "tenantUserId": "tenant123",
  "requestUUID": "2137890",
  "trackingId": "track-4567",
  "type": 2,
  "business": 0,
  "callBackId": "12345",
  "toAddress": "TUekuiBgdk...",
  "chainName": "TRON",
  "txId": "22e1c72076...",
  "symbol": "USDT",
  "amount": 0.5,
  "txIndex": 20,
  "tag": "WITHDRAW_SUCCESSS",
  "fromAddress": "TUekuiBgdk...",
  "newAddress": "TUekuiBgdk...",
  "riskLevelFrom": 15,
  "riskLevelTo": 15
}

​
响应参数

属性名类型必填示例值说明
requestUUIDString是2137890请求的唯一标识符
userIdString是1308764租户ID
createByString是“创建者信息，无实际控制作用
messageString是“信息描述，无实际控制作用
apiKeyString是“apiKey
errCodeint是“错误码，0表示成功，其它值表示失败
dataString是“用RSA公钥加密后的密文数据

以下为响应中 data 参数说明：

属性名类型示例值说明
requestUUIDString2137890请求的唯一标识符，用于唯一标记请求。
userIdInteger1用户 ID，标识触发事件的具体用户。
trackingIdStringtrack-4567订单追踪 ID。
addressStringtoAddress123目标地址，表示操作的目标地址。
tenantUserIdStringtenant123商户用户标识，用于区分商户用户。
chainNameStringTRON区块链名称，标识交易所在的区块链。
symbolStringUSDT货币符号，标识交易所涉及的代币或货币。
callBackIdString12345回调 ID，标识当前回调事件的 ID。
amountString0.5金额，表示交易或操作的具体数额。
typeInteger2回调类型，详细说明见回调类型枚举值。

​
响应示例

成功处理请求：

{
  "requestUUID": "2137890" ,
  "userId": 1,
  "createBy":"xxxx",
  "message": "成功处理请求",
  "apiKey": "your_api_key",
  "errCode": 0,
  "data": {
    "userId": 1,
    "trackingId": "track-4567",
    "address": "toAddress123",
    "tenantUserId": "tenant123",
    "chainName": "TRON",
    "symbol":"USDT",
    "callBackId":"12345",
    "requestUUID": "2137890",
    "amount": 0.5,
    "type": 2,
  }
}

​
响应参数-回调类型说明

  • type:
    • 固定为 2，表示回调类型为 NOTIFY_REQUEST_WITHDRAW。
    • 此回调类型用于商户确认提币单的详细信息。
    • 商户需根据回调内容确认提币单信息后再进行后续处理。

​
注意事项

  1. 商户需确保回调接口的 URL 能正常被访问，并返回正确的响应结果，否则可能导致回调失败。
  2. 平台在回调失败时会进行多次重试，商户需妥善处理幂等问题，确保相同的回调请求不会被重复处理多次。
  3. 回调接口的安全性需通过 X-API-KEY 进行验证，请商户妥善保管密钥，防止未经授权的请求访问接口。