生产环境:https://cus.allinpay.com/cusapi/sybserviceapi/wxcateringordersyncstatus
测试环境:https://syb-test.allinpay.com/vsppcusapi/sybserviceapi/wxcateringordersyncstatus
使用场景:
当点餐订单状态发生变化时,都上传全量的订单明细。
1、用户在扫码点餐小程序/h5页面中下单时,上报用户的下单信息,此时status为CREATE_DEAL
2、确定支付成功后上报用户的支付信息,此时status为PAY_SUCCESS
请求参数:
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
---|---|---|---|---|---|
orgid |
代理商号 |
代理商号 |
否 |
15 |
|
cusid |
机构号 |
商户号 |
否 |
15 |
|
appid |
应用ID |
平台分配的 机构APPID |
否 |
8 |
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填11 |
randomstr |
随机字符串 |
商户自行生成的 随机字符串 |
否 |
32 |
|
signtype |
签名类型 |
RSA/SM2 |
否 |
|
|
sign |
签名 |
详见安全规范 |
否 |
32 |
|
sub_appid |
子商户在微信公众平台申请 服务号对应的APPID |
|
否 |
32 |
|
outshopno |
商户旗下门店的唯一编号 |
|
否 |
32 |
|
subopenid |
用户子标识 用户在子商户appid下的openid |
|
否 |
32 |
|
logintoken |
微信用户登录接口返回的登录票据 |
|
否 |
256 |
公众号,填写页面授权access_token 小程序,填写session_key |
orderentry |
点餐入口 |
|
否 |
256 |
点餐入口 |
totalamount |
总价 单位为分, 数字类型 |
|
否 |
|
|
discountamount |
优惠金额 单位为分, 数字类型 |
|
否 |
|
|
useramount |
实际支付金额 单位为分, 数字类型 |
|
否 |
|
|
status |
订单状态,取值如下: CREATE_DEAL—用户下单; PAY_SUCCESS—支付完成,结账成功; |
|
否 |
32 |
|
actiontime |
状态发生变化的时间 格式为yyyymmddhhmmss |
|
否 |
64 |
|
paytime |
支付时间,格式 (status为PAY_SUCCESS时必填) |
|
可 |
64 |
|
chnltrxid |
渠道平台交易单号 (status为PAY_SUCCESS时必填) |
|
可 |
64 |
|
trxid |
收银宝平台的交易流水号 (status为PAY_SUCCESS时必填) |
|
可 |
64 |
|
reqsn |
商户的交易订单号 |
|
否 |
64 |
|
dishlist |
dish_list对象列表 |
|
否 |
|
|
outtableno |
桌位号 |
|
可 |
16 |
|
peoplecount |
消费人数, 数字类型 |
|
可 |
|
|
dish_list
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
---|---|---|---|---|---|
out_dish_no |
商户菜品ID |
|
否 |
48 |
|
name |
菜品名称 |
|
否 |
32 |
|
price |
菜品单价,单位为分 |
|
|
|
|
unit |
菜品单位,BY_SHARE-按份 BY_WEIGHT-按重量 |
|
|
|
|
count |
菜品数量,保留小数点后2位有效数字 |
|
|
|
|
响应参数:
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
---|---|---|---|---|---|
retcode |
返回码 |
SUCCESS/FAIL |
否 |
8 |
SUCCESS-请求成功 FAIL-请求或前端处理失败,具体看retmsg |
retmsg |
返回码说明 |
|
是 |
100 |
|
trxstatus |
状态码 |
1000 | 1001 |
是 |
4 |
1000: 获取结果成功 1999 :获取失败 |
orgid |
代理商号 |
|
否 |
15 |
|
cusid |
商户号 |
|
否 |
15 |
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
status |
操作状态 |
00 /01 |
否 |
2 |
00 操作成功 |
errmsg |
错误信息 |
|
是 |
100 |
|
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |