文档
测试

订单信息

GET
/orderInfo?posId=[posId]&orderNo=[orderNo]

接口描述

由POS系统提供接口,通过扫描"付款收据"上的二维码获取POS订单信息。

请求Query参数

参数名
类型
描述
必填
posId
string
POS系统编号,例如"01"
必填
orderNo
string
POS订单号,例如"2021072121070280533717"
必填

响应参数

参数名
类型
描述
必填
posId
string
POS系统编号
必填
orderNo
string
POS订单号
必填
checksum
string
MD5签名,例如"ace63a3c92fee1f4cc95dbc9602d4ce3"
必填
status
string
订单状态,例如: "0"代表正常,"1"代表不存在,"2"代表已取消,"3"代表其他
必填
orderDateTime
string
订单时间戳
必填
brandCode
string
门店品牌代码,例如"02"代表"港丽"
必填
storeCode
string
门店名称代码,例如"06"代表"上海来福士店"
必填
salesAmt
number
消费金额,保留两位小数
必填
paidAmt
number
支付金额,保留两位小数
必填
noGuest
number
用餐人数
必填

说明 / 示例

## 返回示列 ## 成功示列 ```JSON { "code": 200, "message": "成功", "data": { "posId": "01", "orderNo": "2021072121070280533717", "checksum": "ace63a3c92fee1f4cc95dbc9602d4ce3", "status": "0", "orderDateTime": "2021-07-21 20:07:03", "brandCode": "02", "storeCode": "06", "salesAmt": 345.10, "paidAmt": 325.10, "noGuest": 3 } } ``` ## 失败示列 ```JSON { "code": 500, "message": "失败", "data": {} } ``` # 调用流程/描述 1. 使用"会员系统"小程序"扫描"付款收据"上的二维码获触发。 2. 二维码内容包括POS接口URL,POS系统编号及订单号。接口由POS系统提供,例如"https://api.domain.com/orderInfo"。 3. 调用接口成功后,返回POS订单信息,内容包括按照预先分配POS系统编号及密钥,生成的MD5签名。如状态为错误,返回订单相关信息为空的。 4. 如状态为正常,"会员系统"需要验证订单信息内的MD5签名,如果通过则内容为有效。