美团外卖联合会员接入文档

查询是否可以会员直充

接口说明

功能描述
查询是否可以开通美团会员
接口地址
https://openapi.waimai.meituan.com/openapi/member/v2/query_can_member_recharge
method
POST
请求体
x-www-form-urlencoded
返回值
Json
限制
需要联系商务单独开通

认证参数

请参考开放平台OpenAPI文档 认证参数部分

业务参数

参数名 类型 必填? 示例值 描述
channel_id Int 4 美团侧分配的渠道ID. 测试环境使用1428523684,线上另外需要申请.
days string vip_31 开通会员类型. 请传入固定值: 月卡vip_31,季卡vip_93, 年卡vip_372

返回数据 示例

{
    "code": 0,  # long 网关层状态码,为 0 时,表示网关层校验通过,此时 data 中有数据;不为 0 时,errorInfo 中有数据。
    "msg": "调用成功",
    "errorInfo": null,
    "data": {
        "code": 1, # long 业务层状态码,根据业务具体含义判断。
        "msg": "参数错误",
    }
}

接口返回码

当返回code = 1时, 可通过 errorInfo 中的 failCode 捕获具体原因: 请参考开放平台OpenAPI文档 附录 网关错误码部分

当 code 为 0 时,通过字段 data 中的 code 获得业务数据:

code 含义
0 校验成功可以开通
1 参数错误
2 系统异常
3 校验失败,用户账号未绑定电话号码,建议提示用户使用手机号登录美团账号进行授权
4 校验失败,用户当前手机号与授权时手机号不同,建议提示用户重新授权

会员直充接口

接口说明

功能描述
开通美团会员, 美团会员直充接口
接口地址
https://openapi.waimai.meituan.com/openapi/v1/member_recharge
method
POST
请求体
x-www-form-urlencoded
返回值
Json
限制
需要联系商务单独开通

认证参数

请参考开放平台OpenAPI文档 认证参数部分 请注意调用方式,免登陆方式无需OAuth2鉴权

业务参数

参数名 类型 必填? 示例值 描述
channel_id Int 4 美团侧分配的渠道ID. 测试环境使用1428523684,线上另外需要申请.
order_id string 6383928341 渠道方订单ID
唯一, 每个订单号只能使用一次,使用后被核销
days string vip_31 开通会员类型. 请传入固定值: 月卡vip_31,季卡vip_93, 年卡vip_372
encrypted_mobile string f72fba31ecb2a146e112538fc9db0c61 加密手机号, 免登陆方式充值必传. RSA加密,秘钥联系开发人员

调用成功时的返回数据

{
    "code": 0,
    "msg": "调用成功",
    "errorInfo": null,
    "data": {
        "start_time": 1556094006, # (Long) 此order_id开通会员开始时间
        "end_time": 1558686006, # (Long) 此order_id开通会员结束时间
    }
}

接口返回码

当返回code = 1时, 可通过 errorInfo 中的 failCode 捕获具体原因:

响应failCode码 含义
16001 此order_id已经被核销
16002 已售罄
16003 开通会员异常, 需要重试
16005 用户未绑定手机号码
16006 用户被限购

其余错误码请参考开放平台OpenAPI文档 附录 网关错误码部分

查询是否可以取消直充

接口说明

功能描述
查询是否可以取消直充
接口地址
https://openapi.waimai.meituan.com/openapi/member/v2/query_can_cancel_recharge
method
POST
请求体
x-www-form-urlencoded
返回值
Json
限制
需要联系商务单独开通

认证参数

请参考开放平台OpenAPI文档 认证参数部分

业务参数

参数名 类型 必填? 示例值 描述
channel_id Int 4 美团侧分配的渠道ID. 测试环境使用1428523684,线上另外需要申请.
order_id string 6383928341 渠道方订单ID

调用成功时的返回数据

{
    "code": 0, # 网关返回结果码 0:调用成功  1:调用失败
    "msg": "调用成功",
    "errorInfo": null,
    "data": {
        "code": 0, # 业务返回结果码 0:成功 1:调用失败
        "msg": "调用成功", # 业务结果描述
        "canCancel": 1, # 是否可取消 0不可取消,1可取消
        "reason":1, #不可取消原因 1:未知订单,2:已过有效期,3:权益已使用,4:系统错误,5:退款已完成
        "reasonMsg": "" #不可取消原因描述
    }
}

调用失败时的返回数据

{
    "code": 1, # 网关结果码 0:调用成功  1:调用失败
    "msg": "调用失败", # 网关结果描述
    "errorInfo": {
                   "failCode": "10001",
                   "name": "参数传递不完整"
                 },
    "data": null
}

接口返回码

当返回code = 1时, 可通过failCode捕获具体原因: 请参考开放平台OpenAPI文档 附录 网关错误码部分

查询取消直充进度

接口说明

功能描述
查询取消直充进度
接口地址
https://openapi.waimai.meituan.com/openapi/member/v2/query_cancel_recharge_status
method
POST
请求体
x-www-form-urlencoded
返回值
Json
限制
需要联系商务单独开通

认证参数

请参考开放平台OpenAPI文档 认证参数部分

业务参数

参数名 类型 必填? 示例值 描述
channel_id Int 4 美团侧分配的渠道ID. 测试环境使用1428523684,线上另外需要申请.
order_id string 6383928341 渠道方订单ID

调用成功时的返回数据

{
    "code": 0, # 网关返回结果码 0:调用成功  1:调用失败
    "msg": "调用成功",
    "errorInfo": null,
    "data": {
        "code": 0, # 业务返回结果码 0:成功 1:失败
        "msg": "调用成功", # 业务结果描述
        "canCancel": 1, # 是否可取消 0不可取消,1可取消
        "reason":1, #失败原因 2: 权益过期,3:权益已使用
        "reasonMsg": "", #失败原因描述
        "status": 1   # 取消直充进度  0:未开始,1:进行中,2:已完成,3:失败
    }
}

调用失败时的返回数据

{
    "code": 1, # 网关结果码 0:调用成功  1:调用失败
    "msg": "调用失败", # 网关结果描述
    "errorInfo": {
                   "failCode": "10001",
                   "name": "参数传递不完整"
                 },
    "data": null
}

接口返回码

当返回code = 1时, 可通过 errorInfo 中的 failCode 捕获具体原因: 请参考开放平台OpenAPI文档 附录 网关错误码部分

发起取消直充

接口说明

功能描述
发起取消直充
接口地址
https://openapi.waimai.meituan.com/openapi/member/v2/cancel_recharge
method
POST
请求体
x-www-form-urlencoded
返回值
Json
限制
需要联系商务单独开通

认证参数

请参考开放平台OpenAPI文档 认证参数部分

业务参数

参数名 类型 必填? 示例值 描述
channel_id Int 4 美团侧分配的渠道ID. 测试环境使用1428523684,线上另外需要申请.
order_id string 6383928341 渠道方订单ID

调用成功时的返回数据

{
    "code": 0, # 网关返回结果码 0:调用成功  1:调用失败
    "msg": "调用成功",
    "errorInfo": null,
    "data": {
        "code": 0, # 业务返回结果码 0:成功 1:调用失败
        "msg": "调用成功", # 业务结果描述
        "canCancel": 1, # 是否可取消 0不可取消,1可取消
        "reason":1, #不可取消原因 1:未知订单,2:已过有效期,3:权益已使用,4:系统错误,5:退款已完成
        "reasonMsg": "" #不可取消原因描述
    }
}

调用失败时的返回数据

{
    "code": 1, # 网关结果码 0:调用成功  1:调用失败
    "msg": "调用失败", # 网关结果描述
    "errorInfo": {
                   "failCode": "10001",
                   "name": "参数传递不完整"
                 },
    "data": null
}

接口返回码

当返回code = 1时, 可通过 errorInfo 中的 failCode 捕获具体原因: 请参考开放平台OpenAPI文档 附录 网关错误码部分

生成美团会员兑换码

接口说明

功能描述
生成美团会员兑换码
接口地址
https://openapi.waimai.meituan.com/member/generate_redeem_code
method
POST
请求体
x-www-form-urlencoded
返回值
Json
限制
需要联系商务单独开通

认证参数

请参考开放平台OpenAPI文档 认证参数部分 此接口无需OAuth2授权

业务参数

参数名 类型 必填? 示例值 描述
partner_code string 123456789 美团侧分配的渠道ID. 测试环境使用1428523684,线上另外需要申请.
trans_token string 1280846159413272668 交易唯一标识, 通常取渠道方订单ID,如果没有可以调用下方获取交易token获取
product_code string vip_31 开通会员类型. 请传入固定值: 月卡vip_31,季卡vip_93, 年卡vip_372

调用成功时的返回数据

{
    "code": 0, # 返回结果码 0:调用成功  1:调用失败
    "msg": "调用成功",
    "data": {
        "redeemCode": "ABCDEFG", # 兑换码
    }
}

调用失败时的返回数据

{
    "code": 1, # 结果码 0:调用成功  1:调用失败
    "msg": "", # 错误简略信息,详细信息参考errorInfo内容
    "errorInfo": {
                   "failCode": 17001,
                   "name": "请求中partnerCode[123456789}] & channelSource[test]不匹配"
                 },
    "data": { }
}

接口返回码

当返回code = 1时, 可通过 errorInfo 中的 failCode 捕获具体原因:

响应failCode码 含义
17001 参数错误
17002 非法请求
17003 渠道不在有效期内
17004 超出库存
17005 服务异常 请重试
17006 交易锁定中 需要重试
17007 接口降级 非特大问题不会返回该code
17008 交易标识已被其他产品标识规格使用
17009 交易标识无效

其余错误code,请参考开放平台OpenAPI通用错误码

获取交易token

接口说明

功能描述
获取交易token
接口地址
https://openapi.waimai.meituan.com/member/get_trans_token
method
POST
请求体
x-www-form-urlencoded
返回值
Json
限制
需要联系商务单独开通

认证参数

请参考开放平台OpenAPI文档 认证参数部分 此接口无需OAuth2授权

业务参数

参数名 类型 必填? 示例值 描述
partner_code string 123456789 美团侧分配的渠道ID. 测试环境使用1428523684,线上另外需要申请.

调用成功时的返回数据

{
    "code": 0, # 返回结果码 0:调用成功  1:调用失败
    "msg": "调用成功",
    "data": {
        "transToken": "1280846159413272668", # 交易token
    }
}

调用失败时的返回数据

{
    "code": 1, # 结果码 0:调用成功  1:调用失败
    "msg": "", # 错误简略信息,详细信息参考errorInfo内容
    "errorInfo": {
                   "failCode": 17001,
                   "name": "请求中partnerCode[123456789}] & channelSource[test]不匹配"
                 },
    "data": { }
}

接口返回码

当返回code = 1时, 可通过 errorInfo 中的 failCode 捕获具体原因:

响应failCode码 含义
17001 参数错误
17002 服务异常,请重试
17003 接口降级 非特大问题不会返回该code

其余错误code,请参考开放平台OpenAPI通用错误码

查询会员充值订单信息

接口说明

功能描述
查询会员充值订单信息
接口地址
https://openapi.waimai.meituan.com/member/get_external_channel_order_info
method
POST
请求体
x-www-form-urlencoded
返回值
Json
限制
需要联系商务单独开通

认证参数

请参考开放平台OpenAPI文档 认证参数部分 此接口无需OAuth2授权

业务参数

参数名 类型 必填? 示例值 描述
partner_code string 123456789 美团侧分配的渠道ID. 测试环境使用1428523684,线上另外需要申请.
channel_type int 1 渠道类型 1.外部直充 2.兑换码
order_id string 13579 外部渠道订单id/兑换码

调用成功时的返回数据

{
    "code": 0, # 返回结果码 0:调用成功  1:调用失败
    "msg": "调用成功",
    "data": {
        "orderId": "13579", # 外部直充订单/兑换码
        "partnerCode": "13579", # 合作方编码
        "nickName": "01", # 用户昵称
        "phone": "13000000000", # 充值的手机号
        "ctime": 1596444300, # 充值时间
        "memberTypeDesc": "美团尊享会员", # 会员类型描述
        "cardInstanceDesc": "月卡", # 会员卡规格文本 月卡/季卡/年卡
        "performStatusDesc": "已履约", # 履约状态描述  已履约/未到履约周期
        "sTime": 1596988800, # 会员开始时间
        "eTime": 1597161599, #  会员结束时间
    }
}

调用失败时的返回数据

{
    "code": 1, # 结果码 0:调用成功  1:调用失败
    "msg": "", # 错误简略信息,详细信息参考errorInfo内容
    "errorInfo": {
                   "failCode": 17001,
                   "name": "请求中partnerCode[123456789}] & channelSource[test]不匹配"
                 },
    "data": { }
}

接口返回码

当返回code = 1时, 可通过 errorInfo 中的 failCode 捕获具体原因:

响应failCode码 含义
17001 参数错误
17002 非法请求
17003 接口降级 非特大问题不会返回该code
17004 未知订单
17005 服务异常
17006 订单用户信息获取失败

其余错误code,请参考开放平台OpenAPI通用错误码