Query a Statement

Query the full details of a single reconciliation statement by its ID. Returns the complete Statement structure including fund flow details, exchange rate, goods info, and related transactions.
Request Parameters
idstring
required
Unique statement identifier returned by List Statements.
Response Parameters
resultResult
See Result.
idstring
Unique statement identifier.
transactionIdstring
Transaction unique ID defined by WorldFirst. Shared across related statement entries from the same transaction.
externalTransactionIdstring
Transaction unique ID defined by the integrator. Returned when the transaction was initiated by the integrator (e.g., a transfer).
transactionTypestring
Transaction type. See TransactionType.
statusstring
Statement status. See StatementStatus.
failureCodestring
Failure reason code. Returned when status is FAIL. See FailureCode.
failureMessagestring
Failure reason description. Returned when status is FAIL.
transactionAmountAmount
Transaction amount. Positive for incoming funds, negative for outgoing. See Data Types.
originalTransactionAmountAmount
Original transaction amount before fees. See Data Types.
feeAmountAmount
Fee charged by WorldFirst. See Data Types.
netAmountAmount
Net amount after fees. See Data Types.
discountFeeAmountAmount
Service fee discount amount. See Data Types.
originalFeeAmountAmount
Original service fee before discount. Equals feeAmount + discountFeeAmount. See Data Types.
platformFeeAmountAmount
Third-party platform service fee. See Data Types.
receiveAmountAmount
Received amount after currency conversion. See Data Types.
balanceAmountAmount
Account balance after the transaction. See Data Types.
balanceTypestring
Balance type. See BalanceType.
feeItemTypestring
Fee item type. Returned when transactionType is CHARGE.

Valid Values:

OBO_SERVICE_FEE — On-Behalf-Of service fee.
REMIT_SERVICE_FEE — Remittance base service fee.
exchangeRateExchangeRate
Exchange rate information. Returned when the transaction involves currency conversion.
Show child parametersShow child parameters
fundFlowDetailFundFlowDetail
Fund flow details including payer and beneficiary information.
Show child parametersShow child parameters
goodsInfoGoodsInfo
Goods information. Returned when the transaction involves customs declaration.
Show child parametersShow child parameters
combinedTransactionsarray
Related transactions. Returned when the transaction has associated entries (e.g., a transfer and its fee charge).
Show child parametersShow child parameters
referencestring
Channel reference message passed to the beneficiary.
descriptionstring
User-provided transaction description.
transactedAtdatetime
Transaction timestamp, following the ISO 8601 standard. See Data Types.
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSSuccessN/A
CURRENCY_NOT_SUPPORTEDFThe currency is not supported.Check if the transaction currency is supported for the merchant.
ACCESS_TOKEN_EXPIREDFThe access token expired.Refresh the OAuth access token and retry.
Definition
POST /api/open/v1/statements/query
Request
{
"id": "STM202604180000****"
}
Response
{
"result": {
  "resultStatus": "S",
  "resultCode": "SUCCESS",
  "resultMessage": "success"
},
"id": "STM202604180000****",
"transactionId": "TXN202604180000****",
"externalTransactionId": "EXT-ORD-2026-****",
"transactionType": "TRANSFER",
"status": "SUCCESS",
"transactionAmount": {
  "value": -250000,
  "currency": "GBP"
},
"originalTransactionAmount": {
  "value": 260000,
  "currency": "GBP"
},
"feeAmount": {
  "value": 10000,
  "currency": "GBP"
},
"netAmount": {
  "value": 250000,
  "currency": "GBP"
},
"discountFeeAmount": {
  "value": 500,
  "currency": "GBP"
},
"originalFeeAmount": {
  "value": 10500,
  "currency": "GBP"
},
"receiveAmount": {
  "value": 2125000,
  "currency": "CNY"
},
"balanceAmount": {
  "value": 1820030,
  "currency": "GBP"
},
"balanceType": "NORMAL_BALANCE",
"exchangeRate": {
  "sellCurrency": "GBP",
  "buyCurrency": "CNY",
  "rate": "8.5000"
},
"fundFlowDetail": {
  "payerInfo": {
    "payerUserId": "****",
    "name": "Acme Corp ****",
    "accountNo": "****5678",
    "accountType": "BANK_ACCOUNT",
    "bankName": "Barclays Bank"
  },
  "beneficiaryInfo": {
    "name": "Global Trade Inc.",
    "accountNo": "****1234",
    "accountType": "BANK_ACCOUNT",
    "bankRegion": "CN",
    "bankName": "Bank of China",
    "storeName": "**** Store",
    "marketplaceName": "**** Marketplace",
    "receiveAccount": "****5678"
  },
  "paymentExplanation": "Goods payment",
  "paymentSubject": "Goods Payment",
  "paymentVoucherNo": "VCH-2026-****"
},
"combinedTransactions": [
  {
    "transactionAmount": {
      "value": -10000,
      "currency": "GBP"
    },
    "transactedAt": "2026-04-18T09:15:01+08:00",
    "transactionId": "TXN202604180001****",
    "transactionType": "CHARGE",
    "status": "SUCCESS"
  }
],
"reference": "Payment for PO-****",
"description": "Cross-border trade payment",
"transactedAt": "2026-04-18T09:15:00+08:00"
}