Skip to main content


Card transaction

type CardTransaction implements Transaction {
id: ID!
reference: String!
paymentMethodIdentifier: String!
side: TransactionSide!
type: TransactionTypeEnum!
amount: Amount!
label: String!
statusInfo: TransactionStatusInfo!
paymentId: String
payment: Payment
createdAt: DateTime!
updatedAt: DateTime!
counterparty: String!
bookedBalanceAfter: Amount
paymentProduct: PaymentProduct!
maskedPan: String!
cardId: String!
card: Card!
terminalId: String!
originalAmount: Amount!
currencyExchange: [ReportExchangeRate!]!
merchantId: String!
merchantName: String!
merchantCity: String!
merchantCountry: CCA3
merchantPostalCode: String
merchantCategoryCode: String!
merchantCategoryDescription: MerchantCategoryDescription!
category: Category!
authorizationType: AuthorizationType
account: Account
externalReference: String
executionDate: DateTime!
requestedExecutionAt: DateTime
originTransactionId: String
originTransaction: Transaction

Fields ● ID! non-null scalar

unique identifier of the transaction

CardTransaction.reference ● String! non-null scalar

external identifier of the transaction

CardTransaction.paymentMethodIdentifier ● String! non-null scalar

payment method identifier used for this transaction. e.g masked PAN or IBAN or accountNumber

CardTransaction.side ● TransactionSide! non-null enum

side (Credit or Debit)

CardTransaction.type ● TransactionTypeEnum! non-null enum


CardTransaction.amount ● Amount! non-null object


CardTransaction.label ● String! non-null scalar


CardTransaction.statusInfo ● TransactionStatusInfo! non-null interface

status information

CardTransaction.paymentId ● String scalar

ID of the payment associated to this transaction

CardTransaction.payment ● Payment object

payment associated to this transaction

CardTransaction.createdAt ● DateTime! non-null scalar

created date

CardTransaction.updatedAt ● DateTime! non-null scalar

updated date

CardTransaction.counterparty ● String! non-null scalar

name of the counterparty. e.g Merchant name, Creditor name, Beneficiary Name ...

CardTransaction.bookedBalanceAfter ● Amount object

booked balance after this transaction

CardTransaction.paymentProduct ● PaymentProduct! non-null enum

payment product used for this transaction

CardTransaction.maskedPan ● String! non-null scalar

card numbers masked (Primary Account Number)

CardTransaction.cardId ● String! non-null scalar

unique identifier of the card

CardTransaction.card ● Card! non-null object

card used for this transaction

CardTransaction.terminalId ● String! non-null scalar

unique identifier of the terminal

CardTransaction.originalAmount ● Amount! non-null object

original amount and currency of the transaction

CardTransaction.currencyExchange ● [ReportExchangeRate!]! non-null object

currency exchange if any

CardTransaction.merchantId ● String! non-null scalar

unique identifier of the merchant

CardTransaction.merchantName ● String! non-null scalar

merchant name

CardTransaction.merchantCity ● String! non-null scalar

merchant city

CardTransaction.merchantCountry ● CCA3 scalar

merchant country

CardTransaction.merchantPostalCode ● String scalar

merchant postal code

CardTransaction.merchantCategoryCode ● String! non-null scalar

merchant category code (MCC)

CardTransaction.merchantCategoryDescription ● MerchantCategoryDescription! non-null enum

merchant category description Enum that explains what the MCC corresponds to in a more readable way

CardTransaction.category ● Category! non-null enum

category of the payment flow

CardTransaction.authorizationType ● AuthorizationType enum

type of the authorization. Only available for:

  • authorization transaction
  • debit transaction linked to a previous authorization transaction

CardTransaction.account ● Account object

matching account for the transaction

CardTransaction.externalReference ● String scalar

an arbitrary identifier that was defined by you when you created this transaction.

For example, you can define it in the CreditTransferInput mutation.

CardTransaction.executionDate ● DateTime! non-null scalar

a date that reflects the execution date of a transaction from a user viewpoint. Can be used for sorting transactions.

CardTransaction.requestedExecutionAt ● DateTime scalar

a date that reflects the time at which the user asked the transaction to be executed

CardTransaction.originTransactionId ● String scalar

ID of the origin transaction associated to this transaction

CardTransaction.originTransaction ● Transaction interface

origin transaction associated to this transaction


Transaction interface