美團(tuán)外賣回調(diào)接口說明文檔

1、美團(tuán)回調(diào)API使用式樣書第0.4版2015年9月18日作成者2015/09/09Zhangqw版數(shù)修正年月日修正循所修正概要修正者0.12015/9/9全股初版Zhangqw0.22015/9/163.確認(rèn)訂單已經(jīng)下載修改參數(shù)名稱Zhangqw0.32015/9/17增加4.用戶或者客服取消訂單APIZhangqw0.42015/9/23增加5.美團(tuán)用戶或客服進(jìn)行退款流程操作api6.商家獲取申請(qǐng)退款信息apiZhangqw案例富"工具|C地仃JBCkLJn/ni$4&：山、上/用固尸acH單清皿Iw1pW吊尸西印4厘如次節(jié)iraidXpi/r«£unJo

2、口顯配地r1空A:美團(tuán)外賣1,推送訂單API,2,美團(tuán)用戶或客服取消API,3,美團(tuán)用戶或客服退款流程操作API.B:門店1,獲取門店訂單詳情API,2,確認(rèn)訂單已經(jīng)下載API,3,獲取申請(qǐng)退款信息API.目錄一、接口說明31 .推送訂單API32 .獲取門店訂單詳情53 .確認(rèn)訂單已經(jīng)下載74 .用戶或客服取消訂單API75 .美團(tuán)用戶或客服進(jìn)行退款流程操作86 .商家獲取申請(qǐng)退款信息8接口說明1 .推送訂單APIREST地址請(qǐng)求方法POST說明確認(rèn)訂單后供美團(tuán)回調(diào)（參照：推送訂單API（必接）.）請(qǐng)求參數(shù)名稱說明order_id訂單IDwm_order_id_view訂單展示IDapp_p

3、oi_codeAPP方商家IDwm_poi_name美團(tuán)商家名wm_poi_address美團(tuán)商家地址wm_poi_phone美團(tuán)商家電話recipient_address收件人地址recipient_phone收件人電話recipient_name收件人姓名shipping_fee門店配送費(fèi)total總價(jià)original_price)原價(jià)caution忌口或備注shipper_phone送餐員電話status訂單狀態(tài)city_id城巾ID（目前暫時(shí)用不到此信息）has_invoiced是否開發(fā)票invoice_title發(fā)票抬頭ctime創(chuàng)建時(shí)間utime更新時(shí)間delivery_time用

4、戶預(yù)計(jì)送達(dá)時(shí)間，立即送達(dá)”時(shí)為0is_third_shipping是否為美團(tuán)商家、APP方配送（0:否；1:是）pay_type支付類型（1：貨到付款；2:在線支付）latitude實(shí)際送餐地址緯度longitude實(shí)際送餐地址經(jīng)度detail此字段為Json串，具體格式如下："detail":"app_food_code”:1,"food_name":"狗不理","sku_id":"1","quantity":6,"price":100,&qu

5、ot;box_num":2,"box_price":1,"unit":"份","food_discount":0.8(菜品折扣，只是美團(tuán)商家、APP方配送的門店才會(huì)設(shè)置，默認(rèn)為1。折扣值不參與總價(jià)計(jì)算。開放平臺(tái)1.0.3新增),"."extras此字段為Json串，具體格式如下："extras":"act_detail_id":10,（活動(dòng)id）"reduce_fee":2.5,（活動(dòng)優(yōu)惠金額，是美團(tuán)承擔(dān)活動(dòng)費(fèi)用和商戶承擔(dān)活動(dòng)

6、費(fèi)用的總和）"remark":"滿10元減2.5元",（優(yōu)惠說明）type":1,（活動(dòng)典型）"avg_send_time”銀5年均送餐時(shí)間，單位為分鐘）,"reduce_fee":5,（優(yōu)惠金額，是美團(tuán)承擔(dān)活動(dòng)費(fèi)用和商戶承擔(dān)活動(dòng)費(fèi)用的總和）"remark":"新用戶立減5兀"，（優(yōu)惠說明）type":1,（活動(dòng)典型）"avg_send_time”餐團(tuán)年均送餐時(shí)間，單位為分鐘）,返回值調(diào)用成功返回值："data":"ok&qu

7、ot;,其余情況請(qǐng)參考"快速開始-返回參數(shù)格式說明"post的Content-Type字段為text,所有參數(shù)均為普通post參數(shù)，不是json美團(tuán)推送的參數(shù)未排序，請(qǐng)將參數(shù)排序后再計(jì)算sig2 .獲取門店訂單詳情REST地址請(qǐng)求方法GET說明獲取門店未確認(rèn)的訂單請(qǐng)求參數(shù)名稱是否為空說明app_id否appidapp_poi_code否門店idtimestamp否sig否返回值名稱說明order_id訂單IDwm_order_id_view訂單展示IDapp_poi_codeAPP方商家IDwm_poi_name美團(tuán)商家名wm_poi_address美團(tuán)商家地址wm_poi

8、_phone美團(tuán)商家電話recipient_address收件人地址recipient_phone收件人電話recipient_name收件人姓名shipping_fee門店配送費(fèi)total總價(jià)original_price)原價(jià)caution忌口或備注shipper_phone送餐員電話status訂單狀態(tài)city_id城巾ID（目前暫時(shí)用不到此信息）has_invoiced是否開發(fā)票invoice_title發(fā)票抬頭ctime創(chuàng)建時(shí)間utime更新時(shí)間delivery_time用戶預(yù)計(jì)送達(dá)時(shí)間，立即送達(dá)”時(shí)為0is_third_shipping是否為美團(tuán)商家、APP方配送（0:否；1:是）p

9、ay_type支付類型（1：貨到付款；2:在線支付）latitude實(shí)際送餐地址緯度longitude實(shí)際送餐地址經(jīng)度detail此字段為Json串，具體格式如下："detail":"app_food_code”:1,"food_name":"狗不理","sku_id":"1","quantity":6,"price":100,"box_num":2,"box_price":1,"unit&quo

10、t;:"份","food_discount":0.8(菜品折扣，只是美團(tuán)商家、APP方配送的門店才會(huì)設(shè)置，默認(rèn)為1。折扣值不參與總價(jià)計(jì)算。開放平臺(tái)1.0.3新增),"."extras此字段為Json串，具體格式如下："extras":"act_detail_id":10,（活動(dòng)id）"reduce_fee":2.5,（活動(dòng)優(yōu)惠金額，是美團(tuán)承擔(dān)活動(dòng)費(fèi)用和商戶承擔(dān)活動(dòng)費(fèi)用的總和）"remark":"滿10元減2.5元",（優(yōu)惠說明）type

11、":1,（活動(dòng)典型）"avg_send_time”銀5年均送餐時(shí)間，單位為分鐘）,"reduce_fee":5,（優(yōu)惠金額，是美團(tuán)承擔(dān)活動(dòng)費(fèi)用和商戶承擔(dān)活動(dòng)費(fèi)用的總和）"remark":"新用戶立減5兀"，（優(yōu)惠說明）type":1,（活動(dòng)典型）"avg_send_time”餐團(tuán)年均送餐時(shí)間，單位為分鐘）,3,確認(rèn)訂單已經(jīng)下載REST地址請(qǐng)求方法POST說明訂單下載成功后，調(diào)用此接口修改訂單下載狀態(tài)請(qǐng)求參數(shù)名稱說明app_idorder_id_list訂單ids,order_id數(shù)組:id1,i

12、d2,id3.,idNtimestampsig返回值調(diào)用成功返回值："data":"ok",其余情況請(qǐng)參考”快速開始-返回參數(shù)格式說明"4,用戶或客服取消訂單APIREST地址請(qǐng)求方法GET說明美團(tuán)外賣會(huì)取消訂單回調(diào)接口（參照用戶或客服取消訂單API（必接）請(qǐng)求參數(shù)名稱說明app_idtimestampsigorder_id訂單IDreason_code規(guī)范化的訂單取消code,詳情請(qǐng)參考（取消訂單原因列表）reason取消原因返回值調(diào)用成功返回值："data":"ok",其余情況請(qǐng)參考"快速開

13、始-返回參數(shù)格式說明"5,美團(tuán)用戶或客服進(jìn)行退款流程操作REST地址請(qǐng)求方法GET說明美團(tuán)用戶或客服進(jìn)行退款流程操作（參照美團(tuán)用戶或客服進(jìn)行退款流程操作）請(qǐng)求參數(shù)名稱說明app_idtimestampsigorder_id訂單IDnotify_type通知類型，apply:發(fā)起退款agree：確認(rèn)退款reject:駁回退款cancelRefund:用戶取消退款機(jī)#cancelRefundComplaint:取消退款申訴reason原因返回值調(diào)用成功返回值："data":"ok",其余情況請(qǐng)參考”快速開始-返回參數(shù)格式說明"6.商家獲取

14、申請(qǐng)退款信息REST地址請(qǐng)求方法GET說明商家獲取中詁退款/息請(qǐng)求參數(shù)名稱說明app_idtimestampsignotify_type通知類型，apply：發(fā)起退款agree：確認(rèn)退款reject:駁回退款cancelRefund:用戶取消退款機(jī)#cancelRefundComplaint:取消退款申訴返回值調(diào)用成功返回值："data":"notify_type":"apply","order_id":6124982,"reason":"不想退了","notify_type":"apply","order_id":6124985,"reason":"我也不想退了","notifytype":"app