美團(tuán)券對(duì)接API文檔

1、美團(tuán)券驗(yàn)證平臺(tái)接入文檔* 1接入步驟* 2驗(yàn)證流程.3接口設(shè)計(jì)3.0說明3.0.1 sign 計(jì)算方法：3.0.2 測試用的app_key,sign_key 和美團(tuán)券密碼:-3.1 M1接口：查詢美團(tuán)券信息接口地址：' 請(qǐng)求方式：輸入?yún)?shù)：返回結(jié)果：*錯(cuò)誤碼：*調(diào)用示例：* 3.2 M2接口 ：消費(fèi)美團(tuán)券接口地址：請(qǐng)求方式：輸入?yún)?shù)：*返回結(jié)果：-錯(cuò)誤碼：+調(diào)用示例： 3.3 M3接口：沖正美團(tuán)券狀態(tài)+接口地址：請(qǐng)求方式：*輸入?yún)?shù)：返回結(jié)果：*調(diào)用示例：* 4 Q&A1接入步驟第一步：申請(qǐng)接入，美團(tuán)創(chuàng)建接入第三方實(shí)體，同時(shí)給第三方分配接入憑證（app_key,sign_key

2、）第二步：第三方進(jìn)行系統(tǒng)開發(fā)測試，實(shí)現(xiàn)美團(tuán)的驗(yàn)證接口第三步：合作項(xiàng)目上線前，第三方提交一份門店id和名字的列表，由美團(tuán)配置一份兩邊poiid的對(duì)應(yīng)表列表格式：第三方門店id第三方門店名門店所屬城市門店所屬區(qū)域12345海底撈（朝陽門店）北京東城區(qū)美團(tuán)維護(hù)的poiid對(duì)應(yīng)表格式:系統(tǒng)接入方美團(tuán)門店id第三方門店id第三方門店名門店所屬城市門店所屬區(qū)域XXX1234512345海底撈（朝陽門店）北京東城區(qū)后續(xù)維護(hù): 系統(tǒng)使用期間，如第三方有門店更改、添加，需提交申請(qǐng)給指定美團(tuán)聯(lián)系人。2驗(yàn)證流程3接口設(shè)計(jì)3.0說明3.0.1 sig n計(jì)算方法：首先將通知過來的所有參數(shù)，除去sign本身，以及值是空

3、的參數(shù)，按參數(shù)名字母升序排序，然后按參數(shù)1值1參數(shù)2值2參數(shù)n值n的方式進(jìn)行連接，得到一個(gè)字符串然后在連接后得到的字符串前面加上通知驗(yàn)證密鑰（sign_key, 不同于app_key），然后計(jì)算shal值，轉(zhuǎn)成小寫比如請(qǐng)求的參數(shù)為：?sign=9987e6395c239a48ac7f0d185c525ee965e591a7&verifycode=123412341234&app_key=ca2bf41f1910a9c359370ebf87caeafd&p oiid=12345&timestamp=1384333143&poiname=海底撈（朝陽店）&a

4、mp;v=1去掉 sign 參數(shù)，其余的按參數(shù)名升序排列：app_keyca2bf41f1910a9c359370ebf87caeafdpoiid12345poiname海底撈（朝陽店）timestamp1384333143v1verifycode123412341234假設(shè) sign_key 為21be83530509abc81aa945a02bec37601cf3cc21，我們把 sign_key 放在上面的字符串的前面：21be83530509abc81aa945a02bec37601cf3cc21app_keyca2bf41f1910a9c359370ebf87caeafdpoiid1

5、2345poiname海底撈（朝陽店）timestamp1384333143v1verifycode123412341234計(jì)算 sha1（）結(jié)果為：9987e6395c239a48ac7f0d185c525ee965e591a7注意：本文中所有對(duì)應(yīng)的參數(shù)名和值都請(qǐng)使用utf-8編碼格式3.0.2 測試用的app_key,sign_key和美團(tuán)券密碼：app_key:ca2bf41f1910a9c359370ebf87caeafdsign_key:21be83530509abc81aa945a02bec37601cf3cc21poiid:12345美團(tuán)券密碼:verifycode狀態(tài)12341

6、2341234可使用112233441122已消費(fèi)121234341212已退款111133332222已過期222244441111已凍結(jié)其他密碼錯(cuò)誤3.1 M1接口：查詢美團(tuán)券信息接口地址：http:/e.meitua n. com/api/ecoup oninfo請(qǐng)求方式:HTTP GET輸入?yún)?shù)：字段verifycodeapp_keypoiidpoinameposid timestamp signv返回結(jié)果：字段err_codeerr_str verifycode coupon_status必填字段類型示例值是string012312341234是stringca2bf41f1910a

7、9c359370ebf87caeafd是string1234否string北京-海底撈（朝陽門店）否stringk12344121313是int1384333143是string1b759da18a739e1e是string1.0字段說明美團(tuán)券密碼，12位數(shù)字美團(tuán)分配的接入toke n碼商內(nèi)部的門店id門店名稱驗(yàn)證美團(tuán)券的pos機(jī)id時(shí)間戳api輸入?yún)?shù)簽名結(jié)果版本號(hào)status_strdealid goodsnamepricevalueendtime必填字段類型示例值默認(rèn)值是int0是string查詢成功是string012312341234是int1-1是string該美團(tuán)券已消費(fèi)過， 不

8、能使用是int12345-1是string西貝西北菜代金券1 張是string70是string100是string2013-12-1259:59:59字段說明0 : 查詢成功，1xxx:查詢失敗錯(cuò)誤描述輸入的美團(tuán)券密碼美團(tuán)券狀態(tài)：0:該美團(tuán)券可使用1:該美團(tuán)券已消費(fèi)過，不能使用2：該美團(tuán)券已退款，不能使用3:該美團(tuán)券已過期，不能使用4：該美團(tuán)券已凍結(jié)，不能使用美團(tuán)券狀態(tài)描述美團(tuán)券所屬項(xiàng)目id商品描述購買價(jià)格實(shí)際價(jià)格美團(tuán)券使用有效期截止時(shí)間usetime是string2013-08-12美團(tuán)券消費(fèi)日期，st59:59:59atus 為 1 時(shí)有值poiname是string北京-海底撈（朝陽美

9、團(tuán)券消費(fèi)門店，st門店）atus為1時(shí)有值錯(cuò)誤碼：err_codeerr_str0查詢成功1001參數(shù)錯(cuò)誤1002簽名錯(cuò)誤1003appkey錯(cuò)誤1004門店未注冊(cè)1005沒有找到該美團(tuán)券1105同1005，沒有找到改美團(tuán)券調(diào)用示例:請(qǐng)求：curl' 23412341234&app_key=ca2bf41f1910a9c359370ebf87caeafd&poiid=12345&timestamp=1384333143&poi name=%E6%B5%B7%E5%BA%95%E6%8D%9E(%E6%9C%9D%E9%98%B3%E5%BA%97)&am

10、p;v=1'返回："err_code": 0,"err_str":"查詢成功","verifycode": "123412341234", "coupon_status": 0,"status_str":"該美團(tuán)券可使用"dealid": 1234,"goodsname":"測試商品信息","price": "119.9","va

11、lue": "120.0", "endtime": "2014-12-12 59:59:59", "usetime":"","poiname":""3.2 M2接口 ：消費(fèi)美團(tuán)券接口地址：http:請(qǐng)求方式：HTTP GET輸入?yún)?shù):字段必填字段類型示例值字段說明verifycode是string012312341234美團(tuán)券密碼，12位數(shù)字app_key是stringca2bf41f1910a9c359370ebf87caeafd美團(tuán)分配的接入

12、toke npoiid是string1234碼商內(nèi)部的門店idpoiname否string北京-海底撈（朝陽門店）門店名稱posid否stringk12344121313驗(yàn)證美團(tuán)券的pos機(jī)idtimestamp是int1384333143時(shí)間戳sqnum是string23131313133請(qǐng)求序列號(hào)，如有沖正流 程，可以此作為沖正憑證sign是string1b759da18a739e1eapi輸入?yún)?shù)簽名結(jié)果v是string1.0版本號(hào)返回結(jié)果:字段必填字段類型示例值默認(rèn)值字段說明err_code是int00 :消費(fèi)成功，1xxx : 消費(fèi)失敗err_str是string消費(fèi)成功錯(cuò)誤描述ve

13、rifycode是string012312341234輸入的美團(tuán)券密碼dealid是int12345美團(tuán)券所屬項(xiàng)目idgoodsname是string西貝西北菜代金券1 張商品描述price是string70購買價(jià)格value是string100實(shí)際價(jià)格endtime是string2013-12-1259:59:59美團(tuán)券使用有效期截 止時(shí)usetime是string2013-08-1259:59:59消費(fèi)時(shí)間poiname是string海底撈（朝陽門店）消費(fèi)門店print_tpl是sting小票打印內(nèi)容錯(cuò)誤碼:err_codeerr_str0消費(fèi)成功1001參數(shù)錯(cuò)誤1002簽名錯(cuò)誤1003a

14、ppkey錯(cuò)誤1004門店未注冊(cè)1005沒有找到該美團(tuán)券1006該美團(tuán)券已消費(fèi)過，不能使用1007該美團(tuán)券已退款，不能使用1008該美團(tuán)券已過期，不能使用1009該美團(tuán)券已被凍結(jié)，不能使用調(diào)用示例：請(qǐng)求:curl' bf41f1910a9c359370ebf87caeafd&v=1 &sign=c64bd8a21d35ab8cbd05c6d9008ff2e88ad344ab&poiid=12345&poiname=%E6%B5%B7%E5%BA%95%E6%8D%9E%28%E6%9C%9D%E9%98%B3%E5%BA%97%29&times

15、tamp=1419397555'返回:"err_code": 0, “err_str"："消費(fèi)成功","verifycode": "123412341234", "dealid": 1234,"goodsname":"測試商品信息"price": "119.9","value": "120.0", "endtime": "2015-01-3

16、0 59:59:59", "usetime":"","poiname":""3.3 M3接口：沖正美團(tuán)券狀態(tài)接口地址:http: /請(qǐng)求方式:HTTP GET輸入?yún)?shù):字段必填字段類型示例值字段說明verifycode是string012312341234美團(tuán)券密碼，12位數(shù)字app_key是stringca2bf41f1910a9c359370ebf87caeafd美團(tuán)分配的接入toke npoiid是string1234碼商內(nèi)部的門店idtimestamp是int1384333143時(shí)間戳consum

17、e_sqnum是string23131313133與對(duì)應(yīng)的核銷請(qǐng)求保持一 致，否則校驗(yàn)不通過sign是string1b759da18a739e1eapi輸入?yún)?shù)簽名結(jié)果v是string1.0版本號(hào)返回結(jié)果:字段必填字段類型示例值默認(rèn)值字段說明err_code是int00 : 沖正成功，1xxx : 沖正失敗err_str是string沖正成功錯(cuò)誤描述verifycode是string012312341234輸入的美團(tuán)券密碼調(diào)用示例：請(qǐng)求：curl'4&app_key=ca2bf41f1910a9c359370ebf87caeafd&v=1 &sign=3daa0

18、e20073da2e59f27b26f2fc8b875048de2 da&poiid=12345&timestamp=1419397555'返回："err_code": "0","err_str":"沖正成功","verifycode": "123412341234"4 Q&AQ:為什么驗(yàn)證了美團(tuán)券 123412341234，但是下次還是可以驗(yàn)證？A:使用測試的appkey和signkey進(jìn)行驗(yàn)證時(shí)，實(shí)際上是不會(huì)寫數(shù)據(jù)庫的，只是按固定的格式返回?cái)?shù)據(jù)，方便您的測試。測試通過后可以聯(lián)系美團(tuán)的技術(shù)人員申請(qǐng)正式的appkey,需要提供如下的信息：公司名稱，對(duì)接的技