# 卡号段激活实体卡券（B2B定制）

**接口用途**

- 指定券码号段激活，相同<span style="font-family: 微软雅黑;">激活订单号直接返回当前状态</span>

**action**

- b2b/code/activeByPartNo

**请求参数，中间件===&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"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td valign="center" width="410">ver

</td><td valign="center" width="81">int

</td><td valign="center" width="146"><span style="font-family: 宋体;">是</span>

</td><td valign="center" width="271"><span style="font-family: 宋体;">2</span>

</td><td valign="center" width="214"><span style="font-family: 宋体;">接口版本(固定参数值)</span>

</td></tr><tr><td valign="center" width="410">partnerId

</td><td valign="center" width="81"><span style="font-family: 宋体;">int</span>

</td><td valign="center" width="146"><span style="font-family: 宋体;">是</span>

</td><td valign="center" width="271"><span style="font-family: 宋体;">1504</span>

</td><td valign="center" width="214"><span style="font-family: 宋体;">商户编号</span><span style="font-family: 宋体;">(固定参数值)</span>

</td></tr><tr><td valign="center" width="410">merchantId

</td><td valign="center" width="81"><span style="font-family: 宋体;">string</span>

</td><td valign="center" width="146"><span style="font-family: 宋体;">是</span>

</td><td valign="center" width="271">10001(星巴克中国)

</td><td valign="center" width="214"><span style="font-family: 宋体;">App商家在非码系统中的编</span><span style="font-family: 宋体;">号(固定参数值)</span>

</td></tr><tr><td valign="center" width="410">s<span style="font-family: 宋体;">ign</span>

</td><td valign="center" width="81"><span style="font-family: 宋体;">string</span>

</td><td valign="center" width="146"><span style="font-family: 宋体;">是</span>

</td><td valign="center" width="271"></td><td valign="center" width="214"><span style="font-family: 宋体;">参考签名举例</span>

</td></tr><tr><td valign="center" width="410"><span style="font-family: 宋体;">partnerOrderId</span>

</td><td valign="center" width="81"><span style="font-family: 宋体;">String </span>

</td><td valign="center" width="146"><span style="font-family: 宋体;">是</span>

</td><td valign="center" width="271"></td><td valign="center" width="214"><span style="font-family: 微软雅黑;">激活订单号，商户激活操作唯一，最大</span><span style="font-family: 宋体;">28</span><span style="font-family: 微软雅黑;">位。(若第一次请求成功的订单号再次请求，则返回此订单号处理进度，与</span><span style="font-family: 宋体;">startCardSe</span><span style="font-family: 微软雅黑;">、</span><span style="font-family: 宋体;">endCardSe</span><span style="font-family: 微软雅黑;">值无关)</span>

</td></tr><tr><td valign="top" width="410"><span style="font-family: 宋体;">type</span>

</td><td valign="top" width="81"><span style="font-family: 宋体;">int</span>

</td><td valign="top" width="146"><span style="font-family: 宋体;">是</span>

</td><td valign="top" width="271"></td><td valign="top" width="214"><span style="font-family: 宋体;">激活对象类型(固定值实体券2)</span>

</td></tr><tr><td valign="center" width="410"><span style="font-family: 宋体;">bin</span>

</td><td valign="top" width="81"><span style="font-family: 宋体;">string</span>

</td><td valign="top" width="146"><span style="font-family: 宋体;">是</span>

</td><td valign="center" width="271"></td><td valign="center" width="214"><span style="font-family: 微软雅黑;">卡</span><span style="font-family: 宋体;">bin</span><span style="font-family: 微软雅黑;">(</span><span style="font-family: 微软雅黑;">实体券：</span><span style="font-family: 宋体;">7020</span><span style="font-family: 微软雅黑;">)获取券码取前<span style="font-family: 宋体;">4</span>位</span>

</td></tr><tr><td valign="center" width="410"><span style="font-family: 宋体;">codeType</span>

</td><td valign="top" width="81"><span style="font-family: 宋体;">string</span>

</td><td valign="top" width="146"><span style="font-family: 宋体;">是</span>

</td><td valign="center" width="271"></td><td valign="center" width="214"><span style="font-family: 微软雅黑;">激活实体券时必填，</span><span style="font-family: 宋体;">3</span><span style="font-family: 微软雅黑;">位</span>

</td></tr><tr><td valign="center" width="410"><span style="font-family: 宋体;">startCardSe</span>

</td><td valign="center" width="81"><span style="font-family: 宋体;">string</span>

</td><td valign="center" width="146"><span style="font-family: 宋体;">是</span>

</td><td valign="center" width="271"></td><td valign="center" width="214"><span style="font-family: 微软雅黑;">起始激活卡券号段,含当前号段。（</span><span style="font-family: 宋体;">7</span><span style="font-family: 微软雅黑;">位）</span>

</td></tr><tr><td valign="center" width="410"><span style="font-family: 宋体;">endCardSe</span>

</td><td valign="top" width="81"><span style="font-family: 宋体;">string</span>

</td><td valign="top" width="146"><span style="font-family: 宋体;">是</span>

</td><td valign="center" width="271"></td><td valign="center" width="214"><span style="font-family: 微软雅黑;">终止激活卡券号段,含当前号段。（</span><span style="font-family: 宋体;">7</span><span style="font-family: 微软雅黑;">位）</span>

</td></tr><tr><td valign="center" width="410"><span style="font-family: 宋体;">number</span>

</td><td valign="top" width="81"><span style="font-family: 宋体;">int</span>

</td><td valign="top" width="146"><span style="font-family: 宋体;">是</span>

</td><td valign="center" width="271"></td><td valign="center" width="214"><span style="font-family: 微软雅黑;">激活数量</span>

</td></tr><tr><td valign="center" width="410"><span style="font-family: 宋体;">sellingPrice</span>

</td><td valign="top" width="81"><span style="font-family: 宋体;">int</span>

</td><td valign="top" width="146"><span style="font-family: 宋体;">是</span>

</td><td valign="center" width="271"></td><td valign="center" width="214"><span style="font-family: 宋体;">商品成本价</span> <span style="font-family: 宋体;">，单位：分（激活实体券时必传，若没有</span><span style="font-family: 宋体;">A,B账户则传sellingPrice=costPrice）。</span>

</td></tr><tr><td valign="center" width="410"><span style="font-family: 宋体;">costPrice</span>

</td><td valign="top" width="81"><span style="font-family: 宋体;">int</span>

</td><td valign="top" width="146"><span style="font-family: 宋体;">是</span>

</td><td valign="center" width="271"></td><td valign="center" width="214"><span style="font-family: 宋体;">商品售价。此字段不能大于</span><span style="font-family: 宋体;">sellingPrice，单位：分（激活实体券时必传，若没有A,B账户则传sellingPrice=costPrice）（折扣价</span>=成本价-售价<span style="font-family: 宋体;">）。</span>

</td></tr><tr><td valign="center" width="410"><span style="font-family: 宋体;">validStart</span>

</td><td valign="top" width="81"><span style="font-family: 宋体;">String</span>

</td><td valign="top" width="146"><span style="font-family: 宋体;">否</span>

</td><td valign="center" width="271"></td><td valign="center" width="214"><span style="font-family: 宋体;">有效期开始时间，格式：</span>yyyy<span style="font-family: 宋体;">-</span>MM<span style="font-family: 宋体;">-</span>dd HH<span style="font-family: 宋体;">:</span>mm<span style="font-family: 宋体;">:</span>ss<span style="font-family: 宋体;">（激活实体券时使用，激活时若</span><span style="font-family: 宋体;">validStart 和 validEnd 都不传，默认三年有效期。）</span>

</td></tr><tr><td valign="top" width="410"><span style="font-family: 宋体;">valid\_end</span>

</td><td valign="top" width="81"><span style="font-family: 宋体;">string</span>

</td><td valign="top" width="146"><span style="font-family: 宋体;">否</span>

</td><td valign="top" width="271"></td><td valign="center" width="214"><span style="font-family: 宋体;">有效期结束时间</span><span style="font-family: 宋体;">,格式：</span>yyyy<span style="font-family: 宋体;">-</span>MM<span style="font-family: 宋体;">-</span>dd HH<span style="font-family: 宋体;">:</span>mm<span style="font-family: 宋体;">:</span>ss<span style="font-family: 宋体;">（激活实体券时使用，激活时若</span><span style="font-family: 宋体;">validStart 和 validEnd 都不传，默认三年有效期。）</span>

</td></tr></tbody></table>

**请求报文举例**

```
{
	"ver": 2,
	"partnerId": 1504,
	"sign": "skip",
	"merchantId": 10001,
	"partnerOrderId": "2040132213w9181w0q77awwwd8",
	"type": 2,
    "bin": "7020",
    "startCardSe": "0000041",
    "endCardSe": "0000045",
    "sellingPrice": "10000",
    "costPrice": "8888",
    "number": 14
}
```

**返回参数，易百后台===&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-1"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td valign="center" width="255">ver

</td><td valign="center" width="87">int

</td><td valign="center" width="88"><span style="font-family: 宋体;">是</span>

</td><td valign="center" width="229">2

</td><td valign="center" width="442"><span style="font-family: 宋体;">接口版本</span>

</td></tr><tr><td valign="top" width="255"><span style="font-family: 宋体;">statusCode</span>

</td><td valign="top" width="87"><span style="font-family: 宋体;">int</span>

</td><td valign="top" width="88"><span style="font-family: 宋体;">是</span>

</td><td valign="top" width="229"><span style="font-family: 宋体;">100：SUCCESS</span>

</td><td valign="top" width="442"><span style="font-family: 微软雅黑;">返回码：</span><span style="font-family: 宋体;">100</span><span style="font-family: 微软雅黑;">表示创建成功；</span>

 <span style="font-family: 宋体;">80</span><span style="font-family: 微软雅黑;">表示处理中；</span>

 <span style="font-family: 宋体;">81 </span><span style="font-family: 微软雅黑;">表示处理完成。</span>

</td></tr><tr><td valign="top" width="255"><span style="font-family: 宋体;">message</span>

</td><td valign="top" width="87"><span style="font-family: 宋体;">string</span>

</td><td valign="top" width="88"><span style="font-family: 宋体;">是</span>

</td><td valign="top" width="229"><span style="font-family: 宋体;">成功</span>

</td><td valign="top" width="442"><span style="font-family: 宋体;">状态码描述</span>

</td></tr><tr><td valign="top" width="255"><span style="font-family: 宋体;">createTime</span>

</td><td valign="top" width="87"><span style="font-family: 宋体;">string</span>

</td><td valign="top" width="88"><span style="font-family: 宋体;">否</span>

</td><td valign="top" width="229"></td><td valign="top" width="442"><span style="font-family: 宋体;">激活订单创建时间（返回</span><span style="font-family: 宋体;">100、80、81时，有值）格式：</span>yyyyMMddHHmmss

</td></tr><tr><td valign="center" width="255">s<span style="font-family: 宋体;">ign</span>

</td><td valign="center" width="87"><span style="font-family: 宋体;">string</span>

</td><td valign="center" width="88"><span style="font-family: 宋体;">是</span>

</td><td valign="center" width="229"></td><td valign="center" width="442"><span style="font-family: 宋体;">参考签名举例</span>

</td></tr><tr><td> </td><td> </td><td> </td><td> </td><td> </td></tr></tbody></table>

**返回报文举例**

```
{
    "createTime": "20200212100234",
    "message": "处理中",
    "sign": "EOMRl+jWgjGOTebWPRVqBDR1EPkyd/S7tsb/yEjvBoSfUZCEgVA6RNrjVEmIY15uJI9YV57tOZWy1FiVqJDH0lfEJnuk4DKpwcJMVCGXjQIH/Cd+PCibwBNknDWt9kaiB9JhxW8TrlBLYWq4ZyzffYtsF4qawyBgTLeUuPEOvoLZ2jA5OLtbSYVyI9g3OI4amcL25/GkRUw3ECmziAy9bTdVKmjV5FbWcyk45GM+K7/2a4/E6BihvVC2w6ge6xgDn0s5R9Ixaun5KhqcEJLHW/8vEAHMbx40uvsP91Aw9iiw5aZeGhpYoge89vAVTkC5boB8i+pgcpk0DqK4Jk25mA==",
    "statusCode": 80,
    "ver": 2
}

```