Skip to main content

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

接口用途

  • 激活

接口地址

  • https://ebuywebposp-test.dev-starbucks-gateway.e-buychina.buy.com/ebuyweb-posp/api/reelActiveVoucherstarbucksjs/b2b/code/activeByPartNo

action

  • activeVoucheractiveByPartNo

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

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

ver

 String

int

是

 收银机流水号

2

 不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列

接口版本
qrcode

partnerId

 String

int

是

 二维码内容

1504

 券

商户编号code，或本号reelId，或者包号pkgId，或者箱号boxId，用,号隔开(由非码提供)
totalAmount

merchantId

 String

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）。
businessType

costPrice

 Integer

int

 是

否

 业务类型

 

 当businessType=12时为新逻辑支持箱的概念，返回的数据中包含箱的结构，该

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

validStart

String

否

 

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

valid_end

string

否

 

有效期结束时间,格式：yyyy-MM-dd HH:mm:ss（激活实体券时使用，激活时若validStart 和 validEnd 都不做任何变动传，返回数据中不包含箱的结构默认三年有效期。）

请求报文举例

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

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

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

ver

 String

int

是

 收银机流水号

2

 不允许重复

接口版本
orderNo

statusCode

 String

int

是

 本次

100：SUCCESS

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

        80表示处理中；

        81 表示处理完成。

 

message

string

是

成功

状态码描述

createTime

string

否

 

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

sign

string

是

 

参考签名举例

   
transDate  String  是交易时间格式为：yyyyMMddHHmmss
returnCodeString是返回码A00表示正在激活中（等待，做结果查询）；A02表示有部分券处于不可激活状态（未进行激活）；A03表示其他异常（未进行激活）
returnDescString是返回信息交易结果描述或错误原因
voucherPkgList<voucherPkg>否电子券包信息返回电子券包信息

返回报文举例

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