Get Card Transaction Records

Brief Description

Retrieve card transaction records (spending/authorization/settlement, etc.), returned in paginated form

Request URL

/open/api/card/trade/list

Request Method

POST

Parameters

Parameter Name	Required	Type	Description
cardId	Yes	string	Card ID (length 1~64)
current	No	int	Current page number, default 1
size	No	int	Number of records per page, default 10

Request Example

{
  "cardId": "c_XXXXXX",
  "current": 1,
  "size": 10
}

Return Parameter Description

Parameter Name	Type	Description
model	object	Returns data object data
└total	int	Total number of records
└current	int	Current page number
└size	int	Number of records per page
└records	array	List of transaction records
└└transactionId	string	Transaction ID (unique to the channel)
└└cardId	string	Card ID
└└cardLast4	string	Last 4 digits of card number
└└type	string	Transaction type, such as PURCHASE (purchase), REFUND (refund), etc.
└└status	string	Transaction status, such as APPROVED (success), DECLINED (rejection)
└└amount	string	Transaction amount (original amount in transaction currency)
└└currency	string	Transaction currency, such as USD
└└billingAmount	string	Amount received (settlement/posting currency)
└└billingCurrency	string	Currency received
└└transactionFee	string	Transaction fee (PGC exclusive)
└└transactionFeeCurrency	string	Transaction fee currency (PGC exclusive)
└└desp	string	Transaction description (e.g., merchant name, text mapping already done)
└└tradeAt	long	Transaction time (millisecond timestamp)

Transaction Type Enumeration (type)

Transaction Type	Description
AUTHORIZATION	Transaction Authorization: The card issuer approves a transaction initiated by the cardholder, typically for standard purchases or transactions. ATM withdrawals also fall under this type (distinction made via Merchant Category Code - MCC).
REVERSAL	Transaction Reversal: A previous transaction is canceled or revoked (e.g., due to fraud, operational errors, or transaction cancellation), and funds are returned to the cardholder's account.
REFUND	Transaction Refund: The cardholder returns purchased goods or services, and the merchant refunds the amount back to the cardholder's account.
SETTLEMENT.CREDIT	Settlement Credit: The settlement amount is lower than the original transaction amount, and the difference is credited to the cardholder's account.
SETTLEMENT.DEBIT	Settlement Debit: The settlement amount is higher than the original transaction amount, and the difference is debited from the cardholder's account.
SETTLEMENT.REVERSAL	Settlement Reversal: A previous settlement transaction is revoked due to an error, and funds are returned to the cardholder.
FUND.COLLECTION	Fund Collection: The cardholder's card account receives funds from an external source (reported and routed by the card network), distinct from cardholder-initiated card top-ups or issuer balance reloads.
VALIDATION	Transaction Validation: Verifies the validity of the card, confirming cardholder information is correct and the card is activated. Usually executed alongside the authorization flow.
ATM.DEPOSIT	ATM Deposit
CHARGEBACK.CREDIT	Chargeback Credit: A chargeback refund has been processed.
CHARGEBACK.DEBIT	Chargeback Debit: A chargeback debit has been processed.
FINE	Fine

Return Example

{
  "success": true,
  "error": false,
  "msg": "Success",
  "code": 0,
  "model": {
    "total": 1,
    "current": 1,
    "size": 10,
    "records": [
      {
        "transactionId": "XXXX",
        "cardId": "c_XXXX",
        "cardLast4": "XXXX",
        "type": "PURCHASE",
        "status": "APPROVED",
        "amount": "3.00",
        "currency": "USD",
        "billingAmount": "3.00",
        "billingCurrency": "USD",
        "transactionFee": "0.00",
        "transactionFeeCurrency": "USD",
        "desp": "AMAZON.COM",
        "tradeAt": 1748390400000
      }
    ]
  },
  "traceId": 1646651433202
}

Remarks

Transaction records are returned in reverse chronological order.
When a card has no transaction records, records returns an empty array, and total is 0.