# 到餐API接入文档
# 1.1 请求说明
美团企业版到餐API接口为基于HTTP协议、RESTful风格的标准API接口,请求的编码方式为UTF-8编码,
请求地址为
https://api-sqt.meituan.com/openapi/payNotify/third(正式环境)
https://sqt-api.test.meituan.com (测试环境)
每个请求都需要指定公共请求参数和业务请求参数。公共请求参数为每个向平台发起的请求都需包含的参数,业务请求参数与特定接口相关。
# 请求体
名称 | 类型 | 说明 |
---|---|---|
token | String | 美团企业版分配给调用方token |
version | String | 接口版本,目前1.0 |
content | String | 请求体内容,JSON序列化后通过AES进行加密 |
# content内公共请求参数
名称 | 类型 | 说明 |
---|---|---|
sign | String | 用于验证请求合法性的秘钥 |
ts | Long | 10位时间戳。若请求发起时间与平台服务端接受请求的时间相差过大,平台将直接拒绝本次请求。 |
# 业务请求参数
和具体接口有关,请参考业务接口描述。
# 1.2 响应说明
名称 | 类型 | 说明 |
---|---|---|
status | Integer | 0: 调用成功 1:失败 |
msg | String | 失败时的错误描述 |
data | JSON | 请求成功时的响应体,和具体业务有关,后文简称业务响应 |
# 1.3 签名方法
接入测试时,需要向美团企业版申请获取token、sign、aesKey,其中token和sign填充到请求和公共请求参数中, 通过aesKey对业务请求Json化结果进行AES加密,作为content。
假设分配得到的参数如下:
名称 | 取值 |
---|---|
token | CESHI-POS |
sign | sgW1bxc7oatFhOJXAeHnNg== |
aesKey | xxxx |
# 1.3.1 查询商家列表页签名示例
1、查询请求
{
"sign": "sgW1bxc7oatFhOJXAeHnNg==",
"ts":1512963578,
"longitude":116488645,
"latitude":40007069
}
2、待加密的明文plainText
{"sign":"sgW1bxc7oatFhOJXAeHnNg==","ts":1512963655,"longitude":116488645,"latitude":40007069}
3、业务请求明文通过AES进行加密,得到content
content=aesEncrypt(plainText, aesKey)
4、构造请求参数
设置Content-Type
为application/x-www-form-urlencoded
, 将token、version、content按照key-value的方式
方到url中。
- cURL发送示例
curl -v "https://sqt-api.test.meituan.com/waimai/v1/poi/list?token=CESHI-POS&version=1.6&content=UgJn07uNgW7S7fJK0R0xVbaLxoCGPQIzoP-_K4Hmp4RduGszhm2mbUs2toZhCtXKP5JGXVTZ9kGts2Wx3IJQCd90ptMoJTDB0vu7mkedEr4KZCvZn77EZLssMC5SpXilmQ-5RXHzvMIT0ASH-IXepTP_O16U37QqCkEb5L1WLy4"
# 1.4 测试说明
第三方渠道接入美团企业版时,需要联系我们获取测试账号和线上账号信息,测试账号只能用于测试环境,在测试环境测试验证没有问题后, 可以在线上进行功能验证,线上有专用测试餐厅,请联系我们获取。禁止在线上环境,随意挑选餐厅测试,否者产生的费用将由第三方承担。
# 2.1 商家列表页筛选项
# 接口说明
名称 | 描述 |
---|---|
功能 | 根据用户地理位置,获取附近的商家信息列表筛选项 |
HTTP方法 | POST |
请求方 | 第三方渠道 |
响应方 | 美团企业版平台 |
uri | /openapi/daocanPoi/options |
# 业务请求参数
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
lng | String | 是 | 116.488645 | 经度 |
lat | String | 是 | 40.007069 | 纬度 |
useCity | boolean | 是 | true | 是否使用经纬度所在城市搜索 |
distance | Integer | 是 | 500 | 搜索半径(米) |
entId | Integer | 是 | 16586 | 美团企业版分配的企业id |
# 业务响应(data)
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
metroStationInfo | json | 是 | 地铁信息(不受半径影响) |
categoryInfo | josn | 是 | 美食类型信息 |
hotregionInfo | json | 是 | 热门商圈(不受半径影响) |
regionInfo | json | 是 | 商圈信息(不受半径影响) |
json结构
{
"attributeMap": {
"regiontype": "",
"count": "4",
"name": "16号线",
"type": "5",
"key": "82085"
},
"children": [
{
"attributeMap": {
"regiontype": "",
"count": "4",
"name": "西苑地铁站",
"type": "4",
"key": "3039"
},
"children": []
}
]
}
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
attributeMap | json | 否 | 当前节点 |
children | json | 否 | 子节点 |
节点信息:
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
name | string | 否 | 名字 |
key | string | 否 | 节点key |
# 响应示例
{
"metroStationInfo": [
{
"attributeMap": {
"regiontype": "",
"count": "4",
"name": "16号线",
"type": "5",
"key": "82085"
},
"children": [
{
"attributeMap": {
"regiontype": "",
"count": "4",
"name": "西苑地铁站",
"type": "4",
"key": "3039"
},
"children": []
}
]
}
],
"categoryInfo":[{"attributeMap":{"regiontype":"","count":"1655","name":"全部美食","type":"2","key":"10"},"children":[]}],
"regionInfo":[{"attributeMap":{"regiontype":"","count":"6120","name":"西城区","type":"1","key":"16"},"children":[{"attributeMap":{"regiontype":"","count":"612","name":"西单","type":"2","key":"1481"},"children":[]},{"attributeMap":{"regiontype":"","count":"530","name":"西直门/动物园","type":"2","key":"1484"},"children":[]}],
"hotregionInfo":[{"attributeMap":{"regiontype":"","count":"1024","name":"国贸","type":"2","key":"2578"},"children":[]},{"attributeMap":{"regiontype":"","count":"773","name":"三里屯","type":"2","key":"2580"},"children":[]},{"attributeMap":{"regiontype":"","count":"155","name":"南锣鼓巷/鼓楼东大街","type":"2","key":"23023"},"children":[]},{"attributeMap":{"regiontype":"","count":"897","name":"王府井/东单","type":"2","key":"1475"},"children":[]},{"attributeMap":{"regiontype":"","count":"984","name":"中关村","type":"2","key":"1488"},"children":[]},{"attributeMap":{"regiontype":"","count":"1117","name":"五道口","type":"2","key":"1489"},"children":[]},{"attributeMap":{"regiontype":"","count":"976","name":"亚运村","type":"2","key":"1470"},"children":[]},{"attributeMap":{"regiontype":"","count":"296","name":"远大路","type":"2","key":"2872"},"children":[]},{"attributeMap":{"regiontype":"","count":"721","name":"五棵松","type":"2","key":"2588"},"children":[]},{"attributeMap":{"regiontype":"","count":"70","name":"工人体育场","type":"2","key":"23002"},"children":[]},{"attributeMap":{"regiontype":"","count":"1456","name":"望京","type":"2","key":"1471"},"children":[]},{"attributeMap":{"regiontype":"","count":"1098","name":"大望路","type":"2","key":"2078"},"children":[]},{"attributeMap":{"regiontype":"","count":"501","name":"航天桥","type":"2","key":"1495"},"children":[]},{"attributeMap":{"regiontype":"","count":"859","name":"朝外大街","type":"2","key":"1466"},"children":[]},{"attributeMap":{"regiontype":"","count":"775","name":"亮马桥/三元桥","type":"2","key":"1469"},"children":[]},{"attributeMap":{"regiontype":"","count":"62","name":"蓝色港湾","type":"2","key":"23010"},"children":[]},{"attributeMap":{"regiontype":"","count":"612","name":"西单","type":"2","key":"1481"},"children":[]},{"attributeMap":{"regiontype":"","count":"145","name":"北新桥/簋街","type":"2","key":"23024"},"children":[]},{"attributeMap":{"regiontype":"","count":"747","name":"公主坟/万寿路","type":"2","key":"1493"},"children":[]},{"attributeMap":{"regiontype":"","count":"770","name":"劲松/潘家园","type":"2","key":"1472"},"children":[]}]
}
}
# 2.2 商家菜品列表 (/openapi/daocanPoi/list)
# 接口说明
名称 | 描述 |
---|---|
功能 | 获取商家列表 |
HTTP方法 | POST |
请求方 | 第三方渠道 |
响应方 | 美团企业版平台 |
uri | /openapi/daocanPoi/list |
# 业务请求参数
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
lng | String | 是 | 116.488645 | 经度 |
lat | String | 是 | 40.007069 | 纬度 |
useCity | boolean | 是 | true | 是否使用经纬度所在城市搜索 |
distance | Integer | 是 | 500 | 搜索半径(米) |
entId | Integer | 是 | 16586 | 美团企业版分配的企业id |
keyword | String | 否 | 火锅 | 搜索关键字 |
pageNum | Integer | 是 | 1 | 分页当前页数 |
pageSize | Integer | 是 | 10 | 当前页面大小 |
categoryKey | Integer | 否 | 124 | 分类key(通过导航信息获取) |
regionKey | Integer | 否 | 54 | 商圈key(通过导航信息获取) |
moreKeys | List | 否 | ispartnerparking | 更多筛选: {"name":"营业中","key":"biztime"} {"name":"可停车","key":"ispartnerparking"} |
priceKeys | List | 否 | 500,100 | 价格区间index0<index1 |
discountKeys | List | 否 | haspaysetting | 优惠条件: {"name":"买单-在线支付","key":"haspaysetting"} {"name":"团购-优惠套餐","key":"hasgroup"} |
serviceKeys | List | 否 | hasbooksetting | 搜索付类型:{"name": "预定","key": "hasbooksetting"} |
intelligentSortingKey | String | 否 | dpscore | 排序方式:{"name":"智能排序","key":"dpscore"} {"name":"离我最近","key":"poi"} {"name":"人气","key":"monthlyhits"} {"name":"评价","key":"shoppower"} {"name":"口味","key":"score1"} {"name":"环境","key":"score2"} {"name":"服务","key":"score3"} |
needNavigate | boolean | 是 | false | 是否需要导航信息 |
# 业务响应
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
pageNum | Integer | 是 | 当前页数 |
pageSize | Integer | 是 | 页面大小 |
pageCount | Integer | 是 | 总页数 |
poiList | List<SqtDianpingPoiDTO > | 否 | 商家列表页 |
metroStationInfo | JsonDTO | 是 | 地铁信息(不受半径影响) |
categoryInfo | JsonDTO | 是 | 美食类型信息 |
hotregionInfo | JsonDTO | 是 | 热门商圈(不受半径影响) |
regionInfo | JsonDTO | 是 | 商圈信息(不受半径影响) |
SqtDianpingPoiDTO结构
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
defaultpic | String | 是 | 缩略图 |
fullshopname | String | 是 | 名称 |
shopId | String | 是 | 名称 |
shoppower | String | 是 | 点评评价星级(35为三星半) |
avgprice | String | 是 | 客单价 |
distance | String | 是 | 距离 |
mainregionname | String | 是 | 商圈 |
originmaincategoryname | String | 是 | 分类名 |
hasgroup | int | 是 | 是否团购标示 |
dealgroupprice | String | 是 | 团购价 |
dealgrouptitle | String | 是 | 团购标题 |
haspaysetting | int | 是 | 是否支付买单 |
paysettingdiscount | String | 是 | 买单优惠描述 |
businesshours | String | 是 | 营业时间 |
hasbooksetting | int | 是 | 是否预订 |
hascodepay | int | 是 | 是否扫码付 |
hasentsetting | int | 是 | 企业支付 |
JsonDTO结构
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
attributeMap | jsonInfo | 否 | 当前节点 |
children | jsonInfo | 否 | 子节点 |
jsonInfo节点信息:
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
name | string | 否 | 名字 |
key | string | 否 | 节点key |
# 响应示例
{
"status":0,
"msg":"成功",
"data":{
"pageNum":1,
"pageSize":10,
"pageCount":1166,
"poiList":[
{
"defaultpic":"https://qcloud.dpfile.com/pc/D6tezhCrKCl9YsGk128rvNReqwBNtNchGMSJvHrePQGNT_vXeaobucCupNkVwQAjtOnd3gXQdDYlAqlaVaAFeZ0rYYyiRo_EhzufqWWjTjs.jpg",
"fullshopname":"吃啃坊韩国料理",
"shopId":"20665361",
"shoppower":"35",
"avgprice":"0",
"distance":"-1",
"mainregionname":"四惠",
"originmaincategoryname":"韩国料理",
"hasgroup":"0",
"dealgroupprice":"",
"dealgrouptitle":null,
"haspaysetting":"1",
"paysettingdiscount":null,
"businesshours":"早10:00-晚12:00",
"hasbooksetting":"0",
"hascodepay":"0",
"hasentsetting":"0"
},
Object{...}
],
"metroStationInfo":[
{
"attributeMap":{
"regiontype":"",
"count":"4",
"name":"16号线",
"type":"5",
"key":"82085"
},
"children":[
{
"attributeMap":{
"regiontype":"",
"count":"4",
"name":"西苑地铁站",
"type":"4",
"key":"3039"
},
"children":[
]
}
]
},
Object{...},
Object{...},
Object{...}
],
"categoryInfo":[
{
"attributeMap":{
"regiontype":"",
"count":"11655",
"name":"全部美食",
"type":"2",
"key":"10"
},
"children":[
]
},
{
"attributeMap":{
"regiontype":"",
"count":"900",
"name":"烧烤",
"type":"1",
"key":"508"
},
"children":[
]
},
Object{...},
Object{...},
Object{...}
],
"regionInfo":[
{
"attributeMap":{
"regiontype":"",
"count":"694",
"name":"西城区",
"type":"1",
"key":"16"
},
"children":[
{
"attributeMap":{
"regiontype":"",
"count":"76",
"name":"西单",
"type":"2",
"key":"1481"
},
"children":[
]
},
Object{...},
Object{...}
]
},
Object{...},
Object{...}
],
"hotregionInfo":[
{
"attributeMap":{
"regiontype":"",
"count":"126",
"name":"国贸",
"type":"2",
"key":"2578"
},
"children":[
]
},
Object{...},
Object{...},
Object{...}
]
}
}
# 2.3 店铺详情接口
# 接口说明
名称 | 描述 |
---|---|
功能 | 通过店铺id获取店铺详情 |
HTTP方法 | POST |
请求方 | 第三方渠道 |
响应方 | 美团企业版平台 |
uri | /openapi/daocanPoi/detail |
# 业务请求参数
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
shopId | Integer | 是 | 2341234 | 列表页返回的 shopId |
entId | Integer | 是 | 16586 | 美团企业版分配的企业id |
# 业务响应
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
mainCategoryName | String | 否 | 分类名字 |
shopId | integer | 否 | 店铺id |
shopName | String | 否 | 店铺名称 |
branchName | String | 否 | 分店名称 |
address | String | 否 | 店铺地址 |
crossRoad | String | 否 | 交叉路 |
phoneNo | String | 否 | 店铺电话 |
phoneNo2 | String | 否 | 店铺电话2 |
power | String | 否 | 营业状态(0:手机收录商户,1:已关,2:暂时歇业,4:尚未营业,5:正常,15:侵权商户) |
altName | String | 否 | 别名 |
businessHours | String | 否 | 营业时间 |
publicTransit | String | 否 | 交通状况 |
glat | Double | 否 | 纬度 |
glng | Double | 否 | 经度 |
coordType | String | 否 | 坐标系类型 |
shopPower | Integer | 否 | 星级(35 三星半) |
avgPrice | Integer | 否 | 平均价格 |
score | Integer | 否 | 综合评分百分制 |
score1 | Integer | 否 | 口味评分 |
score2 | Integer | 否 | 环境评分 |
score3 | Integer | 否 | 服务评分 |
defaultPic | String | 否 | 图片 |
hits | Integer | 否 | 访问量 |
weeklyHits | Integer | 否 | 访问量 |
prevWeeklyHits | Integer | 否 | 访问量 |
todayHits | Integer | 否 | 访问量 |
monthlyHits | Integer | 否 | 访问量 |
isSupportQueue | boolean | 否 | 排队 |
isSupportWaimai | boolean | 否 | 是否支持外卖 |
hasGroup | boolean | 否 | 是否有团购 |
isSupportOrder | boolean | 否 | 是否支持点菜 |
isSupportReserve | boolean | 否 | 是否支持预定 |
isSupportMember | boolean | 否 | 是否支持会员 |
hasHongbao | boolean | 否 | 是否支有红包 |
isSupportMerchant | boolean | 否 | 特指商户通促销 |
isSupportSht | boolean | 否 | 是否开通商户通 |
isSupportMaidan | boolean | 否 | 是否支持买单 |
isSupportErp | boolean | 否 | 是否有Erp信息 |
isSupportIntelligentPayment | boolean | 否 | 是否支持智能支付 |
# 响应示例
{
"status":0,
"msg":"成功",
"data":{
"mainRegionName":"四惠",
"mainCategoryName":"韩国料理",
"shopId":20665361,
"shopName":"吃啃坊韩国料理",
"branchName":"",
"address":"四惠桥北侧",
"crossRoad":"",
"phoneNo":"53696239",
"phoneNo2":"",
"power":5,
"altName":"来自星星的炸鸡",
"businessHours":"早10:00-晚12:00",
"publicTransit":"",
"glat":null,
"glng":null,
"coordType":"GCJ02",
"shopPower":35,
"avgPrice":0,
"score":71,
"score1":71,
"score2":74,
"score3":74,
"defaultPic":"https://qcloud.dpfile.com/pc/D6tezhCrKCl9YsGk128rvNReqwBNtNchGMSJvHrePQGNT_vXeaobucCupNkVwQAjbX9yED0ueaDWYCwyxfLcgw.jpg",
"hits":1052,
"weeklyHits":0,
"prevWeeklyHits":0,
"todayHits":0,
"monthlyHits":0,
"isSupportQueue":false,
"isSupportWaimai":false,
"hasGroup":true,
"isSupportOrder":false,
"isSupportReserve":false,
"isSupportMember":false,
"hasHongbao":false,
"isSupportMerchant":false,
"isSupportSht":false,
"isSupportMaidan":false,
"isSupportErp":false,
"isSupportIntelligentPayment":false,
"supportQueue":false,
"supportWaimai":false,
"supportOrder":false,
"supportReserve":false,
"supportMember":false,
"supportMerchant":false,
"supportSht":false,
"supportMaidan":false,
"supportErp":false,
"supportIntelligentPayment":false
}
}
# 2.4 获取店铺评论信息
# 接口说明
名称 | 描述 |
---|---|
功能 | 获取某个店铺的评论信息 |
HTTP方法 | POST |
请求方 | 第三方渠道 |
响应方 | 美团企业版平台 |
uri | /openapi/daocanPoi/reviewList |
# 业务请求参数
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
shopId | Integer | 是 | 2341234 | 列表页返回的 shopId |
deviceId | Integer | 是 | ASDF34 | 当前设备唯一编码 |
entId | Integer | 是 | 16586 | 美团企业版分配的企业id |
# 业务响应
list
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
nick | String | 是 | 评论人昵称 |
score | float | 是 | 评论分值 |
time | String | 是 | 评论时间 |
content | String | 是 | 评论内容 |
photo_urls | List<String> | 是 | 评论图片 |
scores | List<SqtDaocanPoiScoreDTO > | 是 | 评论内容 |
SqtDaocanPoiScoreDTO结构体
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
title | String | 是 | 标题 |
value | Integer | 是 | 评论分值 |
desc | String | 是 | 描述 |
# 2.5 买单优惠查询
# 接口说明
名称 | 描述 |
---|---|
功能 | 根据店铺id查询买单优惠内容 |
HTTP方法 | POST |
请求方 | 第三方渠道 |
响应方 | 美团企业版平台 |
uri | /openapi/daocanDiscount/pay |
# 业务请求参数
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
shopId | Integer | 是 | 2341234 | 列表页返回的 shopId |
entId | Integer | 是 | 16586 | 美团企业版分配的企业id |
# 业务响应
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
couponProductList | List<SqtPayCouponProductDTO > | 是 | 状态码 200:支付成功 其它:支付失败 |
hasValidCoupon | String | 是 | 是否有优惠 |
hasOriginPrice | String | 否 | 是否支持原价买单 |
hasEnterpriseOriginPrice | String | 否 | 是否支持企业原价买单 |
SqtPayCouponProductDTO
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
title | String | 是 | 优惠标题 |
productType | Integer | 是 | ORIGINAL_PRICE(-1, "原价买单"), HUI_DISCOUNT(201, "闪惠折扣"), HUI_FULLCUT(202, "闪惠满减"),; |
offerId | Integer | 否 | 优惠id |
sqtPayCouponRegulationDTO | SqtPayCouponRegulationDTO | 否 | 优惠规则 |
enabled | boolean | 否 | 是否可用 |
enableReason | String | 否 | 不可用原因 |
SqtPayCouponRegulationDTO
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
ratio | String | 否 | 折扣 |
sqtPayCouponRegulationStepDTO | SqtPayCouponRegulationStepDTO | 否 | 满减优惠 |
SqtPayCouponRegulationStepDTO
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
step | String | 否 | 步进金额 已买100元团购抵用券,值为100;可用80-100元团购抵用券,值为100 |
deduce | String | 否 | 减免金额 已买100元团购抵用券,值为100;可用80-100元团购抵用券,值为20 |
limitTime | Integer | 否 | 可用上限 表示可用张数 |
# 业务响应示例
{
"status":0,
"msg":"成功",
"data":{
"couponProductList":[
{
"title":"9折",
"productType":201,
"offerId":10310867,
"sqtPayCouponRegulationDTO":{
"ratio":"0.9",
"sqtPayCouponRegulationStepDTO":null
},
"enabled":true,
"enableReason":null,
"bizType":null
}
],
"hasValidCoupon":true,
"hasOriginPrice":false,
"hasEnterpriseOriginPrice":false
}
}
# 2.6 买单创建订单
###接口说明
名称 | 描述 |
---|---|
功能 | 创建订单接口 |
HTTP方法 | POST |
请求方 | 第三方渠道 |
响应方 | 美团企业版平台 |
uri | /openapi/daocanOrder/createPayOrder |
# 业务请求参数
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
shopId | Integer | 是 | 2341234 | 列表页返回的 shopId |
entId | Integer | 是 | 16586 | 美团企业版分配的企业id |
entOrderId | String | 否 | 1aSDF6586 | 企业方传入id(业务方唯一不可重复度) |
entStaffNum | String | 否 | 16586 | 企业指定员工时 |
offerId | String | 是 | 16586 | 点评优惠Id |
productType | Integer | 是 | 16586 | 优惠类型 满减 还是折扣 ORIGINAL_PRICE(-1,"原价买单"), HUI_DISCOUNT(201, "闪惠折扣"), HUI_FULLCUT(202, "闪惠满减"),; |
orderTypeEnum | Integer | 是 | 16586 | SHANHUI(10, "闪惠"), ENTERPRISE_HUI(400, "企业买单"),; |
userAmount | Integer | 是 | 100 | 用户支付金额 单位分 |
noDiscountAmount | Integer | 否 | 100 | 不参与优惠的金额 // 可空 |
originAmount | Integer | 是 | 123 | 原价 |
ip | Integer | 是 | 16586 | 下单IP |
lat | String | 是 | 16586 | 纬度 |
lng | String | 是 | 16586 | 经度 |
# 业务响应
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
entId | Long | 是 | 企业id |
entOrderId | string | 否 | 企业下单id |
bizOrderId | Integer | 是 | 订单id |
bizType | Integer | 是 | DP_CANYIN(1, "点评餐饮买单业务"), MT_GROUP(2, "美团团购业务"),; |
orderStatus | Integer | 是 | CREATE_ORDER(1, "创建订单"), PAY_ORDER(2, "支付订单"), REFUND_ORDER(3, "退款订单"),; |
amount | Integer | 是 | 实际支付金额 单位分 |
# 业务响应示例
{
"status":0,
"msg":"成功",
"data":{
"entOrderId":"eGZ2fava1F9CLtEqNWlbLw",
"entId":257,
"bizOrderId":"180719928619363",
"bizType":1,
"orderStatus":1,
"amount":100
}
}
# 2.7 买单支付
# 接口说明
名称 | 描述 |
---|---|
功能 | 根据订单ID进行支付 |
HTTP方法 | POST |
请求方 | 第三方渠道 |
响应方 | 美团企业版平台 |
uri | /openapi/daocanPay/realPay |
# 业务请求参数
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
entId | Long | 是 | 645 | 企业ID |
bizOrderId | Long | 是 | 6045282297615018 | 订单号 |
typeEnum | Integer | 是 | 6045282297615018 | 支付形单类型 DP_CANYIN(1, "点评餐饮买单业务"), MT_GROUP(2, "美团团购业务"),; |
entOrderId | String | 否 | 6045282297615018 | 企业订单号() |
# 业务响应
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
data | int | 是 | SUCCESS(0, "支付成功"), MT_PAY_CENTER_FAIL(10, "美团收银台支付失败"), SQT_TRADE_CENTER_FAIL(11, "美团企业版交易平台支付失败"), GET_PAY_ORDER_FAIL(13, "获取支付订单失败"); |
# 响应参数
{"status":0,"msg":"成功","data":"10"}
# 2.8 买单退款
###接口说明
名称 | 描述 |
---|---|
功能 | 根据商家poiId获取商家详情 |
HTTP方法 | POST |
请求方 | 第三方渠道 |
响应方 | 美团企业版平台 |
uri | /openapi/daocanRefund/payRefund |
# 业务请求参数
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
entId | Long | 是 | 645 | 企业ID |
bizOrderId | Long | 是 | 6045282297615018 | 订单号 |
entOrderId | String | 否 | 6045282297615018 | 企业订单号() |
reason | String | 否 | 吧吧 | 原因 |
ip | String | 否 | 192.1.1.1 | 发起IP |
phone | String | 否 | 1888888888 | 退款联系人 |
# 业务响应
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
data | bool | 是 | 是否退款成功 |
# 业务响应示例
{"status":0,"msg":"成功","data":true}
# 2.9 订单查询
###接口说明
名称 | 描述 |
---|---|
HTTP方法 | POST |
请求方 | 第三方渠道 |
响应方 | 美团企业版平台 |
uri | /openapi/daocanQuery/payOrder |
# 业务请求参数
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
entId | Long | 是 | 645 | 企业ID |
bizOrderId | Long | 是 | 6045282297615018 | 订单号 |
typeEnum | Integer | 是 | 6045282297615018 | 支付形单类型 DP_CANYIN(1, "点评餐饮买单业务"), MT_GROUP(2, "美团团购业务"),; |
entOrderId | String | 否 | 6045282297615018 | 企业订单号() |
# 业务响应
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
status | int | 是 | 订单状态 |
supplyChain | int | 是 | 供应链类型, 0 到综,1 美团,2 智能支付 |
originAmount | String | 是 | 原价 单位元最多两位小数 |
userAmount | String | 是 | 实付金额 单位元最多两位小数 |
deductAmount | String | 是 | 预定金额 单位元最多两位小数 |
noDiscountAmount | String | 是 | 无优惠金额 单位元最多两位小数 |
serialNumber | String | 是 | 买单800码 |
payTime | String | 是 | 支付时间 |
mobileNo | String | 是 | 用户手机号码 |
shopName | String | 是 | 门店名称 |
enterpriseOrder | String | 是 | 是否为企业订单;0否,1是 |
orderId | String | 是 | 长订单号 |
serializedId | String | 是 | 加密长订单号 |
cityName | String | 是 | 城市名称 |
返回示例
{
"status":0,
"msg":"成功",
"data":{
"status":3,
"supplyChain":1,
"originAmount":"1.00",
"userAmount":"1.00",
"deductAmount":null,
"noDiscountAmount":null,
"serialNumber":"8004 1106 815",
"payTime":"2018-07-20 14:55",
"mobileNo":"",
"shopName":"自助门店(接口专用3)",
"enterpriseOrder":0,
"orderId":180720928619375,
"cityName":"天津",
"serializedId":null
}
}