Get card transaction details
GET/v1/cards/transactions/:id
Retrieves details for a specific card transaction by its ID.
Request
Path Parameters
The ID of the card transaction
Responses
- 200
- 400
- 403
- 404
Successfully retrieved card transaction.
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
data
object
Unique transaction ID (child ID)
Parent card transaction ID for grouping related events
Card ID (credit or debit)
Possible values: [CREDIT, DEBIT]
Type of card (CREDIT or DEBIT)
Possible values: [PRE_AUTHORIZATION, PRE_AUTH_COMPLETION, REVERSAL_ADVICE, PURCHASE, REFUND, CREDIT, BALANCE_INQUIRY, ACCOUNT_VERIFICATION]
Transaction type
Possible values: [CREDIT, DEBIT]
Transaction operation (CREDIT or DEBIT)
Possible values: [PENDING, COMPLETED, FAILED, CANCELLED, PROCESSED]
Transaction status (PENDING, COMPLETED, FAILED, CANCELLED)
Transaction amount
Asset acronym
amounts
object
Detailed amount breakdown with surcharge and fees
Transaction amount in major units
Transaction currency
Settlement amount (only present when different from transaction)
Settlement currency (only present when different from transaction currency)
Surcharge/ATM fee
Settlement conversion rate
fees
object[]
Fees from DE54 Additional Amounts (ATM fees, surcharges, interchange, network fees)
Fee type (e.g., ATM Fee, Surcharge, Network Fee)
Fee amount in major units
Fee currency code
Retrieval Reference Number (DE37)
merchant
object
Merchant data
Merchant name
Merchant Category Code (DE18)
Merchant city
Merchant state/province
Merchant country (ISO 3166-1 alpha-2)
Transaction timestamp
{
"traceId": "string",
"message": "string",
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"parentCardTransactionId": "987fcdeb-51a2-43b8-96cd-ba321f098765",
"cardId": "987fcdeb-51a2-43b8-96cd-ba321f098765",
"cardType": "CREDIT",
"type": "PRE_AUTHORIZATION",
"operation": "DEBIT",
"status": "COMPLETED",
"amount": 100.5,
"asset": "USD",
"amounts": {
"transaction": 53,
"transactionCurrency": "USD",
"settlement": 50.25,
"settlementCurrency": "EUR",
"surcharge": 3,
"settlementConversionRate": 1.0684,
"fees": [
{
"type": "ATM Fee",
"amount": 0.25,
"currency": "USD"
}
]
},
"retrievalReferenceNo": "601003824715",
"merchant": {
"name": "WHOLE FOODS MKT",
"mcc": "5411",
"city": "AUSTIN",
"state": "TX",
"country": "US"
},
"timestamp": "2024-07-29T15:51:28.071Z"
}
}
Invalid request payload. This can happen if required fields are missing or have invalid formats.
- application/json
- Schema
- Example (from schema)
Schema
{
"traceId": "string",
"message": "string"
}
The API key is invalid or the client does not have sufficient permissions.
- application/json
- Schema
- Example (from schema)
Schema
{
"traceId": "string",
"message": "string"
}
One of the specified resources was not found. Does not apply for empty result set.
- application/json
- Schema
- Example (from schema)
Schema
{
"traceId": "string",
"message": "string"
}