美团外卖回调接口说明文档.docx

CONFIDENTIAL MATERIAL / RESTRICTED ACCESS 美团回调API使用式样书第0.4版2015年9月18日作 成 者2015/09/09Zhangqw修正履歴版数修正年月日修正箇所修正概要修正者0.12015/9/9全般初版Zhangqw0.22015/9/163.确认订单已经下载修改参数名称Zhangqw0.32015/9/17增加4.用户或者客服取消订单APIZhangqw0.42015/9/23增加5. 美团用户或客服进行退款流程操作api6. 商家获取申请退款信息apiZhangqw案例A:美团外卖1，推送订单API,2，美团用户或客服取消API,3，美团用户或客服退款流程操作API.B:门店1,获取门店订单详情API,2,确认订单已经下载API,3,获取申请退款信息API.目录一、接口说明31推送订单API32. 获取门店订单详情53. 确认订单已经下载74. 用户或客服取消订单API75.美团用户或客服进行退款流程操作86. 商家获取申请退款信息8一、 接口说明1推送订单APIREST地址/Api/orderPushCallback请求方法POST说明确认订单后供美团回调(参照：推送订单API（必接）.)请求参数名称说明order_id订单IDwm_order_id_view订单展示IDapp_poi_codeAPP方商家IDwm_poi_name美团商家名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发票抬头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: 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_time”:5.5(餐厅平均送餐时间，单位为分钟),reduce_fee: 5, (优惠金额，是美团承担活动费用和商户承担活动费用的总和)remark: 新用户立减5元,（优惠说明）“type:1,（活动类型）“avg_send_time”:1.0(餐厅平均送餐时间，单位为分钟),返回值调用成功返回值：data : ok，其余情况请参考 快速开始-返回参数格式说明post的Content-Type字段为text，所有参数均为普通post参数，不是json 美团推送的参数未排序，请将参数排序后再计算sig2. 获取门店订单详情REST地址/Api/doGetOrder请求方法GET说明获取门店未确认的订单请求参数名称是否为空说明app_id否appidapp_poi_code否门店idtimestamp否sig否返回值名称说明order_id订单IDwm_order_id_view订单展示IDapp_poi_codeAPP方商家IDwm_poi_name美团商家名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发票抬头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: 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_time”:5.5(餐厅平均送餐时间，单位为分钟),reduce_fee: 5, (优惠金额，是美团承担活动费用和商户承担活动费用的总和)remark: 新用户立减5元,（优惠说明）“type:1,（活动类型）“avg_send_time”:1.0(餐厅平均送餐时间，单位为分钟),3. 确认订单已经下载REST地址/Api/orderConfirm请求方法POST说明订单下载成功后，调用此接口修改订单下载状态请求参数名称说明app_idorder_id_list订单ids, order_id数组:id1,id2,id3.,idNtimestampsig返回值调用成功返回值：data : ok，其余情况请参考 快速开始-返回参数格式说明4. 用户或客服取消订单APIREST地址/Api/cancelOrder请求方法GET说明美团外卖会取消订单回调接口（参照用户或客服取消订单API（必接） 请求参数名称说明app_idtimestampsigorder_id订单IDreason_code规范化的订单取消code，详情请参考（取消订单原因列表）reason取消原因返回值调用成功返回值：data : ok，其余情况请参考 快速开始-返回参数格式说明5.美团用户或客服进行退款流程操作REST地址/Api/refund请求方法GET说明美团用户或客服进行退款流程操作（参照美团用户或客服进行退款流程操作） 请求参数名称说明app_idtimestampsigorder_id订单IDnotify_type通知类型，apply：发起退款agree：确认退款reject：驳回退款cancelRefund：用户取消退款申请cancelRefundComplaint :取消退款申诉reason原因返回值调用成功返回值：data : ok，其余情况请参考 快速开始-返回参数格式说明6. 商家获取申请退款信息REST地址/Api/getRefund请求方法GET说明商家获取申请退款信息 请求参数名称说明app_idtimestampsignotify_type通知类型，apply：发起退款agree：确认退款reject：驳回退款cancelRefund：用户取消退款申请cancelRefundComplaint :取消退款申诉返回值调用成功返回值：data:notify_type: apply ,order_id:6124982,reason:不想退了,notify_type: apply ,order_id:6124985,reason:我也不想退了,notify_type: apply ,order_id:6124987,reason:,order_id