List card transactions
Purchases, refunds, reversals and issuer card fees on the merchant's cards, most recent first, with cursor pagination. Transactions follow the card issuer's notifications; they do not affect the merchant balance and do not appear in GET /transactions. For the card balance, see GET /cards/{cardId}.
The authorization, settlement, reversals, refunds and fees charged with one purchase are one transaction (one ctx_). Each update from the issuer has its own cte_ in events, and revision goes up by 1 each time an update changes the transaction.
merchantApiKeymerchantTimestampmerchantNoncemerchantSignatureX-API-KEY<token>Merchant API key (starts with upk_, also accepts api-key); signing headers are also required
X-Timestamp<token>Unix timestamp in seconds, within 300 seconds of server time
X-Nonce<token>Unique per request; cannot be reused with the same credential during the timestamp validity window
X-Signature<token>Hex HMAC-SHA256 signature (either letter case) of the method, full path, timestamp, nonce and body digest
card_id?stringOnly this card (starts with card_)
type?stringpurchase: purchaseverification: card verification (usually a zero-amount authorization)refund: refund (including returns, chargebacks and FX differences returned)reversal: authorization reversalmaintenance_fee: card maintenance fee charged by the issuertransaction_fee: per-transaction fee charged by the issuercross_border_fee: cross-border / FX feefx_adjustment: FX adjustment
"purchase""verification""refund""reversal""maintenance_fee""transaction_fee""cross_border_fee""fx_adjustment"status?stringpending: being processed by the issuerauthorized: authorized; the amount is held on the cardsettled: settled (fee transactions are settled once charged)reversed: authorization reversedrefunded: refunded (can be refunded several times; seerefunded_amountfor the total)declined: authorization declinedfailed: failed at the issuer
"pending""authorized""settled""reversed""refunded""declined""failed"occurred_from?stringOccurred at or after (ISO 8601)
date-timeoccurred_to?stringOccurred at or before (ISO 8601)
date-timelimit?integerPage size, 1 to 100, default 20
1 <= value <= 100cursor?stringnext_cursor from the previous page
Card transactions; next_cursor is null when there are no more
application/json- response
data*array<>next_cursor*string|nullcurl -X GET 'https://sandbox.getupp.net/api/v1/card-transactions'{ "data": [ { "id": "string", "card_id": "string", "original_transaction_id": "string", "type": "purchase", "status": "pending", "revision": 0, "transaction_amount": "string", "transaction_currency": "string", "billing_currency": "string", "authorized_amount": "string", "settled_amount": "string", "reversed_amount": "string", "refunded_amount": "string", "fee": "string", "merchant": { "name": "string", "category_code": "string", "country": "string", "city": "string" }, "authorization_code": "string", "wallet_type": "string", "description": "string", "events": [ { "id": "string", "type": "authorization", "status": "pending", "revision": 0, "transaction_amount": "string", "transaction_currency": "string", "billing_amount": "string", "billing_currency": "string", "fee": "string", "occurred_at": "2019-08-24T14:15:22Z" } ], "occurred_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ], "next_cursor": "string"}