2.1.6抖音点餐同步


接口地址

生产环境: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

详见安全规范


2026年9月14日 14:03 收藏文档