💱收款[充值]订单

创建一笔新收款[充值]订单，常见于业务平台发起一笔充值订单。

# 新收款[充值]订单

## 请求URL

POST

https://*******/sdk/api/v2/exchange/deposit

## 请求参数

| 参数名称       | 类型    | 是否必需 | 描述                         |
|----------------|---------|----------|------------------------------|
| outOrderNo     | string  | 是       | 业务平台订单号，唯一订单ID       |
| outUserId      | string  | 是       | 业务平台用户ID               |
| tokenId        | integer | 是       | 代币ID，充值TokenId，查询配置表                  |
| quantity       | double  | 是       | 数量，充值数量                       |
| notifyUrl      | string  | 否       | 回调通知URL，如果不指定，会使用系统设置配置的回调通知URL                |

## 请求头部

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

## 请求示例

```json
{
  "outOrderNo": "dps202X021500101001",
  "outUserId": "Hash2024031501",
  "tokenId": 6,
  "quantity": 0.114538,
  "notifyUrl": "https://*******/deposit/callback"
}

响应示例

{
    "sign": "JzRmN7OIgUs1On1fpzhvTGqHJbJ2CQxEn6rMh+M2O4+9maHhFFIw29mboiORwSQGHpqAngHHVUqv402TMt9t1+cqhCKpUM47ujgvj3ftGKlCN/4TenyGKair8SmDx5wWnPS2j8sxJGtQH0GxNlPuQU/FJ2/h8SG1IJiI3s1pwrWtJGxX0xXh3SxebDjR3bCYDLQ7v7g3jHZYGZJsS0aBJXDgn0PGbvg/0tZ3YJp7osFjlUDNmObMssE2G10csCvnnQkm2d/5M2lJcGBHKp/2+WX/EZunhmcZKKH8Cs3TzFvAhCOR/vCMnXfoigPgIQXndXGCWiPb+bQ+rewa9jhFVA==",
    "timestamp": "1710605350270",
    "data": {
        "orderNo": "20240317000910021591",
        "outOrderNo": "dps202X021500101001",
        "outUserId": "Hash2024031501",
        "tokenId": 6,
        "quantity": 0.114538,
        "addresses": "0xdaa0cb94eecb0d2349e52162401ff6f03170d541"
    },
    "code": 1,
    "msg": "ok"
}

响应字段说明

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

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

• data: 返回的数据对象。

  • orderNo: 内部订单号。

  • outOrderNo: 外部订单号。

  • outUserId: 外部用户ID。

  • tokenId: 代币ID。

  • quantity: 数量。

  • addresses: 收款地址。

• code: 返回码，表示请求的处理状态。1标识成功，其它编码有错误产生。

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

特别说明：
订单状态发生变化时，充值订单状态会实时回调指定的通知接口。