核销优惠券或者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","uniqueCode":"20251016001"}
| 字段 | 是否必须 | 说明 |
|---|---|---|
| userAccount | 是 | 工号 |
| couponSendGuid | 否 | 优惠券发送记录唯一标识(通过“获取已发送优惠券”获得“Guid”字段,(与subCount共同生效)) |
| subCount | 否 | 优惠券核销数量(与couponSendGuid共同生效) |
| snCodes | 否 | 团购券SN码(多个SN码用英文逗号隔开,couponSendGuid与subCount都为空时生效,即不与优惠券同时核销) |
| uniqueCode | 否 | 唯一码(实现幂等,如果该唯一码已经执行成功,则不会再执行,并返回相关信息) |
返回说明
成功时返回:
{"status":0,"message":"核销成功!","couponUsedNoteGuid":"xxx"}
失败时返回:
{"status":-1,"message":"操作失败及原因"}
| 字段 | 是否必须 | 说明 |
|---|---|---|
| status | 是 | 状态(0,成功;-1,失败) |
| message | 是 | 核销优惠券是否成功及提示语 |
| couponUsedNoteGuid | 否 | 核销记录唯一标识(如果核销成功,并且核销的是优惠券,则返回此字段) |
