美团券API对接指南与接口文档

3星 · 超过75%的资源需积分: 50 199 浏览量更新于2024-09-09 1 收藏 274KB PDF 举报

身份认证购VIP最低享 7 折!

30元优惠券

"美团券对接API文档" 美团券对接API文档主要介绍了如何与美团券系统进行交互，以便在自己的业务中集成美团券的功能。这个文档包含了接入步骤、验证流程、接口设计以及常见问题解答，旨在帮助开发者顺利实现美团券的查询、消费和状态冲正。 1. 接入步骤 - 第一步：首先需要向美团申请接入，美团会创建一个针对第三方实体的接入，并分配接入凭证，包括app_key和sign_key。 - 第二步：获取到凭证后，第三方开发者需要根据提供的接口文档进行系统开发和测试，确保能正确实现美团券的验证功能。 - 第三步：在合作项目上线前，第三方需要提交一份包含门店ID和名称的列表，美团会根据这个列表配置一个POI ID（Point of Interest ID）的对应表，用于识别各个门店。 2. 验证流程 - 验证流程通常涉及对美团券的有效性进行检查，确保券的使用符合规定。 3. 接口设计 - **M1接口：查询美团券信息** - 这个接口用于查询美团券的具体信息，包括接口地址、请求方式、输入参数和返回结果。例如，可能需要提供POI ID、时间戳等参数，返回结果通常包含券的状态、名称、有效期等。 - **M2接口：消费美团券** - 通过此接口可以消费美团券，执行实际的支付动作。接口同样需要特定的请求方式和输入参数，如券ID、消费金额等，成功后会返回相应的确认信息。 - **M3接口：冲正美团券状态** - 当消费操作出现问题时，可以通过这个接口来撤销或修正美团券的状态，通常需要提供消费记录ID等相关信息。 4. sign计算方法 - sign的计算涉及到安全校验，需要将所有通知参数按字母升序排序，去掉值为空的参数，然后连接起来，再加上通知验证密钥(sign_key)并计算SHA1值，最后转换为小写。 5. 后续维护 - 在系统运行期间，如果第三方有门店信息的变更或新增，需要及时提交申请给美团的指定联系人进行更新。 6. Q&A - 包含接入步骤和验证流程的详细解释，帮助开发者解决在接入过程中遇到的问题。美团券对接API文档提供了一套完整的机制，让开发者能够集成美团券的服务到他们的应用中，包括查询、消费和管理美团券的功能。通过遵循文档中的步骤和接口设计，开发者可以实现与美团系统的无缝对接。

资源详情

资源推荐

美团券验证平台接入文档
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&A
1  接入步骤
第一步：申请接入，美团创建接入第三方实体，同时给第三方分配接入凭证(app_key,sign_key)
第二步：第三方进行系统开发测试，实现美团的验证接口
第三步：合作项目上线前，第三方提交一份门店id和名字的列表，由美团配置一份两边poiid的对应表
列表格式：
第三方门店id 第三方门店名 门店所属城市 门店所属区域
12345 海底捞（朝阳门店） 北京 东城区
 
美团维护的poiid对应表格式：
系统接入方 美团门店id 第三方门店id 第三方门店名 门店所属城市 门店所属区域
XXX 12345 12345 海底捞（朝阳门店） 北京 东城区
 
 
后续维护：
系统使用期间，如第三方有门店更改、添加，需提交申请给指定美团联系人。
2 验证流程