# 企业账户接口

# 2.1 账户查询

# 接口说明

名称 描述
功能 查询企业账户信息
HTTP方法 POST
请求方 第三方平台
响应方 美团企业版平台
uri $API_HOST/accountQuery
method trade.account.query

# 公共请求参数

详见:公共参数说明-公共请求参数

# 业务请求参数

无,直接根据通用参数里的entId查询属于该企业的账户信息,企业账户支持配置多个。

# 业务响应

名称 类型 是否非空 说明
accountList List<AccountInfoListItem>

AccountInfoListItem字段说明

名称 类型 是否非空 示例 说明
accountId Long 账户id
availableBalance String 账户可用余额,单位元,两位小数

# 响应示例

{
    "status": 0,
    "msg": "成功",
    "data": {
        "accountList": [
              {
                "accountId": 1223442313123,
                "availableBalance": "123.12"
              }
          ]
    }
}

# 2.2 账户流水查询

# 接口说明

名称 描述
功能 查询企业账户流水信息
HTTP方法 POST
请求方 第三方平台
响应方 美团企业版平台
uri $API_HOST/accountTraceQuery
method trade.account.trace.query

# 公共请求参数

详见:公共参数说明-公共请求参数

# 业务请求参数

名称 类型 是否必填 示例 说明
pageSize Integer 20 每页条数:默认20,每页条数不大于50
pageNum Integer 1 当前页码:默认1
traceStartTime Long 1569859200000 流水开始时间 格式13位时间戳
traceEndTime Long 1569859200000 流水结束时间 格式13位时间戳
transactionType Integer 1 流水类型 1支付,2退款 不传则两种类型都返回

# 业务响应

名称 类型 是否非空 示例 说明
pageSize Integer 每页条数
pageNum Integer 当前页数
totalCount Long 总条数
result List<AccountTraceListItem> 账户流水列表

AccountTraceListItem字段说明

名称 类型 是否非空 示例 说明
accountId Long 314442083816943618 账户id
transactionType Integer 1 流水类型 1支付,2退款
payChannelType Integer 10 支付渠道类型 10企业,20个人
transactionAmount String 25.00 交易金额,单位元
origOrderId String 437572857384757 业务原始订单ID
paySerialNum String 3NOQUINBUIGX 支付序列号
transactionNo String 651380335439947-651380335464548 流水号
staffId Long 23456 美团企业版员工id
staffName String 张三 员工姓名
traceTime String 2021-01-14 14:33:28 流水时间 格式yyyy-MM-dd HH:mm:ss

# 响应示例

{
    "status": 0,
    "msg": null,
    "data": {
        "pageSize": 5,
        "pageNum": 1,
        "totalCount": 41,
        "result": [
            {
                "accountId": 448599838013374,
                "transactionType": 1,
                "payChannelType": 10,
                "transactionAmount": "135.0",
                "origOrderId": "1610104024960001",
                "paySerialNum": "3N40WH8HG5C2",
                "transactionNo": "649324344963498-1347500173946597378",
                "staffId": 389991,
                "staffName": "张三",
                "traceTime": "2021-01-08 19:07:31"
            },
            {
                "accountId": 448599838013374,
                "transactionType": 1,
                "payChannelType": 10,
                "transactionAmount": "144.5",
                "origOrderId": "1610107026960001",
                "paySerialNum": "3N45DWWAAAYQ",
                "transactionNo": "649336698708357-1347512824122650626",
                "staffId": 389991,
                "staffName": "李四",
                "traceTime": "2021-01-08 19:57:47"
            },
            {
                "accountId": 448599838013374,
                "transactionType": 1,
                "payChannelType": 10,
                "transactionAmount": "632.0",
                "origOrderId": "11921011110273838592685",
                "paySerialNum": "3NDFWY1NP1Q9",
                "transactionNo": "650258322634377-1348456567696617473",
                "staffId": 205368,
                "staffName": "王五",
                "traceTime": "2021-01-11 10:27:53"
            },
            {
                "accountId": 448599838013374,
                "transactionType": 1,
                "payChannelType": 10,
                "transactionAmount": "3910.0",
                "origOrderId": "11921011115464774590639",
                "paySerialNum": "3NE8DE4JBQWX",
                "transactionNo": "650336720226498-1348536846184443906",
                "staffId": 205368,
                "staffName": "马六",
                "traceTime": "2021-01-11 15:46:53"
            },
            {
                "accountId": 448599838013374,
                "transactionType": 1,
                "payChannelType": 10,
                "transactionAmount": "1058.0",
                "origOrderId": "11921011110273838592685",
                "paySerialNum": "3NEGI7S0E802",
                "transactionNo": "650359129221341-1348559793003524098",
                "staffId": 205368,
                "staffName": "张七",
                "traceTime": "2021-01-11 17:18:04"
            }
        ]
    }
}

上次更新: 4/22/2024, 4:15:08 PM