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

接口用途 

 指定券码号段激活，相同 激活订单号直接返回当前状态 

   

 

 action 

 b2b/code/activeByPartNo 

 请求参数，中间件===>易百后台 

 字段 

 类型 

 是否必填 

 字段意义 

 备注 

 

 ver 

 

 

 int 

 

 

 是 

 

 

 2 

 

 

 接口版本(固定参数值) 

 

 

 partnerId 

 

 

 int 

 

 

 是 

 

 

 1504 

 

 

 商户编号 (固定参数值) 

 

 

 merchantId 

 

 

 string 

 

 

 是 

 

 

 10001(星巴克中国) 

 

 

 App商家在非码系统中的编 号(固定参数值) 

 

 

 s ign 

 

 

 string 

 

 

 是 

 

 

   

 

 

 参考签名举例 

 

 

 partnerOrderId 

 

 

 String 

 

 

 是 

 

 

   

 

 

 激活订单号，商户激活操作唯一，最大 28 位。(若第一次请求成功的订单号再次请求，则返回此订单号处理进度，与 startCardSe 、 endCardSe 值无关) 

 

 

 type 

 

 

 int 

 

 

 是 

 

 

   

 

 

 激活对象类型(固定值实体券2) 

 

 

 bin 

 

 

 string 

 

 

 是 

 

 

   

 

 

 卡 bin ( 实体券： 7020 )获取券码取前 4 位 

 

 

 codeType 

 

 

 string 

 

 

 是 

 

 

   

 

 

 激活实体券时必填， 3 位 

 

 

 startCardSe 

 

 

 string 

 

 

 是 

 

 

   

 

 

 起始激活卡券号段,含当前号段。（ 7 位） 

 

 

 endCardSe 

 

 

 string 

 

 

 是 

 

 

   

 

 

 终止激活卡券号段,含当前号段。（ 7 位） 

 

 

 number 

 

 

 int 

 

 

 是 

 

 

   

 

 

 激活数量 

 

 

 sellingPrice 

 

 

 int 

 

 

 是 

 

 

   

 

 

 商品成本价 ，单位：分（激活实体券时必传，若没有 A,B账户则传sellingPrice=costPrice）。 

 

 

 costPrice 

 

 

 int 

 

 

 是 

 

 

   

 

 

 商品售价。此字段不能大于 sellingPrice，单位：分（激活实体券时必传，若没有A,B账户则传sellingPrice=costPrice）（折扣价 =成本价-售价 ）。 

 

 

 validStart 

 

 

 String 

 

 

 否 

 

 

   

 

 

 有效期开始时间，格式： yyyy - MM - dd HH : mm : ss （激活实体券时使用，激活时若 validStart 和 validEnd 都不传，默认三年有效期。） 

 

 

 valid_end 

 

 

 string 

 

 

 否 

 

 

   

 

 

 有效期结束时间 ,格式： yyyy - MM - dd HH : mm : ss （激活实体券时使用，激活时若 validStart 和 validEnd 都不传，默认三年有效期。） 

 

 请求报文举例 

 {

	"ver": 2,

	"partnerId": 1504,

	"sign": "skip",

	"merchantId": 10001,

	"partnerOrderId": "2040132213w9181w0q77awwwd8",

	"type": 2,

 "bin": "7020",

 "startCardSe": "0000041",

 "endCardSe": "0000045",

 "sellingPrice": "10000",

 "costPrice": "8888",

 "number": 14

} 

 返回参数，易百后台===>中件间 

 字段 

 类型 

 是否必填 

 字段意义 

 备注 

 

 ver 

 

 

 int 

 

 

 是 

 

 

 2 

 

 

 接口版本 

 

 

 statusCode 

 

 

 int 

 

 

 是 

 

 

 100：SUCCESS 

 

 

 返回码： 100 表示创建成功； 

 

 80 表示处理中； 

 

 81 表示处理完成。 

   

 

 

 message 

 

 

 string 

 

 

 是 

 

 

 成功 

 

 

 状态码描述 

 

 

 createTime 

 

 

 string 

 

 

 否 

 

 

   

 

 

 激活订单创建时间（返回 100、80、81时，有值）格式： yyyyMMddHHmmss 

 

 

 s ign 

 

 

 string 

 

 

 是 

 

 

   

 

 

 参考签名举例 

 

   

   

   

   

   

 返回报文举例 

 {

"createTime": "20200212100234",

"message": "处理中",

"sign": "EOMRl+jWgjGOTebWPRVqBDR1EPkyd/S7tsb/yEjvBoSfUZCEgVA6RNrjVEmIY15uJI9YV57tOZWy1FiVqJDH0lfEJnuk4DKpwcJMVCGXjQIH/Cd+PCibwBNknDWt9kaiB9JhxW8TrlBLYWq4ZyzffYtsF4qawyBgTLeUuPEOvoLZ2jA5OLtbSYVyI9g3OI4amcL25/GkRUw3ECmziAy9bTdVKmjV5FbWcyk45GM+K7/2a4/E6BihvVC2w6ge6xgDn0s5R9Ixaun5KhqcEJLHW/8vEAHMbx40uvsP91Aw9iiw5aZeGhpYoge89vAVTkC5boB8i+pgcpk0DqK4Jk25mA==",

"statusCode": 80,

"ver": 2

}