支付成功通知接口

1.概述

客户平台通过【支付成功通知】接口将支付成功状态同步给美团企业版，美团企业版将推动交易完成。

2.接口基本信息

信息名称	信息描述
请求方式	POST
调用地址	测试环境域名：waimai-openapi.apigw.test.meituan.com 正式环境域名：bep-openapi.meituan.com 实际调用地址以下单接口中notifyUrl字段内容为准。
调用方	客户平台
响应方	美团企业版
响应超时时间	5s
调用限频	每分钟访问不超过100次，每天累计访问不超过100,000次

2.1 请求体

名称	类型	是否必填	示例	说明
accessKey	String	是	B3GFJIEHNEM1RLV-TK	美团企业版分配给客户的接入秘钥
content	String	是	UgxoCGPQIzoP	请求体内容，将请求参数JSON序列化后进行加密的结果值，参照：签名实例

content 加密前数据结构

名称	类型	是否必填	示例	说明
ts	Long	是	1617085650321	13位时间戳。若请求发起时间与平台接受请求时间相差大于10分钟，平台将直接拒绝本次请求
entId	Long	是	46574	企业ID
tradeNo	String[64]	是	393033370136698	交易号，每笔支付的唯一标识，需要以此字段做幂等处理
thirdTradeNo	String[45]	是	393073139773549_3VBZB2KN71	客户平台交易号
tradeAmount	String	是	12.32	支付金额(不包含服务费)，单位元，支持小数点后两位
serviceFeeAmount	String	否	0.32	随单服务费（空值表示没有服务费），单位元，支持小数点后两位
paymentDetails	jsonString	否	[ { "fundBearer":"cust", "detailAmount":100, "detailFlowId":"1234" }, { "fundBearer":"cust2", "detailAmount":100, "detailFlowId":"1234", "detailBatchNum":"DEBIT", "detailName":"商家代金券满50减3元", "detailExt":"{"other":"620000"}" } ]	支付明细（支付金额不含随单服务费）当第三方收银台企业配置资金构成配置时，必填

paymentDetails 支付明细数据结构

名称	类型	是否必填	示例	说明
fundBearer	String	是	cust	资金承担方
detailAmount	String	是	3.00	资金承担方支付金额(不包含服务费)，单位元，支持小数点后两位
detailFlowId	String	否	1223343	营销券ID，或客户平台的流水ID，唯一
detailBatchNum	String	否	1242354363343	营销活动批次
detailName	String	否	商家代金券满50减3元	营销活动的名称
detailExt	String	否		扩展字段，可填关于营销活动的其他信息，要求格式为json

2.2 响应体

名称	类型	是否必填	示例	说明
traceId	String	是	9042536864303509624	日志查询ID
status	Integer	是	0	0为成功，其他错误见错误码
msg	String	是		失败时的错误描述
data	String	是	UgJn07uNgW7S7fJK0R0xVbaLxoCGPQIzoP-_K4Hmp4RduGszhm2mbUs2toZhCtXKP5JGXVTZ9kGts2Wx3IJQCd90ptMoJTDB0vu7mkedEr4KZCvZn77EZLssMC5SpXilmQ-5RXHzvMIT0ASH-IXepTP_O16U37QqCkEb5L1WLy4	响应数据，将响应参数JSON序列化后进行加密的结果值，解密秘钥使用secretKey参数，参照：签名实例

data解密后数据结构

无

3.请求示例

3.1 请求示例

POST /api/sqt/open/standardThird/v2/pay/callback?tradeModel=FLOW HTTP/1.1
Host: waimai-openapi.apigw.test.meituan.com
Content-Type: application/json
Accept: application/json

{
    "accessKey":"CC1NRDRJLC76-TK",
    "content":"fOlyzxsoYjk8d2D5mwkRlobig8PdmXJ0LnDHmriqYTOSijetVOnNkAF-lJRGhI1xlk15Yse6LnUbvqlPWHKCcvvdjan47pkI7_ouIUFy2x8Df51A0YC-s69t9AstjL3fR_T_XqLIwIYL1YKofUqw6ihasPMel7kCBzhWQLS15oyR92HPxzW8_mF3HsatL5KbkfblGhLW_ZufiADVUvoVCX8NpkCqTPe5WgIuWYlg1F2k-LBOKXjrs6ppzHOCi-4O3FL2Hw_WozxNWwYvXVtc8Mok3KY-x6c3cIlHKQ9R6PhK-GD7DUs75Q3M2yNihpgc"
}

content 明文

{
    "ts": 1676351861253,
    "entId": 101442,
    "tradeNo": "1625341310296658007",
    "thirdTradeNo": "757206679686983682",
    "tradeAmount": "2.00",
    "serviceFeeAmount": "0.12",
    "paymentDetails": "[
      {
        \"fundBearer\": \"cust\",
        \"detailAmount\": 100,
        \"detailFlowId\": \"1234\"
      },
      {
        \"fundBearer\": \"cust2\",
        \"detailAmount\": 100,
        \"detailFlowId\": \"1234\",
        \"detailBatchNum\": \"DEBIT\",
        \"detailName\": \"商家代金券满50减3元\",
        \"detailExt\": \"{\"other\": \"620000\"}\"
      }
    ]"
}

3.2 响应示例

{
    "status": 0,
    "data": "zj3dHwWvrT_pnzMZTAVFmA",
    "traceId": "666532928318336793",
    "msg": "success"
}

data 明文

{}

4.错误码

4.1 公共错误码

错误码	错误描述	解决方案
20010001	accessKey不合法	检查accessKey是否为客户经理给到的值，如果accessKey值正确，确认调用环境是否和accessKey一致，如使用测试环境的accessKey调用线上的接口
20010002	请求path不合法	检查接口调用地址是否正确，如是否有非法字符
20010003	鉴权失败，无接口访问权限	将接口调用地址给到客户经理，由客户经理检查接口权限是否开通并保存成功
10010002	企业已停止合作，请联系客户经理进行确认	将接口调用的entId参数给到客户经理，由客户经理确认企业状态是否在合作中
10010003	content不合法	请详细阅读签名实例，确认content加密方式和content解密前传参是否正确
10010004	ts缺失或ts时间已过期	确认ts是否传值并为13位时间戳，如果正确传值，则确认请求发起时间与美团企业版接受请求的时间差是否超过10分钟
10010005	entId不能为空	entId参数不可为空，如果未拿到entId参数，可以咨询客户经理获取
30010001	访问频率过高	请确认接口访问频率，每个接口默认调用限频为每分钟不超过100次，超出调用频率会调用此错误
30010002	访问次数超过配额	请确认接口的累计访问次数，每个接口的默认累计调用量为10w次，超出限额则会报错
20010004	越权访问，无法访问该企业数据，请检查entId的正确性	检查accessKey和entId两个参数的对应关系是否正确

4.2 业务错误码

错误码	错误描述	解决方案
10231500	服务错误	请提供tradeNo参数和entId参数，联系客户经理进行排查。
10231501	服务繁忙	请提供tradeNo参数和entId参数，联系客户经理进行排查。
10231401	参数错误	参数格式错误或参数缺失导致无法处理请求，请按照接口响应信息排查参数问题。
10231002	交易不存在	请检查tradeNo字段传值是否为美团企业版给到的数据。
10231003	订单不存在	请检查tradeNo字段传值是否为美团企业版给到的数据。
10231001	金额校验失败	请检查tradeAmount字段传值，字段值必须与【下单接口】中传值相同。
10231004	禁止交易	请检查订单状态，订单可能已经关闭或者已经超过允许支付的时间，不可再继续支付，如果已经收取了客户费用，需要客户平台给用户进行退款。

5.版本记录

版本号	版本日期	更新内容
V1.0	2022-11-05	初版