# e-Buy 权益平台

# 接入指南



# 接口域名

<table border="1" id="bkmrk-%E6%B5%8B%E8%AF%95%E7%8E%AF%E5%A2%83-https%3A%2F%2Ftest-ri" style="border-collapse: collapse; width: 100%; height: 59.5938px; border-width: 1px; border-color: rgb(53, 152, 219);"><colgroup><col style="width: 9.89174%;"></col><col style="width: 90.1083%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">测试环境</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">https://test-rights-platform.e-buy.com</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">生产环境</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">https://rights-platform.e-buy.com</td></tr></tbody></table>

# 接口调用方式

<table border="1" id="bkmrk-%E6%8F%90%E4%BA%A4%E6%96%B9%E5%BC%8F-http-post%E6%96%B9%E5%BC%8F%E6%8F%90%E4%BA%A4%EF%BC%8Cc" style="border-collapse: collapse; width: 100%; height: 119.188px; border-width: 1px; border-color: rgb(53, 152, 219);"><colgroup><col style="width: 12.7709%;"></col><col style="width: 87.2291%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">提交方式</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">HTTP POST方式提交，CONTENT-TYPE为application/json</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">报文格式</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">json</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">字符编码</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">utf-8</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">签名算法</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">sha256</td></tr></tbody></table>

# 安全规范

- 拼接报文参数

除sign参数外的所有参数按照ASCII顺序排序后，以"参数名1=参数值1&amp;参数名2=参数值2"的方式拼接所有参数

- bizContent业务参数

对所有业务参数的json格式做base64再行拼接

- 拼接签名 appSecret(由易百分配)

最后在尾部拼接双方约定的密钥"appSecret=xxxxx"，

- 签名值计算

sha256加密后即为签名值，并赋给sign参数。

- 注

当参数值为null或为空时不参与签名串拼接

- JAVA签名参考代码

```java
JSONObject notifyJson = new JSONObject(true);
notifyJson.put("orderNo", "4200001172202109274275163730");
notifyJson.put("transDateTime", "20210928102350");
notifyJson.put("ebuyCode", "1002108300000059091");
notifyJson.put("faceValue", "30");
notifyJson.put("outTradeNo", "89392109280163981");

byte[] encodeBase64 = Base64.encodeBase64(notifyJson.toJSONString().getBytes("UTF-8"));
String bizContent = new String(encodeBase64, "UTF-8");

Map<String, String> map = new TreeMap<>();
map.put("appKey", "274b9cf9f01543619baa726ed24ddd19");
map.put("signType", "sha256");
map.put("timestamp", "1483372334");
map.put("bizContent", bizContent);

StringBuilder buffer = new StringBuilder();
for (Map.Entry<String, String> item : map.entrySet()) {
buffer.append(item.getKey()).append("=").append(item.getValue()).append("&");
}

String signStr = buffer.toString() + "appSecret=XXXXXXXXXXXX";// appSecret(需易百提供);
String checkSign = SHAUtil.sha256(signStr);
System.out.println(signStr);
System.out.println(checkSign);
```

拼接后签名串：action=verify&amp;appKey=274b9cf9f01543619baa726ed24ddd19&amp;bizContent=eyJvcmRlck5vIjoiNDIwMDAwMTE3MjIwMjEwOTI3NDI3NTE2MzczMCIsInRyYW5zRGF0ZVRpbWUiOiIyMDIxMDkyODEwMjM1MCIsImVidXlDb2RlIjoiMTAwMjEwODMwMDAwMDA1OTA5MSIsImZhY2VWYWx1ZSI6IjMwIiwib3V0VHJhZGVObyI6Ijg5MzkyMTA5MjgwMTYzOTgxIn0=&amp;charset=utf-8&amp;format=json&amp;signType=sha256&amp;timestamp=1483372334&amp;appSecret=XXXXXXXXXXXX

最终签名值：bc151776f32a0eed26fd97696ece7e8102e5c1f8f594fbf8ddc392bd579693f1

# 接口清单及说明

<table border="1" id="bkmrk-%E6%8E%A5%E5%8F%A3%E8%B0%83%E7%94%A8%E5%90%8D%E7%A7%B0-%E6%8E%A5%E5%8F%A3%E5%90%8D%E7%A7%B0-%E6%8E%A5%E5%8F%A3%E9%80%82%E7%94%A8%E5%9C%BA%E6%99%AF-%E8%B0%83" style="border-collapse: collapse; width: 100%; border-width: 1px;"><colgroup><col style="width: 16.8039%;"></col><col style="width: 17.0459%;"></col><col style="width: 41.2396%;"></col><col style="width: 25.0298%;"></col></colgroup><thead><tr style="border-color: rgb(53, 152, 219);"><td>**接口调用名称**</td><td>**接口名称**</td><td>**接口适用场景**</td><td>**调用方向**</td></tr></thead><tbody><tr><td>queryCodeDetail</td><td>券查询接口</td><td>查询券关联的产品及活动详细信息</td><td>外部商户/渠道 调用易百</td></tr><tr><td>codeExchange</td><td>券兑换接口</td><td>用户在商户/渠道侧绑定或兑换易百券</td><td>外部商户/渠道 调用易百</td></tr><tr><td>codeStatusUpdate</td><td>券状态变更</td><td>外部渠道调易百做券状态更新，如 作废、延期、冻结解冻等，更多类型见接口定义</td><td>外部商户/渠道 调用易百</td></tr><tr><td>verify</td><td>券核销接口</td><td>核销券，该接口成功后券为 “已使用”</td><td>外部商户/渠道 调用易百</td></tr><tr><td>verifyVoid</td><td>券核销撤销接口</td><td>回退核销交易，该接口成功后券为 “可使用”</td><td>外部商户/渠道 调用易百</td></tr><tr><td>  
</td><td>券状态变更通知</td><td>券状态发生变更时易百通知渠道/商户，如 作废、延期、冻结等，详情见接口定义</td><td>易百调用 外部商户/渠道，需商户/渠道向易百提供回调URL</td></tr></tbody></table>

# 公共参数

#### 请求公共参数

<table border="1" id="bkmrk-%E5%8F%82%E6%95%B0%E5%90%8D-%E8%AF%B4%E6%98%8E-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%A4%87%E6%B3%A8-ap" style="border-collapse: collapse; width: 100%; border-width: 1px; border-color: rgb(53, 152, 219);"><colgroup><col style="width: 14.3096%;"></col><col style="width: 25.7381%;"></col><col style="width: 12.8725%;"></col><col style="width: 17.7592%;"></col><col style="width: 29.4398%;"></col></colgroup><tbody><tr><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">**参数名**</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">**说明**</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">**类型**</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">**是否必填**</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">**备注**</td></tr><tr><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">appKey</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">由易百分配</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">String(32)</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">sign</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">签名值</td><td style="border-color: rgb(53, 152, 219);">String(400)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">timestamp</td><td style="border-color: rgb(53, 152, 219);">时间戳(毫秒)</td><td style="border-color: rgb(53, 152, 219);">Number(13)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">bizContent</td><td style="border-color: rgb(53, 152, 219);">业务参数集合</td><td style="border-color: rgb(53, 152, 219);">  
</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr></tbody></table>

#### 返回公共参数

<table border="1" id="bkmrk-%E5%8F%82%E6%95%B0%E5%90%8D-%E8%AF%B4%E6%98%8E-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%A4%87%E6%B3%A8-re" style="border-collapse: collapse; width: 100%; border-width: 1px; border-color: rgb(53, 152, 219); height: 119.188px;"><colgroup><col style="width: 13.826%;"></col><col style="width: 26.2217%;"></col><col style="width: 20.0238%;"></col><col style="width: 10.381%;"></col><col style="width: 29.6667%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">**参数名**</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">**说明**</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">**类型**</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">**是否必填**</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">**备注**</td></tr><tr style="height: 29.7969px;"><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">returnCode</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">返回码</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">String(20)</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">是</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">00: 成功 其他为失败或异常</td></tr><tr style="height: 29.7969px;"><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">returnMsg</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">返回描述</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">String(200)</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">是</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">data</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">具体的交易请求返回结果</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">Object</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">否</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">  
</td></tr></tbody></table>

# 电子券业务API



# 券详情查询

请求参数

|字段|类型(最大长度)|是否必填|字段含义|备注|
| - | - | - | - | - |
|code|String |是|券号||
|orderNo|String |否|制码订单号|暂时支持一单一券场景|
|traceNo|String |是|交易流水号|全局唯一|




响应结果

|字段|数据项|类型(最大长度)|是否必填|字段含义|备注|
| - | - | - | - | - | - |
|data|codeUrl|String|否|券短链|券二维码|
||code|String|是|券号||
||ebuyTicketId|String|是|易百券批次号||
||faceValue|String|是|券面值|单位(元)|
||validStart|String|否|券有效期 起|格式: yyyy-mm-dd hh:mm:ss|
||validEnd|String|否|券有效期 止|格式: yyyy-mm-dd hh:mm:ss|
||codeStatus|String|是|券状态|<p>00:未使用</p><p>01:已使用</p><p>08:已兑换</p><p>04:已冻结</p><p>05:已作废</p><p>06:已过期</p>|
||codeStatusDesc|String|否|券状态描述||
||activityName|String|否|活动名称||
||activityId|String|否|活动编号||
||activityProductNo|String|否|活动产品编号||
||productName|String|否|产品名称||
||ticketType|String|否|券类型||

# 券兑换

请求参数
|字段|类型(最大长度)|是否必填|字段含义|备注|
| - | - | - | - | - |
|code|String |是|券号||
|traceNo|String |是|交易流水号|全局唯一|

响应结果

<table>
  <tr>
    <th>字段</th><th >数据项</th><th >类型(最大长度)</th><th >是否必填</th><th >字段含义</th><th >备注</th>
  </tr>
  <tr  align="center" valign = "middle">
    <td rowspan="4">data</td>
    <td>code</td>
    <td>String</td>
    <td>是</td>
    <td>券号</td>
    <td></td>
  </tr>
  <tr  align="center" valign = "middle">
    <td>exchangeResult</td>
    <td>String</td>
    <td>是</td>
   <td>兑换结果</td>
    <td>00:兑换成功，其他为兑换失败</td>
  </tr>
   <tr  align="center" valign = "middle">
    <td>exchangeDesc</td>
    <td>String</td>
    <td>是</td>
    <td>兑换结果描述</td>
    <td>  </td>
  </tr>
</table>
<br>

# 券状态变更

请求参数

|字段|类型(最大长度)|是否必填|字段含义|备注|
| - | - | - | - | - |
|code|String |是|券号|多个券号用英文逗号隔开（对接批量券状态更新需提前和易百沟通，暂时默认不支持批量操作）|
|traceNo|String |是|交易流水号|全局唯一|
|updateType   |String|是|更新类型|支持作废、冻结、解冻; 枚举值见备注|

注：  updateType 枚举


|**updateType**|**操作名称**|**更新前状态**|**更新后状态**|**备注**|
| - | - | - | - | - |
|invalid|串码作废|00：未使用、初始化<br>03：未激活<br>04：已冻结|05:已作废||
|freeze|冻结串码|00：未使用|04：已冻结|已冻结的串码，可以调用解冻操作后恢复原状态|
|unfreeze|解冻串码|04：已冻结|00：未使用||


响应结果

|字段|数据项|类型(最大长度)|是否必填|字段含义|备注|
| - | - | - | - | - | - |
|<p></p><p>data</p>|code|String|是|券号||
||codeUpdateResult|String|是|券更新结果|<p>00:更新成功，</p><p>其他为失败</p>|

# 券码核销

请求参数

|字段|类型(最大长度)|是否必填|字段含义|备注|
| - | - | - | - | - |
|code|String|是|券号|多张券码用逗号隔开，英文逗号|
|traceNo|String |是|交易流水号|全局唯一|
|shopNo|String |是|门店编号||
|shopName|String |否|门店名称||
|tansTime|String |是|核销时间|格式 yyyyMMddhhssSSS|
|goodsList|List<GoodsInfo>|否|券兑换的商品明细|代金券默认为A0001|
|totalAmount|String |是|订单总金额|单位（元）|
|verifyScene|String |是|核销场景|线上：online, 线下：offline|

GoodsInfo

|字段|类型(最大长度)|是否必填|字段含义|备注|
| - | - | - | - | - |
|goodsId|String|是|券兑换商品id ||
|price|String |是|兑换商品金额|全局唯一|
|rebateCode|String |否|标签编号||
|count|String|是|兑换商品数量|默认为1|

响应结果

|字段|数据项|类型(最大长度)|是否必填|字段含义|备注|
| - | - | - | - | - | - |
|data|List<VerifyResultData>|List|是|核销结果集||


VerifyResultData定义

|字段|类型(最大长度)|是否必填|字段含义|备注|
| - | - | - | - | - |
|verifyResult|String|是|核销结果|<p>00:成功</p><p></p><p>其他为失败</p><p></p>|
|activityNo|String|否|活动编号||
|activityName|String|否|活动名称||
|totalAmount|String|否|订单总金额|单位(元)|
|userRealAmount|String|否|用户购券实付金额|单位(元)|
|merchantRealAmount|String|否|商户实收金额|单位(元)|
|discountAmount|String|否|券折抵金额|单位(元)|
|channelBenefit|String|否|渠道优惠金额|单位(元)|
|merchantBenefit|String|否|商户优惠金额|单位(元)|
|faceValue|String|否|券面值|单位(元)|
|remainUseTimes|String|否|剩余可用次数||
|code|String|是|券号||

# 券核销撤销

请求参数

|字段|类型(最大长度)|是否必填|字段含义|备注|
| - | - | - | - | - |
|code|String |是|券号|多个券用逗号隔开，不传默认撤销originTraceNo 对应核销的所有券|
|traceNo|String |是|当前交易流水号|全局唯一|
|originTraceNo|String |是|核销时上送的流水号||
|originVerifyDate|String|否|原核销日期|yyyyMMdd|


响应结果

|字段|数据项|类型(最大长度)|是否必填|字段含义|备注|
| - | - | - | - | - | - |
|data|List<VerifyVoidResultData>|List|是|核销撤销结果||


VerifyVoidResultData定义

|字段|类型(最大长度)|是否必填|字段含义|备注|
| - | - | - | - | - |
|resultDesc|String|否|核销撤销结果结果描述||
|result|String|否|核销撤销结果|<p>00: 成功</p><p>其他为失败</p>|
|code|String|是|券号||
|ticketId|String|是|券批次id|<p> </p><p></p>|

# 券状态变更通知

请求参数

|字段|类型(最大长度)|是否必填|字段含义|备注|
| - | - | - | - | - |
|code|String |是|券号||
|traceNo|String |是|当前交易流水号|全局唯一|
|saleChannelOrderId|String|否|发券时渠道侧订单号|核销、核销撤销场景必传|
|shopNo|String|否|核销门店编号|核销场景必传|
|timeStamp|String|否|发生时间戳(毫秒)||
|notifyType|String|是|当前通知交易类型||
|validStartDate|String|否|券有效期开始时间|yyyy-MM-dd HH:mm:ss|
|validEndDate|String|否|券有效期截止时间|yyyy-MM-dd HH:mm:ss|

注：  notifyType 枚举


|notifyType|操作名称|更新前状态|更新后状态|
| - | - | - | - |
|verifyNotify|券核销|未使用|已使用|
|verifyCancelNotify|券核销撤销|已使用|未使用|
|invalidNotify|券作废|未使用|已作废|
|renewalNotify|券延期|已过期|可使用|
|expireNotify|过期通知|过期|已过期|


通知报文（案例）签名过程：

JSONObject notifyJson = new JSONObject(true);

notifyJson.put("code", "10034343334344443209");

notifyJson.put("traceNo", "4200001172202109274275163730");

notifyJson.put("notifyType", "verifyNotify");

byte[] encodeBase64 = Base64.encodeBase64(notifyJson.toJSONString().getBytes("UTF-8"));

String bizContent = new String(encodeBase64, "UTF-8");

Map<String, String> map = new TreeMap<>();

map.put("appKey", "274b9cf9f01543619baa726ed24ddd19");

map.put("action", "verifyNotify");

map.put("format", "json");

map.put("charset", "utf-8");

map.put("signType", "sha256");

map.put("timestamp", "1483372334");

map.put("bizContent", bizContent);

StringBuilder buffer = new StringBuilder();

for (Map.Entry<String, String> item : map.entrySet()) {

   buffer.append(item.getKey()).append("=").append(item.getValue()).append("&");

}

String signStr = buffer.toString() + "appSecret=XXXXXXXXXXXX";// appSecret(需易百提供);

String checkSign = SHAUtil.sha256(signStr);

System.out.println(signStr);

System.out.println(checkSign);

}

参与签名报文字符串：

action=verifyNotify&appKey=274b9cf9f01543619baa726ed24ddd19&bizContent=eyJjb2RlIjoiMTAwMzQzNDMzMzQzNDQ0NDMyMDkiLCJ0cmFjZU5vIjoiNDIwMDAwMTE3MjIwMjEwOTI3NDI3NTE2MzczMCIsIm5vdGlmeVR5cGUiOiJ2ZXJpZnlOb3RpZnkifQ==&charset=utf-8&format=json&signType=sha256&timestamp=1483372334&appSecret=XXXXXXXXXXXX

签名结果：

17e9fe1250c33fccf517ce4b5810f2c731fa45058181a15cffc4ab38332460d4

响应结果

|字段|类型(最大长度)|是否必填|字段含义|备注|
| - | - | - | - | - |
|resultDesc|String|否|通知结果描述||
|result|String|否|通知结果|<p>00: 成功</p><p>其他为失败</p>|

<br><br>

# 支付业务API



# 订单支付

#### 接口用途

用户展示付款码由店员使用扫码设备读取付款码信息上送

#### 接口地址

/payment/tradePay

#### 请求参数

<table border="1" id="bkmrk-%E5%8F%82%E6%95%B0%E5%90%8D-%E8%AF%B4%E6%98%8E-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%A4%87%E6%B3%A8" style="border-collapse: collapse; border-width: 1px; border-color: rgb(53, 152, 219);"><colgroup><col style="width: 10.8462%;"></col><col style="width: 18.1168%;"></col><col style="width: 13.7068%;"></col><col style="width: 11.0846%;"></col><col style="width: 9.17688%;"></col><col style="width: 37.1878%;"></col></colgroup><thead><tr><td colspan="2" style="border-color: rgb(53, 152, 219);">**参数名**  
</td><td style="border-color: rgb(53, 152, 219);">**说明**</td><td style="border-color: rgb(53, 152, 219);">**类型**</td><td style="border-color: rgb(53, 152, 219);">**是否必填**</td><td style="border-color: rgb(53, 152, 219);">**备注**</td></tr></thead><tbody><tr><td class="align-center" rowspan="20" style="border-color: rgb(53, 152, 219); vertical-align: middle;">bizContent</td><td style="border-color: rgb(53, 152, 219);">traceNo</td><td style="border-color: rgb(53, 152, 219);">交易流水号</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">同一商户全局唯一，用于标识唯一交易</td></tr><tr><td style="border-color: rgb(53, 152, 219);">paymentChannelId</td><td style="border-color: rgb(53, 152, 219);">支付渠道ID</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">否</td><td style="border-color: rgb(53, 152, 219);">当收款方需要指定支付渠道时填值(由易百分配)</td></tr><tr><td style="border-color: rgb(53, 152, 219);">merOrderNo</td><td style="border-color: rgb(53, 152, 219);">商户订单号</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">同一商户全局唯一，用于关联收银机订单号</td></tr><tr><td style="border-color: rgb(53, 152, 219);">orderAmount</td><td style="border-color: rgb(53, 152, 219);">订单原始金额</td><td style="border-color: rgb(53, 152, 219);">Number</td><td style="border-color: rgb(53, 152, 219);">否</td><td style="border-color: rgb(53, 152, 219);">单位分，收银前端原始点单金额</td></tr><tr><td style="border-color: rgb(53, 152, 219);">totalAmount</td><td style="border-color: rgb(53, 152, 219);">待支付总金额</td><td style="border-color: rgb(53, 152, 219);">Number</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">单位分，收银前端已优惠过剩下要支付的金额</td></tr><tr><td style="border-color: rgb(53, 152, 219);">deviceNo</td><td style="border-color: rgb(53, 152, 219);">设备号</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">收银机具终端编号</td></tr><tr><td style="border-color: rgb(53, 152, 219);">storeId</td><td style="border-color: rgb(53, 152, 219);">商户门店编号</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">商户门店编号</td></tr><tr><td style="border-color: rgb(53, 152, 219);">storeName</td><td style="border-color: rgb(53, 152, 219);">商户门店名称</td><td style="border-color: rgb(53, 152, 219);">String(256)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">商户门店名称</td></tr><tr><td style="border-color: rgb(53, 152, 219);"><span class="isp-field-name">returnOptions</span></td><td style="border-color: rgb(53, 152, 219);">返回选项</td><td style="border-color: rgb(53, 152, 219);">String\[\](300)</td><td style="border-color: rgb(53, 152, 219);">否</td><td style="border-color: rgb(53, 152, 219);">需与易百技术约定后启用</td></tr><tr><td style="border-color: rgb(53, 152, 219);">goodsTag</td><td style="border-color: rgb(53, 152, 219);">订单优惠标记</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">否</td><td style="border-color: rgb(53, 152, 219);">特殊活动标记，需与易百技术约定后启用</td></tr><tr><td style="border-color: rgb(53, 152, 219);">authCode</td><td style="border-color: rgb(53, 152, 219);">付款码</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">subject</td><td style="border-color: rgb(53, 152, 219);">订单标题</td><td style="border-color: rgb(53, 152, 219);">String(256)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">orderTime</td><td style="border-color: rgb(53, 152, 219);">订单创建时间</td><td style="border-color: rgb(53, 152, 219);">String(19)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">yyyy-MM-dd HH:mm:ss</td></tr><tr><td style="border-color: rgb(53, 152, 219);">notifyUrl</td><td style="border-color: rgb(53, 152, 219);">支付回调地址</td><td style="border-color: rgb(53, 152, 219);">String(200)</td><td style="border-color: rgb(53, 152, 219);">否</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">goodsDetailList</td><td style="border-color: rgb(53, 152, 219);">订单商品明细</td><td style="border-color: rgb(53, 152, 219);">List</td><td style="border-color: rgb(53, 152, 219);">否</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);"> |\_\_ gid</td><td style="border-color: rgb(53, 152, 219);">商品编号</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);"> |\_\_ gname</td><td style="border-color: rgb(53, 152, 219);">商品名称</td><td style="border-color: rgb(53, 152, 219);">String(256)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);"> |\_\_ quantity</td><td style="border-color: rgb(53, 152, 219);">商品数量</td><td style="border-color: rgb(53, 152, 219);">Number</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);"> |\_\_ price</td><td style="border-color: rgb(53, 152, 219);">商品价格</td><td style="border-color: rgb(53, 152, 219);">Number</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">单位分</td></tr><tr><td style="border-color: rgb(53, 152, 219);"> |\_\_ category</td><td style="border-color: rgb(53, 152, 219);">商品类目</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr></tbody></table>

#### 请求示例

```json
"bizContent": {
    "traceNo": "20240710112246541_11130101",
    "merOrderNo": "0007525202407100000835",
    "totalAmount": 3300,
    "deviceNo": "83520001",
    "storeId": "111301",
    "goodsTag": "",
    "authCode": "132951513806421759",
    "subject": "中-冰美式",
    "notifyUrl": "",
    "goodsDetailList": [
        {
            "gid": "010403",
            "gname": "中-冰美式",
            "quantity": 1,
            "price": 3300,
            "category": "2"
        }
    ]
}
```

#### 返回参数

<table border="1" id="bkmrk-%E5%8F%82%E6%95%B0%E5%90%8D-%E8%AF%B4%E6%98%8E-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%A4%87%E6%B3%A8-1" style="border-collapse: collapse; width: 100%; height: 774.719px; border-width: 1px; border-color: rgb(53, 152, 219);"><colgroup><col style="width: 5.60191%;"></col><col style="width: 32.7771%;"></col><col style="width: 20.9774%;"></col><col style="width: 10.9654%;"></col><col style="width: 9.0584%;"></col><col style="width: 20.739%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td colspan="2" style="border-color: rgb(53, 152, 219); height: 29.7969px;">**参数名**  
</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">**说明**</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">**类型**</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">**是否必填**</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">**备注**</td></tr><tr style="height: 29.7969px;"><td rowspan="25" style="border-color: rgb(53, 152, 219); vertical-align: middle; height: 744.923px;">data  
</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">payChannel</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">支付渠道</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">String(32)</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">是</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">wxpay微信；alipay支付宝；dongfu东福随心兑</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">transactionNo</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">易百交易号</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">String(32)</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">是</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">  
</td></tr><tr style="height: 29.7969px;"><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">paymentNo</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">收单机构交易号</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">String(40)</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">否</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">traceNo</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">交易流水号</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">String(32)</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">是</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">按请求原样下发</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">transTime</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">交易时间</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">String(19)</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">是</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">yyyy-MM-dd HH:mm:ss</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">account</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">支付账号</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">String(40)</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">否</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">openId</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">用户唯一标识</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">String(128)</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">否</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">totalAmount</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">交易总金额</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">Number</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">是</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">单位分，按请求原样下发</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">receiptAmount</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">实收金额</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">Number</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">是</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">单位分</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">mdiscountAmount</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">商家优惠金额</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">Number</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">否</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">单位分</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">discountAmount</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">平台优惠金额</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">Number</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">否</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">单位分</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">payAmount</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">用户付款金额</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">Number</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">是</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">单位分</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">invoiceAmount</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">给用户可开发票金额</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">Number</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">是</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">单位分</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">storeName</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">交易门店名称</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">String(200)</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">是</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">voucherDetailList</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">交易支付所用优惠券信息</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">List</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">否</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">  
</td></tr><tr style="height: 29.7969px;"><td style="border-color: rgb(53, 152, 219); height: 29.7969px;"> |\_\_ activityId</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">活动ID或券模板ID</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">String(32)</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">否</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="border-color: rgb(53, 152, 219); height: 29.7969px;"> |\_\_ id</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">券ID</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">String(32)</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">是</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="border-color: rgb(53, 152, 219); height: 29.7969px;"> |\_\_ name</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">券名称</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">String(64)</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">是</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="border-color: rgb(53, 152, 219); height: 29.7969px;"> |\_\_ type</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">券类型</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">String(32)</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">是</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="border-color: rgb(53, 152, 219); height: 29.7969px;"> |\_\_ amount</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">券面额</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">Number</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">是</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">单位分</td></tr><tr style="height: 29.7969px;"><td style="border-color: rgb(53, 152, 219); height: 29.7969px;"> |\_\_ merchantContribute</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">商家出资</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">Number</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">否</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">单位分</td></tr><tr style="height: 29.7969px;"><td style="border-color: rgb(53, 152, 219); height: 29.7969px;"> |\_\_ otherContribute</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">其他出资方</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">Number</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">否</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">单位分</td></tr><tr style="height: 29.7969px;"><td style="border-color: rgb(53, 152, 219); height: 29.7969px;"> |\_\_ purchaseBuyerContribute</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">用户购买实付金额</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">Number</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">否</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">单位分</td></tr><tr style="height: 29.7969px;"><td style="border-color: rgb(53, 152, 219); height: 29.7969px;"> |\_\_ purchaseMerchantContribute</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">用户购买商家优惠金额</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">Number</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">否</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">单位分</td></tr><tr style="height: 29.7969px;"><td style="border-color: rgb(53, 152, 219); height: 29.7969px;"> |\_\_ purchaseAntContribute</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">用户购买平台优惠金额</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">Number</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">否</td><td style="border-color: rgb(53, 152, 219); height: 29.7969px;">单位分</td></tr></tbody></table>

#### 返回示例

```json
{
	"data": {
		"payChannel": "wxpay",
		"transactionNo": "",
		"paymentNo": "4200002227202407102297768192",
		"traceNo": "20240710112246541_11130101",
		"transTime": "2024-07-10 11:28:54",
		"account": "",
		"openId": "o2Jh6jtk9v28kSk2GUuyqhtdzUTs",
		"totalAmount": 3300,
		"receiptAmount": 3300,
		"mdiscountAmount": 0,
		"discountAmount": 0,
		"payAmount": 3300,
		"invoiceAmount": 3300,
		"storeName": "xxx昆山首创奥特莱斯店"
	}
}
```

# 查询订单

#### 接口用途 

当调用订单支付接口失败、网络超时、交易状态未知时调此接口来查询订单结果信息

#### 接口地址

/payment/query

#### 请求参数

<table border="1" id="bkmrk-%E5%8F%82%E6%95%B0%E5%90%8D-%E8%AF%B4%E6%98%8E-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%A4%87%E6%B3%A8" style="border-collapse: collapse; width: 100%; height: 119.188px; border-width: 1px; border-color: rgb(53, 152, 219);"><colgroup><col style="width: 10.8462%;"></col><col style="width: 13.8257%;"></col><col style="width: 15.3757%;"></col><col style="width: 9.65435%;"></col><col style="width: 9.29678%;"></col><col style="width: 41.0012%;"></col></colgroup><thead><tr style="height: 29.7969px;"><td colspan="2" style="border-color: rgb(53, 152, 219);">**参数名**  
</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">**说明**</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">**类型**</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">**是否必填**</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">**备注**</td></tr></thead><tbody><tr style="height: 29.7969px;"><td class="align-center" rowspan="3" style="border-color: rgb(53, 152, 219); vertical-align: middle;">bizContent</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">traceNo</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">交易流水号</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">String(32)</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">是</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">全局唯一，用于标识唯一交易</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">originalTraceNo</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">原支付流水号</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">String(32)</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">是</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">originalDate</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">原交易日期</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">String(8)</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">否</td><td style="height: 29.7969px; border-color: rgb(53, 152, 219);">传入需要查询的原交易日期，不传默认为当天格式为yyyyMMdd</td></tr></tbody></table>

#### 请求示例

```json
"bizContent": {
    "traceNo": "20240710112246541_11140102",
    "originalTraceNo": "20240710112246541_11130101",
    "originalDate": 20240710
}
```

#### 返回参数

<table border="1" id="bkmrk-%E5%8F%82%E6%95%B0%E5%90%8D-%E8%AF%B4%E6%98%8E-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%A4%87%E6%B3%A8-1" style="border-collapse: collapse; border-width: 1px; border-color: rgb(53, 152, 219);"><colgroup><col style="width: 5.7211%;"></col><col style="width: 15.8522%;"></col><col style="width: 18.4744%;"></col><col style="width: 13.4684%;"></col><col style="width: 10.3685%;"></col><col style="width: 36.2346%;"></col></colgroup><tbody><tr><td colspan="2" style="border-color: rgb(53, 152, 219);">**参数名**  
</td><td style="border-color: rgb(53, 152, 219);">**说明**</td><td style="border-color: rgb(53, 152, 219);">**类型**</td><td style="border-color: rgb(53, 152, 219);">**是否必填**</td><td style="border-color: rgb(53, 152, 219);">**备注**</td></tr><tr><td class="align-center" rowspan="14" style="border-color: rgb(53, 152, 219);">data

</td><td style="border-color: rgb(53, 152, 219);">payChannel</td><td style="border-color: rgb(53, 152, 219);">支付渠道</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">transactionNo</td><td style="border-color: rgb(53, 152, 219);">易百交易号</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">paymentNo</td><td style="border-color: rgb(53, 152, 219);">收单机构交易号</td><td style="border-color: rgb(53, 152, 219);">String(40)</td><td style="border-color: rgb(53, 152, 219);">否</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">traceNo</td><td style="border-color: rgb(53, 152, 219);">交易流水号</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">按请求原样下发</td></tr><tr><td style="border-color: rgb(53, 152, 219);">transTime</td><td style="border-color: rgb(53, 152, 219);">交易时间</td><td style="border-color: rgb(53, 152, 219);">datetime</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">account</td><td style="border-color: rgb(53, 152, 219);">支付账号</td><td style="border-color: rgb(53, 152, 219);">String(40)</td><td style="border-color: rgb(53, 152, 219);">否</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">openId</td><td style="border-color: rgb(53, 152, 219);">用户唯一标识</td><td style="border-color: rgb(53, 152, 219);">String(128)</td><td style="border-color: rgb(53, 152, 219);">否</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">totalAmount</td><td style="border-color: rgb(53, 152, 219);">交易总金额</td><td style="border-color: rgb(53, 152, 219);">Number</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">单位分，按请求原样下发</td></tr><tr><td style="border-color: rgb(53, 152, 219);">receiptAmount</td><td style="border-color: rgb(53, 152, 219);">实收金额</td><td style="border-color: rgb(53, 152, 219);">Number</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">单位分</td></tr><tr><td style="border-color: rgb(53, 152, 219);">mdiscountAmount</td><td style="border-color: rgb(53, 152, 219);">商家优惠金额</td><td style="border-color: rgb(53, 152, 219);">Number</td><td style="border-color: rgb(53, 152, 219);">否</td><td style="border-color: rgb(53, 152, 219);">单位分</td></tr><tr><td style="border-color: rgb(53, 152, 219);">discountAmount</td><td style="border-color: rgb(53, 152, 219);">平台优惠金额</td><td style="border-color: rgb(53, 152, 219);">Number</td><td style="border-color: rgb(53, 152, 219);">否</td><td style="border-color: rgb(53, 152, 219);">单位分</td></tr><tr><td style="border-color: rgb(53, 152, 219);">payAmount</td><td style="border-color: rgb(53, 152, 219);">用户付款金额</td><td style="border-color: rgb(53, 152, 219);">Number</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">单位分</td></tr><tr><td style="border-color: rgb(53, 152, 219);">invoiceAmount</td><td style="border-color: rgb(53, 152, 219);">给用户可开发票金额</td><td style="border-color: rgb(53, 152, 219);">Number</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">单位分</td></tr><tr><td style="border-color: rgb(53, 152, 219);">storeName</td><td style="border-color: rgb(53, 152, 219);">交易门店名称</td><td style="border-color: rgb(53, 152, 219);">String(200)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr></tbody></table>

#### 返回示例

```json
{
	"data": {
		"payChannel": "wxpay",
		"transactionNo": "",
		"paymentNo": "4200002227202407102297768192",
		"traceNo": "20240710112246541_11130101",
		"transTime": "2024-07-10 11:28:54",
		"account": "",
		"openId": "o2Jh6jtk9v28kSk2GUuyqhtdzUTs",
		"totalAmount": 3300,
		"receiptAmount": 3300,
		"mdiscountAmount": 0,
		"discountAmount": 0,
		"payAmount": 3300,
		"invoiceAmount": 3300,
		"storeName": "xxx昆山首创奥特莱斯店"
	}
}
```

# 申请退款

#### 接口用途

当用户或商户要进行支付后退款时调用此接口

#### 接口地址

/payment/refund

#### 请求参数

<table border="1" id="bkmrk-%E5%8F%82%E6%95%B0%E5%90%8D-%E8%AF%B4%E6%98%8E-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%A4%87%E6%B3%A8" style="border-collapse: collapse; border-width: 1px; border-color: rgb(53, 152, 219); width: 100%;"><colgroup><col style="width: 10.7271%;"></col><col style="width: 13.7074%;"></col><col style="width: 12.276%;"></col><col style="width: 10.6079%;"></col><col style="width: 9.17759%;"></col><col style="width: 43.5042%;"></col></colgroup><thead><tr><td colspan="2" style="border-color: rgb(53, 152, 219);">**参数名**  
</td><td style="border-color: rgb(53, 152, 219);">**说明**</td><td style="border-color: rgb(53, 152, 219);">**类型**</td><td style="border-color: rgb(53, 152, 219);">**是否必填**</td><td style="border-color: rgb(53, 152, 219);">**备注**</td></tr></thead><tbody><tr><td class="align-center" rowspan="6" style="border-color: rgb(53, 152, 219); vertical-align: middle;">bizContent</td><td style="border-color: rgb(53, 152, 219);">traceNo</td><td style="border-color: rgb(53, 152, 219);">交易流水号</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">全局唯一，用于标识唯一交易</td></tr><tr><td style="border-color: rgb(53, 152, 219);">storeId</td><td style="border-color: rgb(53, 152, 219);">商户门店编号</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">originalTraceNo</td><td style="border-color: rgb(53, 152, 219);">原支付流水号</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">originalDate</td><td style="border-color: rgb(53, 152, 219);">原交易日期</td><td style="border-color: rgb(53, 152, 219);">String(8)</td><td style="border-color: rgb(53, 152, 219);">否</td><td style="border-color: rgb(53, 152, 219);">传入需要退款的原支付交易日期，不传默认为当天，格式为yyyyMMdd</td></tr><tr><td style="border-color: rgb(53, 152, 219);">refundAmount</td><td style="border-color: rgb(53, 152, 219);">本次退款金额</td><td style="border-color: rgb(53, 152, 219);">Number</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">单位分</td></tr><tr><td style="border-color: rgb(53, 152, 219);">refundReason</td><td style="border-color: rgb(53, 152, 219);">退款原因</td><td style="border-color: rgb(53, 152, 219);">String(128)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr></tbody></table>

#### 请求示例

```json
"bizContent": {
  "traceNo": "20240906NJ0070101960163503934",
  "storeId": "111301",
  "originalTraceNo": "20240906NJ0070101960163406444",
  "originalDate": "20240906",
  "refundAmount": 13,
  "refundReason": "正常退款"
}
```

#### 返回参数

<table border="1" id="bkmrk-%E5%8F%82%E6%95%B0%E5%90%8D-%E8%AF%B4%E6%98%8E-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%A4%87%E6%B3%A8-da" style="border-collapse: collapse; border-width: 1px; border-color: rgb(53, 152, 219); width: 100%;"><colgroup><col style="width: 6.7911%;"></col><col style="width: 13.2248%;"></col><col style="width: 20.0159%;"></col><col style="width: 20.0159%;"></col><col style="width: 10.3654%;"></col><col style="width: 29.6664%;"></col></colgroup><tbody><tr><td colspan="2" style="border-color: rgb(53, 152, 219);">**参数名  
</td><td style="border-color: rgb(53, 152, 219);">**说明**</td><td style="border-color: rgb(53, 152, 219);">**类型**</td><td style="border-color: rgb(53, 152, 219);">**是否必填**</td><td style="border-color: rgb(53, 152, 219);">**备注**</td></tr><tr><td class="align-center" rowspan="6" style="border-color: rgb(53, 152, 219); vertical-align: middle;">data  
</td><td style="border-color: rgb(53, 152, 219);">traceNo</td><td style="border-color: rgb(53, 152, 219);">交易流水号</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">全局唯一，用于标识唯一交易</td></tr><tr><td style="border-color: rgb(53, 152, 219);">transactionNo</td><td style="border-color: rgb(53, 152, 219);">易百交易号</td><td style="border-color: rgb(53, 152, 219);">String(32)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">refundNo</td><td style="border-color: rgb(53, 152, 219);">收单机构退款单号</td><td style="border-color: rgb(53, 152, 219);">String(40)</td><td style="border-color: rgb(53, 152, 219);">否</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">transTime</td><td style="border-color: rgb(53, 152, 219);">交易时间</td><td style="border-color: rgb(53, 152, 219);">datetime</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr><tr><td style="border-color: rgb(53, 152, 219);">refundAmount</td><td style="border-color: rgb(53, 152, 219);">退款成功总金额</td><td style="border-color: rgb(53, 152, 219);">Number</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">单位分</td></tr><tr><td style="border-color: rgb(53, 152, 219);">storeName</td><td style="border-color: rgb(53, 152, 219);">交易门店名称</td><td style="border-color: rgb(53, 152, 219);">String(200)</td><td style="border-color: rgb(53, 152, 219);">是</td><td style="border-color: rgb(53, 152, 219);">  
</td></tr></tbody></table>

#### 返回示例

```json
{
    "data": {
        "traceNo": "20240906NJ0070101960163503934",
        "refundNo": "20240906NJ0070101960163406444",
        "transTime": "2024-07-10 11:28:54",
        "refundAmount": 13,
        "storeName": "xxx昆山首创奥特莱斯店"
    }
}
```