开放平台

核销优惠券或者SN码

请求地址(POST)

https://openapi.1card1.cn/OpenApi/SubCoupon?openId=[OpenId]&signature=[Signature]&timestamp=[TimeStamp]

字段 说明
OpenId 登陆开放平台生成的OpenId
Signature 签名=md5(OpenId+Secret+Timestamp+data),格式:32位md5大写加密
TimeStamp 发起请求的时间戳,查看标准timestamp

请求说明

data={"userAccount": "10003","couponSendGuid": "79804c2f-0e3e-e411-97f7-0013d4497493","subCount": 2,"snCodes":"snCode1,snCode2"}

字段 是否必须 说明
userAccount 工号
couponSendGuid 优惠券发送记录唯一标识(通过“获取已发送优惠券”获得“Guid”字段,(与subCount共同生效))
subCount 优惠券核销数量(与couponSendGuid共同生效)
snCodes 团购券SN码(多个SN码用英文逗号隔开,couponSendGuid与subCount都为空时生效,即不与优惠券同时核销)

返回说明

成功时返回:

{"status":0,"message":"核销成功!","couponUsedNoteGuid":"xxx"}

失败时返回:

{"status":-1,"message":"操作失败及原因"}

字段 是否必须 说明
status 状态(0,成功;-1,失败)
message 核销优惠券是否成功及提示语
couponUsedNoteGuid 核销记录唯一标识(如果核销成功,并且核销的是优惠券,则返回此字段)

核销 调试