# ebuyweb-qrpay API接口文档



# 文档版本记录

<table id="bkmrk-%E7%89%88%E6%9C%AC%E5%8F%B7-%E6%9B%B4%E6%96%B0%E6%97%A5%E6%9C%9F-%E8%AF%B4%E6%98%8E-%E6%9B%B4%E6%96%B0%E4%BA%BA-v1.0" style="width: 599px;"><thead><tr><th style="width: 70px;">**版本号**</th><th style="width: 129px;">**更新日期**</th><th style="width: 215px;">**说明**</th><th style="width: 185px;">**更新人**</th></tr></thead><tbody><tr><td style="width: 70px;">V1.0</td><td style="width: 129px;">2019/10/23</td><td style="width: 215px;">初始化导入</td><td style="width: 185px;">谈峥</td></tr><tr><td style="width: 70px;">V1.1</td><td style="width: 129px;">2019/10/23</td><td style="width: 215px;">新增电子券类交易接口</td><td style="width: 185px;">谈峥</td></tr><tr><td style="width: 70px;">V1.2</td><td style="width: 129px;">2019/10/24</td><td style="width: 215px;">新增主扫类</td><td style="width: 185px;">谈峥</td></tr><tr><td style="width: 70px;">V1.3</td><td style="width: 129px;">2019/10/25</td><td style="width: 215px;">新增openAPI</td><td style="width: 185px;">谈峥</td></tr><tr><td style="width: 70px;">V1.4</td><td style="width: 129px;">2019/10/29</td><td style="width: 215px;">新增按券号查询历史交易</td><td style="width: 185px;">谈峥</td></tr></tbody></table>

# 接口说明

#### 调用方法

<table id="bkmrk-%E5%86%85%E5%AE%B9-%E8%AF%B4%E6%98%8E-%E9%80%9A%E8%AE%AF%E6%96%B9%E5%BC%8F-%E9%87%87%E7%94%A8-https-" style="width: 391px;"><thead><tr><th style="width: 121px;">内容</th><th style="width: 270px;">说明</th></tr></thead><tbody><tr><td style="width: 121px;">通讯方式</td><td style="width: 270px;">采用 HTTPS 方式访问</td></tr><tr><td style="width: 121px;">提交方法</td><td style="width: 270px;">POST (application/json)</td></tr><tr><td style="width: 121px;">交互数据格式</td><td style="width: 270px;">JSON</td></tr><tr><td style="width: 121px;">字符编码</td><td style="width: 270px;">UTF-8</td></tr></tbody></table>

#### 报文结构

**请求报文和返回报文都采用如下的报文结构**

<table id="bkmrk-%E5%8F%82%E6%95%B0-%E7%B1%BB%E5%9E%8B-%E5%8F%82%E8%80%83%E6%95%B0%E6%8D%AE-%E5%8F%82%E6%95%B0%E8%AF%B4%E6%98%8E-%E5%A4%87%E6%B3%A8-t"><thead><tr><th>参数</th><th>类型</th><th>参考数据</th><th>参数说明</th><th>备注</th></tr></thead><tbody><tr><td>tokenId</td><td>String</td><td>JIOQWDIQN23123NOININV</td><td>token值</td><td>用于校验身份</td></tr><tr><td>lang</td><td>String</td><td>en/jp/cn</td><td>语言类型</td><td>用于区分语言</td></tr><tr><td>body</td><td>String</td><td>BASE64</td><td>报文内容</td><td>具体接口有详细说明，本域需要采用BASE64编码</td></tr><tr><td>timestamp</td><td>String</td><td>1483372334</td><td>Unix时间戳</td><td>单位：秒，中间件需要在收到返回时同步该时间</td></tr></tbody></table>

**报文举例**

```
{
  "timestamp": 1551346625000,
  "tokenId": "e29877a73d2141598e0e54ed24fc2e5b",
  "body": "",
  "lang": "ja"
}
```