对接说明

1.概述

本文主要介绍三方收银台对接的流程方案，关键流程包含支付和退款，涉及接口包含标准三方收银台对接、订单变更推送、订单详情查询以及免登接口。

2.支付流程说明

2.1 用户视角支付交互图

1、从客户平台免登到美团企业版的页面，目前支持跳转机酒火餐车的单品类页，订单详情页以及美团企业版首页，下图中以外卖为例；
2、下图有两处是客户平台页面，一个是应用入口页，一个是收银台支付页。

2.2 支付时序图

3.退款流程说明

3.1 用户视角退款交互说明

1、客户平台可以自建列表页或详情页，嵌入美团企业版的免登入口，通过美团企业版免登接口跳转订单详情页或支付详情页进行退款；
2、也可以登录美团企业版，到订单中心进行退款，退款完成后，美团企业版会调用【退款接口】通知客户平台进行处理。

3.2 退款时序图

4.资金流向说明

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

5.包含接口

接口分组	接口名称	接口作用
第三方收银台对接	下单接口	通知客户平台下单成功，获取收银台跳转链接。
	支付成功通知接口	客户平台通知美团企业版订单支付状态，当美团收到支付成功通知后会更新支付状态为已支付。
	支付状态查询接口	当美团企业版未收到客户平台给到的支付成功通知，会主动查询支付状态，用于保证客户平台与美团订单的支付状态一致。
	支付关单接口	当订单到达关单时间时，美团企业版通过支付关单接口通知客户平台，关单后，不会再响应支付成功消息，客户平台如若收款成功，需进行退款。
	退款接口	当用户到美团企业版进行退款，美团通过退款接口通知客户平台。
订单中心	订单状态变更推送	订单状态变更消息推送给客户平台，客户平台收到通知后，再通过订单id调用订单详情查询接口获取明细信息。
	订单详情查询	根据订单id查询订单明细信息。
登录	H5免登	客户平台调用H5免登接口跳转美团企业版相关页面。

6.注意事项

注意事项	注意内容
提前确认收银台页面链接	收银台支付页面URL，在【下单接口】中返回给美团企业版
根据三方收银台对接方案，确认幂等依据	如果是【订单维度】对接，以订单号做幂等，如果是【订单+支付流水】对接，则根据流水号做幂等。