卡号段激活实体卡券（B2B定制）
接口用途
- 激活
接口地址
-
https://dev-starbucks-gateway.e-buy.com/starbucksjs/b2b/code/activeByPartNo
action
- activeByPartNo
请求参数，中间件===>易百后台
| 字段 | 类型 | 是否必填 | 字段意义 | 备注 |
|---|---|---|---|---|
|
ver |
int |
是 |
2 |
接口版本 |
|
partnerId |
int |
是 |
1504 |
商户编号(由非码提供) |
|
merchantId |
string |
是 |
10001(星巴克中国) |
App商家在非码系统中的编 号 |
|
sign |
string |
是 |
|
参考签名举例 |
|
partnerOrderId |
String |
是 |
|
激活订单号，商户激活操作唯一，最大28位。（若第一次请求成功的订单号再次请求，则返回此订单号处理进度，与startCardSe、endCardSe值无关） |
|
type |
int |
是 |
|
激活对象类型，实体卡 1，实体券2 |
|
bin |
string |
是 |
|
卡bin（例：实体卡：731018 实体券：7020）卡取卡号前6位，券取前4位 |
|
codeType |
string |
否 |
|
激活实体券时必填，3位 |
|
startCardSe |
string |
是 |
|
起始激活卡券号段。（7位） |
|
endCardSe |
string |
是 |
|
终止激活卡券号段。（7位） |
|
number |
int |
是 |
|
数量 |
|
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 都不传，默认三年有效期。） |
请求报文举例
{
"traceNo"ver": 2,
"partnerId": 1504,
"sign": "99000009100010101732123"skip",
"qrcode"merchantId": 10001,
"partnerOrderId": "R156A001-0000491-0505,R156A002-0000491-0505"2040132213w9181w0q77awwwd8",
"totalAmount"type": 2,
"bin": "3000"7020",
"businessType"startCardSe": 12"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 |
是 |
|
参考签名举例 |
返回报文举例
{
"traceNo"createTime": "99000009100010101732123"20200212100234",
"orderNo"message": "99000009100010101732123"处理中",
"transDate"sign": "20161231120533"EOMRl+jWgjGOTebWPRVqBDR1EPkyd/S7tsb/yEjvBoSfUZCEgVA6RNrjVEmIY15uJI9YV57tOZWy1FiVqJDH0lfEJnuk4DKpwcJMVCGXjQIH/Cd+PCibwBNknDWt9kaiB9JhxW8TrlBLYWq4ZyzffYtsF4qawyBgTLeUuPEOvoLZ2jA5OLtbSYVyI9g3OI4amcL25/GkRUw3ECmziAy9bTdVKmjV5FbWcyk45GM+K7/2a4/E6BihvVC2w6ge6xgDn0s5R9Ixaun5KhqcEJLHW/8vEAHMbx40uvsP91Aw9iiw5aZeGhpYoge89vAVTkC5boB8i+pgcpk0DqK4Jk25mA==",
"returnCode"statusCode": "00",80,
"returnDesc"ver": "SUCCESS"2
}