卡号段激活实体卡券（B2B定制）
接口用途
- 指定券码号段激活，相同激活订单号直接返回当前状态
action
- b2b/code/activeByPartNo
请求参数，中间件===>易百后台
| 字段 | 类型 | 是否必填 | 字段意义 | 备注 |
|---|---|---|---|---|
|
ver |
int |
是 |
2 |
接口版本(固定参数值) |
|
partnerId |
int |
是 |
1504 |
商户编号(固定参数值) |
|
merchantId |
string |
是 |
10001(星巴克中国) |
App商家在非码系统中的编号(固定参数值) |
|
sign |
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 |
|
sign |
string |
是 |
|
参考签名举例 |
返回报文举例
{
"createTime": "20200212100234",
"message": "处理中",
"sign": "EOMRl+jWgjGOTebWPRVqBDR1EPkyd/S7tsb/yEjvBoSfUZCEgVA6RNrjVEmIY15uJI9YV57tOZWy1FiVqJDH0lfEJnuk4DKpwcJMVCGXjQIH/Cd+PCibwBNknDWt9kaiB9JhxW8TrlBLYWq4ZyzffYtsF4qawyBgTLeUuPEOvoLZ2jA5OLtbSYVyI9g3OI4amcL25/GkRUw3ECmziAy9bTdVKmjV5FbWcyk45GM+K7/2a4/E6BihvVC2w6ge6xgDn0s5R9Ixaun5KhqcEJLHW/8vEAHMbx40uvsP91Aw9iiw5aZeGhpYoge89vAVTkC5boB8i+pgcpk0DqK4Jk25mA==",
"statusCode": 80,
"ver": 2
}
No Comments