Day end balance query

• Endpoint: POST /aggregate-pay/api/gateway/endDayAccountBalanceQuery
• Tags: Fund Account(New)

Description

returns the balance information under the specified date and time zone

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		Current value:1.5
keyVersion	string	Yes		Current value: 1
requestTime	string	Yes		compliant with rfc3339 specification, format: yyyy-MM-dd'T'HH:mm:ss.SSSXXX The time must be within two minutes of the current time
appId	string	Yes		The unique identifier assigned to the merchant app by PayerMax
memberId	string	Yes		the unique identifier generated when the merchant signs the contract with PayerMax
data	object	Yes
data.inquiryDate	string	Yes		Support query for nearly 90 days
data.timezone	string	Yes		Time zone is currently only supported (UTC, CST).Case-insensitive
data.endDayAccountBalanceQueryReq	object	Yes
data.endDayAccountBalanceQueryReq.fundsAccountCurrencyList	array[string]	No		3-digit currency code in accordance with ISO 4217 When no currency is specified, all currency will return.
data.endDayAccountBalanceQueryReq.fundsAccountNoList	array[string]	No		When no fundsAccountNo is specified, all fundsAccountNos will return

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		‘Success.’
code	string	Yes		‘APPLY_SUCCESS’ means success
data	object	Yes
data.acctTime	string	Yes		The time of the corresponding balance conforms to RFC3339 specification, format: yyyy-mm-dd’T’HH:mm:ss. SSSXXX
data.timeZone	string	Yes		Time zone is currently only supported (UTC, CST).Case-insensitive
data.endDayAccountBalanceInfoList	array[object]	Yes
data.endDayAccountBalanceInfoList[].inflowAmount	integer	Yes		Period outflow amount The amount of inflow during the day
data.endDayAccountBalanceInfoList[].fundsAccountNo	string	Yes		funds account number
data.endDayAccountBalanceInfoList[].endBalance	integer	Yes		Calculation Formula: endBalance = initalBalance + inflowAmount - outflowAmount
data.endDayAccountBalanceInfoList[].initialBalance	integer	Yes		Opening balance
data.endDayAccountBalanceInfoList[].currency	string	Yes		3-digit currency code in accordance with ISO 4217 When no currency is specified, all currencies with balances greater than 0 are returned
data.endDayAccountBalanceInfoList[].outflowAmount	integer	Yes		Period inflow amount The amount of outflow during the day

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
      }
    ]
  }
}