# 第三方微信卡包通知

### 调用第三方插入微信卡包接口

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

- 当取码方需要易百协助调用制码方完成微信卡包通知时，电子凭证平台请求ESB调用此接口。
- 制码方需提供给易百相应URL。

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

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

#### **url**

- `activityInsert`

**请求参数，[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100#whale "易百电子凭证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>requestId</td><td>String</td><td>是</td><td>请求流水号</td><td>32个字符，用于标识唯一一笔交易</td></tr><tr><td>codes</td><td>String</td><td>是</td><td>码号</td><td> </td></tr><tr><td>userUnionId</td><td>String</td><td>否</td><td>微信用户唯一识别号</td><td> </td></tr><tr><td>appId</td><td>String</td><td>否</td><td>公众号id</td><td> </td></tr><tr><td>userOpenId</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>

**请求报文举例**

```
{
    "channelId":"10002401",
    "requestId": "20181019112535100000000000000002",
    "codes": "1021242013780905000",
    "userUnionId":"2429********************",
    "sign":"deid3412dj98s34lix"
}

```

**返回参数，ESB===&gt;[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100#whale "易百电子凭证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-r"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><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></tr></tbody></table>

**返回报文举例**

```
{
    "returnCode": "00",
    "returnMsg": "操作成功",
}
```