👽用户提现

用户提现数字资产操作接口。

特别提醒：提现接口涉及数字资产安全，提现操作成功后，用户的提现订单依据管理员设置的风控要求，可能需要二次审核操作。

# 接口名称：用户提现

## 请求URL

POST

https://vipapi.matrixpay.io/sdk/partner/UserWithdrawByOpenID

## 请求参数

| 参数名称       | 类型   | 是否必需 | 描述                             |
|----------------|--------|----------|----------------------------------|
| OpenId         | string | 是       | 用户的唯一标识符。               |
| AddressTo      | string | 是       | 提现目标地址。                   |
| SafeCheckCode  | string | 是       | 安全检查码：一般为订单号           |
| TokenId        | string | 是       | 提现代币的标识符。               |
| Amount         | string | 是       | 提现金额。                       |

## 请求头部

| 参数          | 值                              | 描述                      |
|---------------|---------------------------------|---------------------------|
| key           | vratson2i5hjxgkd                | 认证密钥                  |
| sign          | 8c2f90f7e75f340e0f9e2a62d4bce39e| 请求签名                  |
| timestamp     | 1710578780039                   | 请求时间戳（毫秒）        |
| Content-Type  | application/json                | 请求内容类型              |
| clientSign    | ******                          | 客户端签名                |

## 请求示例

```json
{
  "OpenId": "Hash2024031501",
  "AddressTo": "TYgLwEP4BkcuvTvWf8xLE2dCyzm7z5ZYga",
  "SafeCheckCode": "Hash2024031501-TRONChain-202X0030302",
  "TokenId": "4",
  "Amount": "1.052758"
}

响应示例

{
    "sign": "RWZiIP8i/Etl30ODlxcYo5aYYHGbNHoFTaW6fEeQCxXTFKTQvSUmFuoTl3LCIh6b/JsQbyhb+SQ25F0JzV0dX1OOWFJdRRsPp2PCjMdxs9i2MEbvX9r0OqixxKVeyZliQI4J9qj5yh7qhxqfISr6AHxlcKEVtrYHNeD60/6Ppvd9WHzNdf+sv90cf+nCG8SAtqGIrwcNEy8Lf6DB+2pMeQaRh08WIenrR6/exQ3lW6OlyA6swsOWh+dJqHOPuIn4Obtik+pH2ks7LSx/fN3QEV908k5D5vCuJXT359SBQvdPSvGp7GYU92CeoQX1kI6Yai28apOQLDa5JzXWiFR/Yg==",
    "timestamp": "1709391717766",
    "data": {
        "OpenId": "Hash2024031501",
        "AddressTo": "TYgLwEP4BkcuvTvWf8xLE2dCyzm7z5ZYga",
        "SafeCheckCode": "Hash2024031501-TRONChain-202X0030302",
        "TokenId": "4",
        "Amount": "1.052758"
    },
    "msg": "need double check to pay out.",
    "code": 2
}

响应字段说明

• sign: 响应数据签名，用于验证响应的完整性和真实性。

• timestamp: 响应时间戳，以毫秒为单位。

• data: 返回的数据对象，包含提现的相关信息。

  • OpenId: 用户的唯一标识符。

  • AddressTo: 提现目标地址。

  • SafeCheckCode: 安全检查码。

  • TokenId: 提现代币的标识符。

  • Amount: 提现金额。

• msg: 返回消息，提供有关请求处理状态的详细信息。

• code: 返回码，表示请求的处理状态。

接口返回码说明：
1：提现接口操作完成，资产链上处理中；
2：提现接口调用成功，提现订单需要运营管理员登录商户平台二次审核；
0: 提现接口调用错误。

所有的提现订单会通过配置的回调通知地址更新通知状态信息。