账户期末余额

• Endpoint: POST /aggregate-pay/api/gateway/endDayAccountBalanceQuery
• Tags: 资金账户(新)

Description

查询资金账户的日终余额(只支持查UTC+0和UTC+8两个时区的期末)

Parameters

Field	In	Type	Required	Constraints	Description
Content-Type	header	string	Yes
sign	header	string	Yes		签名信息请参考技术文档

Parameter Examples

• Content-Type: "application/json"
• sign: "FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A=="

Request Body

Required

Content-Type: application/json

Field	Type	Required	Constraints	Description	Enum
version	string	Yes		当前值为：1.5
keyVersion	string	Yes		当前值为：1
requestTime	string	Yes		符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内
appId	string	Yes		PayerMax分配给商户应用的唯一标识,会员维度的集成appid
memberId	string	Yes
data	object	Yes
data.inquiryDate	string	Yes		账务日期,支持查询近90天
data.timezone	string	Yes		时区,只支持 CST和UTC CST:GMT+8:00 UTC:GMT+0:00
data.endDayAccountBalanceQueryReq	object	No
data.endDayAccountBalanceQueryReq.fundsAccountCurrencyList	array[string]	No		币种列表
data.endDayAccountBalanceQueryReq.fundsAccountNoList	array[string]	No		资金账号列表

Example

{
  "version": "1.5",
  "keyVersion": "1",
  "requestTime": "2025-12-03T21:15:13.712+08:00",
  "appId": "798b79c2e33a4d8e866410bf401551a7",
  "memberId": "20250619P01B00000075000002",
  "data": {
    "inquiryDate": "2025-10-20",
    "timezone": "UTC",
    "endDayAccountBalanceQueryReq": {
      "fundsAccountCurrencyList": [],
      "fundsAccountNoList": []
    }
  }
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
msg	string	Yes
code	string	Yes
data	object	Yes
data.acctTime	string	Yes		账务日期,格式:yyyy-MM-dd
data.timeZone	string	Yes		时区
data.endDayAccountBalanceInfoList	array[object]	Yes
data.endDayAccountBalanceInfoList[].inflowAmount	integer	Yes		流入金额
data.endDayAccountBalanceInfoList[].fundsAccountNo	string	Yes		资金账号
data.endDayAccountBalanceInfoList[].endBalance	integer	Yes		日终余额
data.endDayAccountBalanceInfoList[].initialBalance	integer	Yes		日初余额
data.endDayAccountBalanceInfoList[].currency	string	Yes		币种
data.endDayAccountBalanceInfoList[].outflowAmount	integer	Yes		流出金额

Response Example

{
  "msg": "",
  "code": "APPLY_SUCCESS",
  "data": {
    "acctTime": "2025-10-20",
    "timeZone": "UTC",
    "endDayAccountBalanceInfoList": [
      {
        "inflowAmount": 200,
        "fundsAccountNo": "123456",
        "endBalance": 300,
        "initialBalance": 100,
        "currency": "IDR",
        "outflowAmount": 0
      },
      {
        "inflowAmount": 400,
        "fundsAccountNo": "123456",
        "endBalance": 500,
        "initialBalance": 100,
        "currency": "CNY",
        "outflowAmount": 0
      },
      {
        "inflowAmount": 500,
        "fundsAccountNo": "123456",
        "endBalance": 600,
        "initialBalance": 100,
        "currency": "EUR",
        "outflowAmount": 0
      },
      {
        "inflowAmount": 300,
        "fundsAccountNo": "123456",
        "endBalance": 400,
        "initialBalance": 100,
        "currency": "SAR",
        "outflowAmount": 0
      },
      {
        "inflowAmount": 100,
        "fundsAccountNo": "123456",
        "endBalance": 200,
        "initialBalance": 100,
        "currency": "USD",
        "outflowAmount": 0
      }
    ]
  }
}