对接说明

1.概述

本文主要介绍客户对接美团企业版支付系统的对接流程，下文结合使用场景分别介绍接口调用逻辑和注意事项。

1、客户对接过程中，需按照美团企业版接口规范进行开发；
2、由于无法公网访问美团企业版测试环境，在测试环境联调阶段，需要客户开发测试接口进行自测。

2.应用场景示例

1、客户平台需要自建收银页面，并在【下单接口】中将支付页面URL通过`thirdPayUrl`字段返回，且需要使用HTTPS协议；
2、支付成功后，根据【下单接口】中`returnUrl`跳转到成功页面，且需要调用【支付成功通知】接口告知美团企业版，调用地址见【下单接口】中的`notifyUrl`字段。

3.资金流向说明

1、用户的资金与客户平台进行闭环，下单时，用户将费用支付给客户平台，退款时，由客户平台将钱退回给用户；
2、客户需要将资金预充到美团企业版侧的钱包账户中，当用户支付成功，美团企业版会从客户钱包中进行扣费，以支付给商家，当用户发起退款，美团企业版会先将费用退回到客户钱包，再通知客户给用户退款。

4.交互流程说明

1、如果客户需要自建订单列表，需要根据订单号（sqtBizOrderId）进行订单去重；
2、当一个订单发起多次支付时，sqtBizOrderId不变，但tradeNo会发生变化，因此需要限制一笔订单只能有一笔支付成功消息；
3、同一笔订单，只能有一笔支付成功流水，如果出现一个订单产生多笔支付成功流水的情况，美团企业版会走退款流程。

5.对接时序

6.对接方案

	【订单模型】对接方案	【订单+支付流水】对接方案
方案简介	以【订单ID】串联用户交易行为，如支付、退款动作等，都是在订单维度上实现的，不关注是否多次唤起收银台。	以【流水ID+订单ID】串联用户交易行为，用户下单后，产生唯一订单号，但是每产生一个交易动作，就会产生一个新的流水ID，如首次支付失败，再次尝试支付，订单ID为同一个，但是有两个流水ID。
适用客户	交易流程中只会产生订单号的客户	交易流程中，需要严格区分每一笔流水和订单关系的客户
传值要求	tradeNo 与美团企业版订单号等值	tradeNo 为交易流水号