美团券对接API文档

1、美团券验证平台接入文档* 1接入步骤* 2验证流程.3接口设计3.0说明3.0.1 sign 计算方法：3.0.2 测试用的app_key,sign_key 和美团券密码:-3.1 M1接口：查询美团券信息接口地址：' 请求方式：输入参数：返回结果：*错误码：*调用示例：* 3.2 M2接口 ：消费美团券接口地址：请求方式：输入参数：*返回结果：-错误码：+调用示例： 3.3 M3接口：冲正美团券状态+接口地址：请求方式：*输入参数：返回结果：*调用示例：* 4 Q&A1接入步骤第一步：申请接入，美团创建接入第三方实体，同时给第三方分配接入凭证（app_key,sign_key

2、）第二步：第三方进行系统开发测试，实现美团的验证接口第三步：合作项目上线前，第三方提交一份门店id和名字的列表，由美团配置一份两边poiid的对应表列表格式：第三方门店id第三方门店名门店所属城市门店所属区域12345海底捞（朝阳门店）北京东城区美团维护的poiid对应表格式:系统接入方美团门店id第三方门店id第三方门店名门店所属城市门店所属区域XXX1234512345海底捞（朝阳门店）北京东城区后续维护: 系统使用期间，如第三方有门店更改、添加，需提交申请给指定美团联系人。2验证流程3接口设计3.0说明3.0.1 sig n计算方法：首先将通知过来的所有参数，除去sign本身，以及值是空

3、的参数，按参数名字母升序排序，然后按参数1值1参数2值2参数n值n的方式进行连接，得到一个字符串然后在连接后得到的字符串前面加上通知验证密钥（sign_key, 不同于app_key），然后计算shal值，转成小写比如请求的参数为：?sign=9987e6395c239a48ac7f0d185c525ee965e591a7&verifycode=123412341234&app_key=ca2bf41f1910a9c359370ebf87caeafd&p oiid=12345&timestamp=1384333143&poiname=海底捞（朝阳店）&a

4、mp;v=1去掉 sign 参数，其余的按参数名升序排列：app_keyca2bf41f1910a9c359370ebf87caeafdpoiid12345poiname海底捞（朝阳店）timestamp1384333143v1verifycode123412341234假设 sign_key 为21be83530509abc81aa945a02bec37601cf3cc21，我们把 sign_key 放在上面的字符串的前面：21be83530509abc81aa945a02bec37601cf3cc21app_keyca2bf41f1910a9c359370ebf87caeafdpoiid1

5、2345poiname海底捞（朝阳店）timestamp1384333143v1verifycode123412341234计算 sha1（）结果为：9987e6395c239a48ac7f0d185c525ee965e591a7注意：本文中所有对应的参数名和值都请使用utf-8编码格式3.0.2 测试用的app_key,sign_key和美团券密码：app_key:ca2bf41f1910a9c359370ebf87caeafdsign_key:21be83530509abc81aa945a02bec37601cf3cc21poiid:12345美团券密码:verifycode状态12341

6、2341234可使用112233441122已消费121234341212已退款111133332222已过期222244441111已冻结其他密码错误3.1 M1接口：查询美团券信息接口地址：http:/e.meitua n. com/api/ecoup oninfo请求方式:HTTP GET输入参数：字段verifycodeapp_keypoiidpoinameposid timestamp signv返回结果：字段err_codeerr_str verifycode coupon_status必填字段类型示例值是string012312341234是stringca2bf41f1910a

7、9c359370ebf87caeafd是string1234否string北京-海底捞（朝阳门店）否stringk12344121313是int1384333143是string1b759da18a739e1e是string1.0字段说明美团券密码，12位数字美团分配的接入toke n码商内部的门店id门店名称验证美团券的pos机id时间戳api输入参数签名结果版本号status_strdealid goodsnamepricevalueendtime必填字段类型示例值默认值是int0是string查询成功是string012312341234是int1-1是string该美团券已消费过， 不

8、能使用是int12345-1是string西贝西北菜代金券1 张是string70是string100是string2013-12-1259:59:59字段说明0 : 查询成功，1xxx:查询失败错误描述输入的美团券密码美团券状态：0:该美团券可使用1:该美团券已消费过，不能使用2：该美团券已退款，不能使用3:该美团券已过期，不能使用4：该美团券已冻结，不能使用美团券状态描述美团券所属项目id商品描述购买价格实际价格美团券使用有效期截止时间usetime是string2013-08-12美团券消费日期，st59:59:59atus 为 1 时有值poiname是string北京-海底捞（朝阳美

9、团券消费门店，st门店）atus为1时有值错误码：err_codeerr_str0查询成功1001参数错误1002签名错误1003appkey错误1004门店未注册1005没有找到该美团券1105同1005，没有找到改美团券调用示例:请求：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":"该美团券可使用"dealid": 1234,"goodsname":"测试商品信息","price": "119.9","va

11、lue": "120.0", "endtime": "2014-12-12 59:59:59", "usetime":"","poiname":""3.2 M2接口 ：消费美团券接口地址：http:请求方式：HTTP GET输入参数:字段必填字段类型示例值字段说明verifycode是string012312341234美团券密码，12位数字app_key是stringca2bf41f1910a9c359370ebf87caeafd美团分配的接入

12、toke npoiid是string1234码商内部的门店idpoiname否string北京-海底捞（朝阳门店）门店名称posid否stringk12344121313验证美团券的pos机idtimestamp是int1384333143时间戳sqnum是string23131313133请求序列号，如有冲正流 程，可以此作为冲正凭证sign是string1b759da18a739e1eapi输入参数签名结果v是string1.0版本号返回结果:字段必填字段类型示例值默认值字段说明err_code是int00 :消费成功，1xxx : 消费失败err_str是string消费成功错误描述ve

13、rifycode是string012312341234输入的美团券密码dealid是int12345美团券所属项目idgoodsname是string西贝西北菜代金券1 张商品描述price是string70购买价格value是string100实际价格endtime是string2013-12-1259:59:59美团券使用有效期截 止时usetime是string2013-08-1259:59:59消费时间poiname是string海底捞（朝阳门店）消费门店print_tpl是sting小票打印内容错误码:err_codeerr_str0消费成功1001参数错误1002签名错误1003a

14、ppkey错误1004门店未注册1005没有找到该美团券1006该美团券已消费过，不能使用1007该美团券已退款，不能使用1008该美团券已过期，不能使用1009该美团券已被冻结，不能使用调用示例：请求: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"："消费成功","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接口：冲正美团券状态接口地址:http: /请求方式:HTTP GET输入参数:字段必填字段类型示例值字段说明verifycode是string012312341234美团券密码，12位数字app_key是stringca2bf41f1910a9c359370ebf87caeafd美团分配的接入toke npoiid是string1234码商内部的门店idtimestamp是int1384333143时间戳consum

17、e_sqnum是string23131313133与对应的核销请求保持一 致，否则校验不通过sign是string1b759da18a739e1eapi输入参数签名结果v是string1.0版本号返回结果:字段必填字段类型示例值默认值字段说明err_code是int00 : 冲正成功，1xxx : 冲正失败err_str是string冲正成功错误描述verifycode是string012312341234输入的美团券密码调用示例：请求：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:为什么验证了美团券 123412341234，但是下次还是可以验证？A:使用测试的appkey和signkey进行验证时，实际上是不会写数据库的，只是按固定的格式返回数据，方便您的测试。测试通过后可以联系美团的技术人员申请正式的appkey,需要提供如下的信息：公司名称，对接的技