Onerway
POST

Query account transactions by transaction order number

Restricted
View as Markdown
Use this endpoint when you already have transaction order numbers and need to retrieve the related account transaction records.
Restricted access
Access to the Account service APIs is enabled by Onerway approval.

Request

apikeystringrequired
Account service API key request header assigned by Onerway. Use the value for the same environment as the request base URL.
Example:replace_with_account_service_apikey
x-timestampstringrequired
Request timestamp. The gateway uses it to identify replay attempts.
Example:1776931200
Constraints
Rule
The timestamp must be within 10 minutes of the server time. Both 10-digit seconds and 13-digit milliseconds are accepted.
requestIdstringrequired
Request ID used for idempotency control and request tracing.
Example:REQ-TRX-20260423-0002
onBehalfOfstringoptional
Sub-merchant number when a platform merchant queries on behalf of its sub-merchant. The caller merchant from apikey must be the parent merchant.
Example:replace_with_sub_merchant_no
serviceIdsarray<integer>required
Transaction order numbers used to locate associated balance change records.
Example:[20001,20002,20003]
Constraints
Range
1100itemsThe list cannot be empty and can contain at most 100 transaction order numbers.

Request example

curl -X POST 'https://sandbox-api.onerway.com/account-server/api/v2/account/transactions/service/query' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "requestId": "REQ-TRX-20260423-0002",
  "serviceIds": [
    20001,
    20002,
    20003
  ]
}'

Response

respCodestring
Standardized response code. 20000 indicates a successful response.
respMsgstring
Human-readable response message aligned with respCode.
Account transactions payload matched by serviceIds[].
Standardized error object. It is null for successful responses and omitted from the JSON body.

Response example

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "list": [
      {
        "acntTxnId": 10001,
        "serviceId": 20001,
        "currency": "USD",
        "balanceType": "PAYMENT",
        "amount": "-100.00",
        "balanceUpdDate": "2026-04-20T10:30:00Z",
        "businessType": "PAYOUT",
        "externalOrderId": "replace_with_external_order_id",
        "remark": "Payout to bank account"
      },
      {
        "acntTxnId": 10002,
        "serviceId": 20002,
        "currency": "USD",
        "balanceType": "PAYMENT",
        "amount": "500.00",
        "balanceUpdDate": "2026-04-19T08:15:00Z",
        "businessType": "ACQUIRING",
        "externalOrderId": "replace_with_external_order_id",
        "remark": "Payment received"
      }
    ]
  }
}
No error responses are documented for this endpoint.

Query account balance movements

Query balance movement records for the caller merchant account or a specified sub-merchant account.

Query account balance

Query the account balance details for a single currency.