Skip to main content

卡号段激活实体卡券（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

是

 

数量

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 都不传，默认三年有效期。）

请求报文举例

{
    "traceNo": "99000009100010101732123",
    "qrcode": "R156A001-0000491-0505,R156A002-0000491-0505",
    "totalAmount": "3000",
    "businessType": 12
}

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

字段 类型 是否必填 字段意义 备注

ver

int

是

2

接口版本

statusCode

int

是

100：SUCCESS

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

        80表示处理中；

        81 表示处理完成。

 

message

string

是

成功

状态码描述

createTime

string

否

 

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

sign

string

是

 

参考签名举例
         

返回报文举例

{
    "traceNo": "99000009100010101732123",
    "orderNo": "99000009100010101732123",
    "transDate": "20161231120533",
    "returnCode": "00",
    "returnDesc": "SUCCESS"
}
Back to top