Account Transactions

The Account Transaction APIs retrieve merchant account balance movement records. You can query records by time range with pagination or look up related records by business service IDs.

Setup

Before calling account services, complete Account Service Setup.

Transactions Query

The Transactions Query API returns account transaction records for a specified currency and time range.

POST

Query Constraints

• endTime cannot be earlier than beginTime.
• The query time range cannot exceed 31 days.
• size is controlled by the server. Use current for pagination.

Request Parameters

Parameter	Type	Length	Required	Signed	Description
requestId	String	/	Yes	No	Unique request ID for idempotency and request tracing.
requestTime	Long	/	Yes	No	Request timestamp in milliseconds. The timestamp must be within 10 minutes of the server time.
currency	String	/	Yes	No	Currency code, for example USD or EUR.
beginTime	String	/	Yes	No	Query start time in UTC ISO-8601 format, for example 2026-04-01T00:00:00Z.
endTime	String	/	Yes	No	Query end time in UTC ISO-8601 format, for example 2026-04-30T23:59:59Z.
businessType	String	/	No	No	Business type filter. If omitted, all supported business types are returned.
current	Long	/	No	No	Current page number. Defaults to 1 when omitted.

Response

Name	Type	Description
code	String	Response code.
message	String	Response message.
data	Object	Paginated account transaction records.
└total	Long	Total number of records.
└size	Long	Page size returned by the server.
└current	Long	Current page number.
└records	Array	Account transaction record list.
└currency	String	Currency code.
└acntTxnId	Long	Account transaction ID.
└serviceId	Long	Business service ID.
└balanceUpdDate	String	Balance update time in UTC ISO-8601 format.
└amount	String	Signed transaction amount.
└remark	String	Transaction remark.
└businessType	String	Business type.

API Example

Request

{
  "requestId": "REQ-TRX-20260423-0001",
  "requestTime": 1776931200000,
  "currency": "USD",
  "beginTime": "2026-04-01T00:00:00Z",
  "endTime": "2026-04-23T23:59:59Z",
  "current": 1
}

Response

{
  "code": "200",
  "message": "success",
  "data": {
    "total": 50,
    "size": 20,
    "current": 1,
    "records": [
      {
        "currency": "USD",
        "acntTxnId": 10001,
        "serviceId": 20001,
        "balanceUpdDate": "2026-04-20T10:30:00Z",
        "amount": "-100.00",
        "remark": "Payout to bank account",
        "businessType": "PAYOUT"
      },
      {
        "currency": "USD",
        "acntTxnId": 10002,
        "serviceId": 20002,
        "balanceUpdDate": "2026-04-19T08:15:00Z",
        "amount": "500.00",
        "remark": "Payment received",
        "businessType": "PAYMENT"
      }
    ]
  }
}

Transactions by Service IDs

The Transactions by Service IDs API returns related account transaction records for a list of business service IDs.

POST

Query Constraints

• serviceIds cannot be empty.
• serviceIds can contain up to 100 items.

Request Parameters

Parameter	Type	Length	Required	Signed	Description
requestId	String	/	Yes	No	Unique request ID for idempotency and request tracing.
requestTime	Long	/	Yes	No	Request timestamp in milliseconds. The timestamp must be within 10 minutes of the server time.
serviceIds	Array	100	Yes	No	Business service ID list used to locate related account transaction records. Maximum 100 IDs.

Response

Name	Type	Description
code	String	Response code.
message	String	Response message.
data	Array	Account transaction record list.
└currency	String	Currency code.
└acntTxnId	Long	Account transaction ID.
└serviceId	Long	Business service ID.
└balanceUpdDate	String	Balance update time in UTC ISO-8601 format.
└amount	String	Signed transaction amount.
└remark	String	Transaction remark.
└businessType	String	Business type.

API Example

Request

{
  "requestId": "REQ-TRX-20260423-0002",
  "requestTime": 1776931200000,
  "serviceIds": [20001, 20002, 20003]
}

Response

{
  "code": "200",
  "message": "success",
  "data": [
    {
      "currency": "USD",
      "acntTxnId": 10001,
      "serviceId": 20001,
      "balanceUpdDate": "2026-04-20T10:30:00Z",
      "amount": "-100.00",
      "remark": "Payout to bank account",
      "businessType": "PAYOUT"
    },
    {
      "currency": "USD",
      "acntTxnId": 10002,
      "serviceId": 20002,
      "balanceUpdDate": "2026-04-19T08:15:00Z",
      "amount": "500.00",
      "remark": "Payment received",
      "businessType": "PAYMENT"
    }
  ]
}

Best Practices

1. Query with fixed time windows and pagination to avoid retrieving an oversized data range.
2. Store the mapping between serviceId and your business order, pay-in, or payout records for reconciliation.
3. Use the sign of amount to determine balance direction. Do not infer direction only from businessType.