# 大发票模式第三方支付接入文档

# 1. 【对接说明】

# 1.1 对接时序图

对接流程图示

# 1.2 接口交互时序图

接口交互时序图

美团企业版交易平台向第三方平台发起创建用户请求，三方平台获取用户信息(美团企业版已加密)。
美团企业版交易平台向第三方平台发起下单支付请求，第三方平台处理支付返回支付流水号，美团企业版交易平台扭转订单状态。
美团企业版交易平台向第三方平台发起退款请求，第三方平台处理退款并返回退款流水号。
第三方下单支付请求超时时，美团企业版交易平台向第三方平台发起支付状态查询请求，第三方平台返回平台支付状态。
第三方需要查询美团企业版交易记录时，向美团企业版交易平台发起订单交易查询请求，美团企业版返回该交易的支付退款记录。

第三方平台向交易平台提供创建用户URL,下单支付接口URL,退款接口URL和支付状态查询接口URL。

# 2. 【接口说明】

# 2.1 创建用户

# 接口说明

名称	描述
功能	美团企业版交易平台向第三方平台创建用户
HTTP方法	POST, `application/x-www-form-urlencoded`
请求方	美团企业版平台
响应方	第三方平台
url	第三方平台提供
method	trade.outer.createStaff

# 业务参数

名称	类型	是否必填	示例	说明
staffId	Long	是	123456	员工Id
staffName	String	是	SNcX9Tphx_Zf6qRgb7aKZB3yQRmbPSHVYb	员工姓名,AES加密后传输
buyerOpenId	String	是	yMShk1qkg5ugannb7b85dw	员工唯一标识，AES加密后传输，如果在美团企业版后台设置的唯一标识是手机号，该字段是手机号。如果设置的是邮箱，该字段为邮箱。

# 业务响应

data体返回空，status和msg 返回成功失败即可

# 示例结果

{
  "staffId": 123456,
  "staffName": "SNcX9Tphx_Zf6qRgb7aKZB3yQRmbPSHVYb",
  "buyerOpenId": "yMShk1qkg5ugannb7b85dw"
}

{
    "status": 0,
    "msg": "成功",
    "data": null
}

# 2.2 下单支付接口

# 接口说明

名称	描述
功能	美团企业版交易平台向第三方平台发起下单支付，获得三方支付返回支付流水号
HTTP方法	POST, `application/x-www-form-urlencoded`
请求方	美团企业版平台
响应方	第三方平台
url	第三方平台提供
method	trade.outer.pay

# 业务参数

名称	类型	是否必填	示例	说明
tradeNo	String	是	393033370136698	交易号，唯一标示一次下单请求
sqtBizOrderId	String	是	393354663256156	美团企业版订单ID
tradeAmount	String	是	12.32	支付金额，单位元，两位小数
goodsName	String	是	测试产品	商品名称
tradeTime	String	是	2018-10-10 12:12:34	交易时间，格式yyyy-MM-dd hh:mm:ss
entId	Long	是	27829	企业id
staffId	Long	是	123456	员工id
businessType	Integer	是	1	业务类型（见下表）
extInfoMap	Map<String,String>	否		三方定制额外参数，需要双方协商确定

businessType	说明
1	买单
2	预定
3	团购
4	外卖
5	打车
10	酒店
11	门票
12	机票
13	火车票
14	电影票
15	扫码付
16	线下买单
-1	其他

# 业务响应

名称	类型	是否非空	说明
thirdPayOrderId	String	是	第三方平台支付订单号

# 示例结果

{
  "tradeNo": "393354663735396",
  "sqtBizOrderId": "393354663256156",
  "tradeAmount": "1",
  "goodsName": "美团点评订单-393354663256156",
  "tradeTime": "2019-01-16 12:04:13",
  "entId": 12345,
  "businessType": 4,
  "staffId": 123456
}

{
    "status": 0,
    "msg": "成功",
    "data": {
        "thirdPayOrderId": "393354663256156_3VFKMYDWM4"
    }
}

# 2.3 退款接口

# 接口说明

名称	描述
功能	美团企业版调用本接口向第三方支付平台退款，第三方支付平台返回退款流水号
HTTP方法	POST, `application/x-www-form-urlencoded`
请求方	美团企业版平台
响应方	第三方平台
url	第三方平台提供
method	trade.outer.refund

# 业务参数

名称	类型	是否必填	示例	说明
tradeNo	String	是	393354663735396	交易号，唯一标示一次下单请求。第三方平台需要根据此流水号判断退款幂等性。
refundTradeNo	String	是	393033370136698	退款交易号，唯一标识一次退款请求。第三方平台需要根据此流水号判断退款幂等性。
sqtBizOrderId	String	是	393354663256156	美团企业版订单ID，请求下单时传入
refundAmount	String	是	12.32	退款金额，单位元，两位小数。`订单可能多次退款，单次退款金额可能小订单金额，需要第三方平台支持部分退款。`
thirdPayOrderId	String	是	393354663256156_3VFKMYDWM4	第三方支付交易号
tradeTime	String	是	2018-10-10 14:32:34	退款请求时间，格式yyyy-MM-dd hh:mm:ss

# 业务响应

名称	类型	是否必填	示例	说明
thirdRefundOrderId	String	是	1547608646457	第三方平台退款订单号。返回此单号，表示第三方平台受理退款成功，美团企业版将会执行退款流程，所以需要第三方平台保证退款的最终一致性。

# 示例结果

{
  "tradeNo": "393354663735396",
  "refundTradeNo": "393356317724752",
  "sqtBizOrderId": "393354663256156",
  "refundAmount": "1",
  "thirdPayOrderId": "393354663256156_3VFKMYDWM4",
  "tradeTime": "2019-01-10 20:35:41"
}

{
    "status": 0,
    "msg": "成功",
    "data": {
        "thirdRefundOrderId": "1547608646457"
    }
}

# 2.4 支付状态查询接口

# 接口说明

名称	描述
功能	美团企业版平台查询订单的支付状态
HTTP方法	POST
请求方	美团企业版平台
响应方	第三方渠道
uri	第三方渠道提供
method	trade.outer.pay.query

# 业务参数

名称	类型	是否必填	示例	说明
tradeNo	String	是	393354663735396	交易号，请求下单时传入

# 业务响应

名称	类型	是否非空	说明
tradeNo	String	是	交易号，请求下单时传入
thirdPayOrderId	String	是	第三方交易流水号
payStatus	Integer	是	支付状态 0 待支付 1 支付成功 2 支付失败
payTime	String	是	支付完成时间，yyyy-MM-dd HH:mm:ss
payAmount	String	是	支付金额，单位元

# 示例结果

{
  "tradeNo": "393354663735396"
}

{
    "status": 0,
    "msg": "成功",
    "data": {
        "tradeNo": "393354663256156",
        "thirdPayOrderId": "393354663256156_3VFKMYDWM4",
        "payStatus": 2,
        "payAmount": "1.00",
        "payTime": "2019-01-10 20:35:41"
    }
}

# 3. 【接口测试】

# 注意事项

如果第三方平台有网络限制，请将下表的ip地址加入白名单。
如果第三方平台提供的支付接口和退款接口的端口不在25, 80, 110, 143, 443, 8080, 587范围内，请联系美团企业版交易平台的研发人员开通白名单。

# IP地址

103.37.142.38
103.37.142.26
103.37.142.42
103.37.142.70
101.236.11.50
101.236.11.51
101.236.11.52
101.236.11.53
101.236.11.54
101.236.11.55
101.236.11.56
101.236.11.57