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