文档
测试

优惠券信息

GET
/couponInfo?posId=[posId]&couponNo=[couponNo]&checksum=[MD5 checksum]

接口描述

由"会员系统"提供接口。通过扫描核销二维码获取优惠券信息。

请求Query参数

参数名
类型
描述
必填
posId
string
POS系统编号,例如"01"
必填
couponNo
string
优惠券号,例如"1415578133586477057"
必填
checksum
string
MD5签名,例如"ace63a3c92fee1f4cc95dbc9602d4ce3"
必填

响应参数

参数名
类型
描述
必填
posId
string
POS系统编号
必填
couponNo
string
优惠券号
必填
status
string
优惠券状态,例如: "0"代表正常,"1"代表不存在, "2"代表已核销, "3"代表其他
必填
couponType
int
优惠券类型,例如: 1代表现金劵, 2代表商品单劵, 3代表多品类等
必填
cashValue
number
现金券金额,保留两位小数
必填
returnUrl
string
回调url,核销优惠券后回调通知"会员系统"使用
必填

说明 / 示例

## 返回示列 ## 成功示列 ```JSON { "code": 200, "message": "成功", "data": { "posId": "01", "couponNo": "1415578133586477057", "status": "0", "couponType": 1, "cashValue": 50.00, "returnUrl": "https://api.domain.com/useCoupon" } } ``` ## 失败示列 ```JSON { "code": 500, "message": "失败", "data": {} } ``` # 调用流程/描述 1. 会员选择使用优惠券,"会员系统"生成核销二维码。内容包括优惠券号及接口URL,例如"https://api.domain.com/couponInfo" 2. 使用收银POS扫描核销二维码触发。 3. POS系统需要按照预先分配POS系统编号及密钥,提交MD5签名。 4. 调用接口成功后,"会员系统"需要通过MD5签名验证,然后返回优惠券信息。如状态为错误,返回优惠券相关信息为空的。 5. 如状态为正常,POS系统按照优惠券类型,计算折扣及核算支付金额。会员支付成功后,需要调用回调url,通知"会员系统"核销成功。