Transactions

Transaction record query API with filtering by transaction type, status, and time range.

Query Transaction Records

Paginated query of merchant transaction records, filterable by transaction type, status, and time range.

ItemDetails
EndpointPOST /api/v1/merchant/queryTxnList

Request Parameters

FieldTypeRequiredDescription

txnType

String(20)

—

Transaction type: AUTHORIZATION / REVERSAL / CLEARING / REFUND / VERIFICATION

txnStatus

String(20)

—

Push status: S Success / F Failed / P Processing

startTime

Long

—

Query start time, timestamp in seconds (UTC)

endTime

Long

—

Query end time, timestamp in seconds (UTC)

pageNum

Integer

✅

Page number, minimum 1

pageSize

Integer

✅

Page size, range 1–100

Request Example

{
  "txnType": "AUTHORIZATION",
  "pageNum": 1,
  "pageSize": 10
}

Response Parameters

FieldTypeDescription
respCodeStringResponse code
respMsgStringResponse message
dataObjectPaginated data
data.totalRecordsLongTotal records
data.pageSizeLongPage size
data.currentLongCurrent page (synonym of pageNum)
data.pageNumLongCurrent page number
data.totalPagesLongTotal pages
data.records[]ArrayTransaction record list for current page
data.records[].txnTypeStringTransaction type
data.records[].txnStatusStringTransaction status (F Failed / S Success / P Processing)
data.records[].txnOrderNoStringTransaction order number
data.records[].originTxnOrderNoStringOriginal transaction order number
data.records[].originTxnOrderNoForRefundStringOriginal payment order number for refund
data.records[].cardIdStringCard ID
data.records[].authTimeLongAuthorization time (timestamp, milliseconds)
data.records[].authorizationCodeStringAuthorization code
data.records[].authMessageDescStringAuthorization description
data.records[].transactionAmountBigDecimalTransaction amount
data.records[].transactionCurrencyStringTransaction currency
data.records[].transactionTimeLongTransaction time (timestamp, milliseconds)
data.records[].cardAmountBigDecimalCard amount
data.records[].cardCurrencyStringCard currency
data.records[].settleAmountBigDecimalSettlement amount
data.records[].settleCurrencyStringSettlement currency
data.records[].settleTimeLongSettlement time (timestamp, milliseconds)
data.records[].transactionFeeBigDecimalTransaction fee
data.records[].transactionFeeCurrencyStringTransaction fee currency
data.records[].crossBorderFeeBigDecimalCross-border fee
data.records[].crossBorderFeeCurrencyStringCross-border fee currency
data.records[].exchangeFeeBigDecimalExchange fee
data.records[].exchangeFeeCurrencyStringExchange fee currency
data.records[].merchantIdStringMerchant ID
data.records[].merchantNameStringMerchant name
data.records[].merchantCountryStringMerchant country
data.records[].merchantCountryCodeStringMerchant country code
data.records[].merchantStateProvinceStringMerchant state/province
data.records[].merchantCityStringMerchant city
data.records[].merchantPostalCodeStringMerchant postal code
data.records[].merchantMccCodeStringMerchant MCC code

Response Example

{
  "respCode": "20000",
  "respMsg": "success",
  "data": {
    "totalRecords": 1,
    "pageSize": 10,
    "current": 1,
    "pageNum": 1,
    "totalPages": 1,
    "records": [
      {
        "txnType": "CHARGE",
        "txnStatus": "S",
        "txnOrderNo": "TXN20260101001",
        "originTxnOrderNo": null,
        "originTxnOrderNoForRefund": null,
        "cardId": "411111******1111",
        "authTime": 1735689600000,
        "authorizationCode": "AUTH001",
        "authMessageDesc": "Approved",
        "transactionAmount": 50.00,
        "transactionCurrency": "USD",
        "transactionTime": 1735689600000,
        "cardAmount": 50.00,
        "cardCurrency": "USD",
        "settleAmount": 50.00,
        "settleCurrency": "USD",
        "settleTime": 1735776000000,
        "transactionFee": 0.50,
        "transactionFeeCurrency": "USD",
        "crossBorderFee": null,
        "crossBorderFeeCurrency": null,
        "exchangeFee": null,
        "exchangeFeeCurrency": null,
        "merchantId": "MCH001",
        "merchantName": "Amazon",
        "merchantCountry": "United States",
        "merchantCountryCode": "US",
        "merchantStateProvince": "WA",
        "merchantCity": "Seattle",
        "merchantPostalCode": "98101",
        "merchantMccCode": "5411"
      }
    ]
  }
}

Common

Common query APIs including region list, city list, and mobile area codes.

Webhooks

Card operation and transaction event webhook notifications with signature verification.