核销优惠券

websocket测试

GET

/useCoupon?posId=[posId]&couponNo=[couponNo]&orderNo=[orderNo]&url=[orderInfo URL]&checksum=[MD5 checksum]

接口描述

由"会员系统"提供接口。通过POS系统调用回调url，通知"会员系统"核销成功。

请求Query参数

参数名

类型

描述

必填

posId

string

POS系统编号，例如"01"

必填

couponNo

string

优惠券号，例如"1415578133586477057"

必填

orderNo

string

POS订单号，例如"2021072121070280533717"

必填

url

string

回调url，获取POS订单信息，例如"https://api.domain.com/orderInfo"

必填

checksum

string

MD5签名，例如"ace63a3c92fee1f4cc95dbc9602d4ce3"

必填

响应参数

参数名

类型

描述

必填

posId

string

POS系统编号

必填

couponNo

string

优惠券号

必填

orderNo

string

优惠券用于POS订单号

必填

status

string

核销状态，例如: "0"代表成功，"1"代表失败(原因: 优惠券不存在或已核销等)

必填

说明 / 示例

## 返回示列 ## 成功示列 ```JSON { "code": 200, "message": "成功", "data": { "posId": "01", "couponNo": "1415578133586477057", "orderNo": "2021072121070280533717", "status": "0" } } ``` ## 失败示列 ```JSON { "code": 500, "message": "失败", "data": {} } ``` # 调用流程/描述 1. 收银POS核销优惠券后回调触发。 2. POS系统需要按照预先分配POS系统编号及密钥，提交MD5签名。 3. 调用接口成功后，"会员系统"需要通过MD5签名验证，并校验优惠券，然后返回优惠券核销状态。 4. 如状态为正常，"会员系统"需要调用回调url，获取POS订单信息。

上一篇优惠券信息

nextDoc 取消订单