核销优惠券或者SN码
请求地址(POST)
https://openapi.1card1.cn/OpenApi/SubCoupon?openId=[OpenId]&signature=[Signature]×tamp=[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 | 否 | 核销记录唯一标识(如果核销成功,并且核销的是优惠券,则返回此字段) |