# 下载密钥

#### **接口用途**

- 中间件提供按钮，可以在设备初始安装时调用此接口，下载主密钥数据。

#### **接口地址**

- `https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/downloadKey`

#### **action**

- `downloadKey`

**请求参数，中间件===>易百后台**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>是</td><td>请求流水号</td><td>不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td>password</td><td>String</td><td>是</td><td>密钥下载密码</td><td>3DES加密，HEX格式</td></tr></tbody></table>

#### **请求报文举例**

```
{
    "traceNo": "99000009100010101732123",
    "password": "EE16E3C7D5F8610EADDFCD5BA737CBB9"
}

```

**返回参数，易百后台===&gt;中间件**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t-0"><thead><tr><th style="width: 143px;">字段</th><th style="width: 113px;">类型</th><th style="width: 77px;">是否必填</th><th style="width: 160px;">字段意义</th><th style="width: 316px;">备注</th></tr></thead><tbody><tr><td style="width: 143px;">traceNo</td><td style="width: 113px;">String</td><td style="width: 77px;">是</td><td style="width: 160px;">请求流水号</td><td style="width: 316px;">原样返回</td></tr><tr><td style="width: 143px;">transDate</td><td style="width: 113px;">String</td><td style="width: 77px;">是</td><td style="width: 160px;">交易时间</td><td style="width: 316px;">格式为：yyyyMMddHHmmss</td></tr><tr><td style="width: 143px;">returnCode</td><td style="width: 113px;">String</td><td style="width: 77px;">是</td><td style="width: 160px;">返回码</td><td style="width: 316px;">00表示交易成功，其他表示失败</td></tr><tr><td style="width: 143px;">returnDesc</td><td style="width: 113px;">String</td><td style="width: 77px;">是</td><td style="width: 160px;">返回信息</td><td style="width: 316px;">交易结果描述或错误原因</td></tr><tr><td style="width: 143px;">tmk</td><td style="width: 113px;">String</td><td style="width: 77px;">是</td><td style="width: 160px;">易百POS主密钥</td><td style="width: 316px;">3DES加密，HEX格式</td></tr><tr><td style="width: 143px;">tmkCheckValue</td><td style="width: 113px;">String</td><td style="width: 77px;">是</td><td style="width: 160px;">易百POS主密钥校验值</td><td style="width: 316px;">3DES加密，HEX格式,ptlVersion=20180612主密鑰下载时会下发check value</td></tr><tr><td style="width: 143px;">mwTmk</td><td style="width: 113px;">String</td><td style="width: 77px;">是</td><td style="width: 160px;">中间件主密钥</td><td style="width: 316px;">3DES加密，HEX格式</td></tr><tr><td style="width: 143px;">mwTmkCheckValue</td><td style="width: 113px;">String</td><td style="width: 77px;">是</td><td style="width: 160px;">中间件主密钥校验值</td><td style="width: 316px;">3DES加密，HEX格式,ptlVersion=20180612主密鑰下载时会下发check value</td></tr></tbody></table>

#### **返回报文举例**

```
{
    "traceNo": "99000009100010101732123",
    "transDate": "20161231102201",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "tmk": "0BC8C201108F19E53D1904F12AD50DF2",
    "mwTmk": "C716E3C7D5F8610EADDFCD5BA737CBB9",
    "tmkCheckValue": "E7958039AE218AE7",
    "mwTmkCheckValue": "138D579A070F2480"
}
```