# 到餐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
}
}