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