Card transactions

List a card's activity: purchases, refunds, reversals, fees, loads (deposits) and withdrawals.

List transactions

GET/api/v2/cards/{cardId}/transactionsBearer agent-vc

curl -G https://agentcard.fluxapay.xyz/api/v2/cards/card_7Hq2LmX9pRt4/transactions \
  -H "Authorization: Bearer $AGENT_VC" \
  --data-urlencode "type=purchase" \
  --data-urlencode "pageSize=10"

CLI:

fluxa-wallet card transactions --id card_7Hq2LmX9pRt4 --type purchase --limit 10

Query parameters

Parameter	Type	Default	Description
pageNum	integer	1	Page number, starting at 1.
pageSize	integer	20	Items per page, max 50.
type	string	all	One of purchase, refund, verification, reversal, fee, deposit, withdrawal.
startTime	integer	—	Only items at or after this time (Unix milliseconds).
endTime	integer	—	Only items at or before this time (Unix milliseconds).

Response

{
  "transactions": [
    {
      "transactionId": "…",
      "relatedTransactionId": null,
      "type": "purchase",
      "status": "settled",
      "amount": "12.60",
      "currency": "USD",
      "merchantAmount": "11.50",
      "merchantCurrency": "EUR",
      "fee": "0.00",
      "crossBorderFee": "0.38",
      "merchant": { "name": "Example Store", "category": "5734", "country": "DE", "city": "Berlin" },
      "description": null,
      "time": "2026-10-27T13:20:11.000Z"
    },
    {
      "transactionId": "funding:2b0f8a3e-5c1d-4f7a-9e2b-6d4c8a1f0e37",
      "relatedTransactionId": null,
      "type": "deposit",
      "status": "settled",
      "amount": "25.00",
      "currency": "USD",
      "merchantAmount": null,
      "merchantCurrency": null,
      "fee": "1.00",
      "crossBorderFee": null,
      "merchant": null,
      "description": "Initial card load",
      "time": "2026-10-27T10:01:00.000Z"
    }
  ],
  "pageNum": 1,
  "pageSize": 20,
  "total": 2
}

Field	Description
transactionId	Transaction ID.
relatedTransactionId	For refunds and reversals, the original transaction.
type	purchase, refund, verification (zero/low-value card check by a merchant), reversal, fee, deposit (initial load or top-up), withdrawal.
status	See below.
amount, currency	Amount charged to the card, in the card currency.
merchantAmount, merchantCurrency	Amount in the merchant's currency, when different.
fee, crossBorderFee	Fees on this transaction, when applicable.
merchant	name, category (merchant category code), country, city, when known.
description	Short description, when available.
time	ISO 8601 timestamp.

Results are sorted newest first.

Transaction statuses

status	Meaning
authorized	Approved by the card, not yet settled. The amount is held.
pending	In progress (for example, a withdrawal still being transferred).
settled	Final.
failed	Declined or did not complete.
reversed	Undone; the amount was returned to the card.

Errors

Status	code	What to do
400	invalid_transaction_type	Use one of the listed type values.
404	card_not_found	Check the card ID.