# 第三方码核销转发

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

- 当电子凭证平台需要调用外部制码方进行核销时，调用该接口。

#### **接口说明**

- 该接口为电子凭证平台调用ESB做核销操作，ESB再根据不同制码方拼装报文并实时请求。

**请求参数，[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")===>ESB**

<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-c"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>channelId</td><td>String</td><td>是</td><td>制码方id</td><td> </td></tr><tr><td>transferAction</td><td>String</td><td>是</td><td>操作类型</td><td>ThirdCodeVerify</td></tr><tr><td>transferUrl</td><td>String</td><td>是</td><td>通知地址</td><td> </td></tr><tr><td>messageType</td><td>String</td><td>是</td><td>报文类型</td><td>Ebuy:易百标准报文格式，Third:第三方自定义格式</td></tr><tr><td>whaleMessage</td><td>String</td><td>是</td><td>易百标准报文</td><td>内容如下文</td></tr></tbody></table>

**易百标准报文：第三方码实时核销请求报文**

<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-a"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>appId</td><td>String(10)</td><td>是</td><td>电子凭证系统对接方id</td><td> </td></tr><tr><td>action</td><td>String(20)</td><td>是</td><td>业务标识</td><td>ThirdCodeVerify</td></tr><tr><td>bizContent</td><td>String&lt;[thirdVerifyTransferRequest](https://book.e-buy.com/books/e-buy-40/page/http "thirdVerifyTransferRequest")&gt;</td><td>是</td><td>第三方码实时作废数据</td><td>需要base64解码</td></tr><tr><td>version</td><td>String(10)</td><td>是</td><td>版本号</td></tr><tr><td>timestamp</td><td>String</td><td>是</td><td>时间戳</td><td> </td></tr><tr><td>sign</td><td>String</td><td>是</td><td>签名</td></tr></tbody></table>

**返回参数，ESB===&gt;[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")**

<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-c-0"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>channelId</td><td>String</td><td>是</td><td>渠道id。原样返回</td><td> </td></tr><tr><td>requestId</td><td>String</td><td>是</td><td>请求流水号。原样返回</td><td> </td></tr><tr><td>returnCode</td><td>String</td><td>是</td><td>返回码</td><td> </td></tr><tr><td>returnMsg</td><td>String</td><td>是</td><td>返回信息</td><td> </td></tr><tr><td>whaleMessage</td><td>String</td><td>是</td><td>易百标准报文</td><td>内容如下文</td></tr></tbody></table>

**易百标准报文：第三方码实时核销返回报文**

<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-a-0"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>appId</td><td>String(10)</td><td>是</td><td>电子凭证系统对接方id</td><td> </td></tr><tr><td>action</td><td>String(20)</td><td>是</td><td>业务标识</td><td>ThirdCodeVerify</td></tr><tr><td>bizContent</td><td>String&lt;[thirdVerifyTransferResponse](https://book.e-buy.com/books/e-buy-40/page/http "thirdVerifyTransferResponse")&gt;</td><td>是</td><td>第三方码实时作废数据</td><td>需要base64解码</td></tr><tr><td>version</td><td>String(10)</td><td>是</td><td>版本号</td></tr><tr><td>timestamp</td><td>String</td><td>是</td><td>时间戳</td><td> </td></tr><tr><td>sign</td><td>String</td><td>是</td><td>签名</td></tr></tbody></table>