Balance Query

Query the merchant's available balance, frozen amount, and pending settlement amount.

POST/api/v2/account/balance

Use this endpoint to retrieve the current account balance snapshot for reconciliation.

Request Headers

x-access-keystringRequired

Merchant access identifier

signaturestringRequired

Request signature

Request Parameters

timestampstringRequired

Millisecond timestamp string

Response Parameters

messagestringReturned

Request result. success only means the current API call succeeded and should not be used as the final business result

codestringReturned

Business status code. 00000 means the request was accepted. Other 5-digit values indicate specific error reasons; refer to the error code page

timestampstringReturned

Timestamp, for example 1715941383720

successbooleanReturned

API call result

dataobjectReturned

Response object

data.usableBalancestringReturned

Merchant balance

data.frozenBalancestringReturned

Frozen amount

data.pendingBalancestringReturned

Pending settlement amount