1、CONFIDENTIAL MATERIAL / RESTRICTED ACCESS 1All Rights Reserved, Copyright zhangqw（ QQ:1243689751）美团回调 API使用式样书第 0.4版2015年 9月 18日作 成 者2015/09/09ZhangqwCONFIDENTIAL MATERIAL / RESTRICTED ACCESS 2All Rights Reserved, Copyright zhangqw（ QQ:1243689751）修正履歴版数 修正年月日 修正箇所 修正概要 修正者0.1 2015/9/9 全般 初版 Zhangqw0
2、.2 2015/9/16 3.确认订单已经下载修改参数名称 Zhangqw0.3 2015/9/17 增加 4.用户或者客服取消订单 APIZhangqw0.4 2015/9/23 增加 5. 美团用户或客服进行退款流程操作 api6. 商家获取申请退款信息 apiZhangqw案例A:美团外卖1，推送订单 API,2，美团用户或客服取消 API,3，美团用户或客服退款流程操作 API.B:门店1,获取门店订单详情 API,2,确认订单已经下载 API,3,获取申请退款信息 API.CONFIDENTIAL MATERIAL / RESTRICTED ACCESS 3All Rights Re
3、served, Copyright zhangqw（ QQ:1243689751）目录一、 接口说明 .31推送订单 API .32. 获取门店订单详情 .53. 确认订单已经下载 .74. 用户或客服取消订单 API .75.美团用户或客服进行退款流程操作 .86. 商家获取申请退款信息 .8一、 接口说明1推送订单 APIREST地址 http:/ POST说明 确认订单后供美团回调(参照： 推送订单 API（必接）.)请求参数名称 说明order_id 订单 IDwm_order_id_view订单展示 IDapp_poi_code APP 方商家 IDwm_poi_name 美团商家名
4、wm_poi_address 美团商家地址wm_poi_phone 美团商家电话recipient_address 收件人地址recipient_phone 收件人电话 recipient_name 收件人姓名shipping_fee 门店配送费total 总价original_price) 原价caution 忌口或备注shipper_phone 送餐员电话status 订单状态city_id 城市 ID（目前暂时用不到此信息）has_invoiced 是否开发票invoice_title 发票抬头CONFIDENTIAL MATERIAL / RESTRICTED ACCESS 4All
5、Rights Reserved, Copyright zhangqw（ QQ:1243689751）ctime 创建时间utime 更新时间delivery_time 用户预计送达时间， “立即送达”时为0is_third_shipping 是否为美团商家、APP 方配送（ 0：否；1：是）pay_type 支付类型（1：货到付款；2：在线支付）latitude 实际送餐地址纬度longitude 实际送餐地址经度detail 此字段为 Json 串，具体格式如下：“detail“: “app_food_code“: 1,“food_name“: “狗不理“,“sku_id“: “1“,“qu
6、antity“: 6,“price“: 100,“box_num“:2,“box_price“:1,“unit“: “份“,“food_discount“: 0.8 (菜品折扣，只是美团商家、APP 方配送的门店才会设置，默认为 1。折扣值不参与总价计算。开放平台 1.0.3 新增),“.“extras 此字段为 Json 串，具体格式如下：“extras“: “act_detail_id“:10,(活动 id) “reduce_fee“: 2.5, (活动优惠金额，是美团承担活动费用和商户承担活动费用的总和)“remark“: “满 10 元减 2.5 元 “,（优惠说明）“type“:1,
7、（活动类型）“avg_send_time”:5.5(餐厅平均送餐时间，单位为分钟),“reduce_fee“: 5, (优惠金额，是美团承担活动费用和商户承担活动费用的总和)“remark“: “新用户立减 5 元 “,（优惠说明）“type“:1,（活动类型）CONFIDENTIAL MATERIAL / RESTRICTED ACCESS 5All Rights Reserved, Copyright zhangqw（ QQ:1243689751）“avg_send_time”:1.0(餐厅平均送餐时间，单位为分钟),返回值 调用成功返回值：“data“ : “ok“，其余情况请参考 “快
8、速开始-返回参数格式说明“post 的 Content-Type 字段为 text，所有参数均为普通 post 参数，不是 json 美团推送的参数未排序，请将参数排序后再计算 sig2. 获取门店订单详情REST地址 http:/ GET说明 获取门店未确认的订单请求参数名称 是否为空 说明app_id 否 appidapp_poi_code 否 门店 idtimestamp 否sig 否返回值名称 说明order_id 订单 IDwm_order_id_view订单展示 IDapp_poi_code APP 方商家 IDwm_poi_name 美团商家名wm_poi_address 美团商
9、家地址wm_poi_phone 美团商家电话recipient_address 收件人地址recipient_phone 收件人电话 recipient_name 收件人姓名shipping_fee 门店配送费total 总价original_price) 原价caution 忌口或备注shipper_phone 送餐员电话status 订单状态city_id 城市 ID（目前暂时用不到此信息）CONFIDENTIAL MATERIAL / RESTRICTED ACCESS 6All Rights Reserved, Copyright zhangqw（ QQ:1243689751）has_
10、invoiced 是否开发票invoice_title 发票抬头ctime 创建时间utime 更新时间delivery_time 用户预计送达时间， “立即送达”时为0is_third_shipping 是否为美团商家、APP 方配送（ 0：否；1：是）pay_type 支付类型（1：货到付款；2：在线支付）latitude 实际送餐地址纬度longitude 实际送餐地址经度detail 此字段为 Json 串，具体格式如下：“detail“: “app_food_code“: 1,“food_name“: “狗不理“,“sku_id“: “1“,“quantity“: 6,“price“
11、: 100,“box_num“:2,“box_price“:1,“unit“: “份“,“food_discount“: 0.8 (菜品折扣，只是美团商家、APP 方配送的门店才会设置，默认为 1。折扣值不参与总价计算。开放平台 1.0.3 新增),“.“extras 此字段为 Json 串，具体格式如下：“extras“: “act_detail_id“:10,(活动 id) “reduce_fee“: 2.5, (活动优惠金额，是美团承担活动费用和商户承担活动费用的总和)“remark“: “满 10 元减 2.5 元 “,（优惠说明）“type“:1,（活动类型）“avg_send_ti
12、me”:5.5(餐厅平均送餐时间，单位为分钟),“reduce_fee“: 5, (优惠金额，是美团承担活动费用和商户承担活动费用的总和)“remark“: “新用户立减 5 元 “,（优惠CONFIDENTIAL MATERIAL / RESTRICTED ACCESS 7All Rights Reserved, Copyright zhangqw（ QQ:1243689751）说明）“type“:1,（活动类型）“avg_send_time”:1.0(餐厅平均送餐时间，单位为分钟),3. 确认订单已经下载REST地址 http:/ POST说明 订单下载成功后，调用此接口修改订单下载状态请
13、求参数名称 说明app_idorder_id_list 订单 ids, order_id数组:id1,id2,id3.,idNtimestampsig返回值 调用成功返回值：“data“ : “ok“，其余情况请参考 “快速开始-返回参数格式说明“4. 用户或客服取消订单 APIREST地址 http:/ GET说明 美团外卖会取消订单回调接口（参照 用户或客服取消订单 API（必接） ） 请求参数名称 说明app_idtimestampsigorder_id 订单 IDreason_code 规范化的订单取消 code，详情请参考（取消订单原因列表）reason 取消原因返回值 调用成功返回
14、值：“data“ : “ok“，其余情况请参考 “快速开始-返回参数格式说明“CONFIDENTIAL MATERIAL / RESTRICTED ACCESS 8All Rights Reserved, Copyright zhangqw（ QQ:1243689751）5.美团用户或客服进行退款流程操作REST地址 http:/ GET说明 美团用户或客服进行退款流程操作（参照美团用户或客服进行退款流程操作） 请求参数名称 说明app_idtimestampsigorder_id 订单 IDnotify_type 通知类型，apply：发起退款agree：确认退款reject：驳回退款can
15、celRefund：用户取消退款申请cancelRefundComplaint :取消退款申诉reason 原因返回值 调用成功返回值：“data“ : “ok“，其余情况请参考 “快速开始-返回参数格式说明“6. 商家获取申请退款信息REST地址 http:/ GET说明 商家获取申请退款信息 请求参数名称 说明app_idtimestampsignotify_type 通知类型，apply：发起退款agree：确认退款reject：驳回退款cancelRefund：用户取消退款申请cancelRefundComplaint :取消退款申诉返回值 调用成功返回值：“data“:“notify
16、_type“:“ apply CONFIDENTIAL MATERIAL / RESTRICTED ACCESS 9All Rights Reserved, Copyright zhangqw（ QQ:1243689751）“,“order_id“:6124982,“reason“:“不想退了“,“notify_type“:“ apply “,“order_id“:6124985,“reason“:“我也不想退了“,“notify_type“:“ apply “,“order_id“:6124987,“reason“:“,order_id 订单 IDnotify_type 通知类型，apply：发起退款agree：确认退款reject：驳回退款cancelRefund：用户取消退款申请cancelRefundComplaint :取消退款申诉reason 原因其余情况请参考 “快速开始-返回参数格式说明“注：计算签名方式同美团计算签名
