Card Transaction Reports

Branch can send you a data file detailing card transactions for a specified time period. Branch sends the file daily by default, but you can choose to receive it less frequently.

File Type

\[file type}\_file_YYYYMMDD_YYYYMMDD_YYYYMMDDhhmmss.csv

1st YYYYMMDD is start date of file (>=)

2nd YYYYMMDD is end date of file (\<)

YYYYMMDDhhmmss is when file was pulled

start and end date will be filled with 00000000 for historic pull
FieldFormatDate Filter FieldDescriptionNullablePrimary Key
event_timestampTIMESTAMPYThe timestamp (UTC) when a transaction occured or cleared. cleared transactions will occur in bulk batch processesN
event_tokenSTRINGNY
initiating_event_idSTRINGInitiating transaction id to link auths (initiating) to clearings, auths (initiating) to cash back and backup balance (initiating) to repayment. For auths that include multiple events (i.e.auth advice), the initiating transaction is the same and event_timestamp can be used to determine the order of the events. NOTE: returns/refunds DO NOT map to their originating authorization. The network does not provide this information.Y
event_typeSTRINGLabel of overal "swipe" of card, either 'Signature', 'Pindebit' or 'Load'
-- Authorizations do NOT impact users balance
Y
event_subtypeSTRINGBranch categorization of transaction: Authorization, Clearing or type of Load (Reward, Cashback, Disbursement)N
kpiSTRINGBranch categorization of transaction:
ACH_Transfer,
ATM_In_Network,
ATM_Out_Network,
Card_Spend,
Instant_Transfer,
Non_Payout_Deposits,
Reversals_and_Refunds
N
transaction_typeSTRINGRaw transaction label from marqetaN
card_typeSTRINGLabels a card as physical or virtualY
card_productSTRINGLabels a unqiue card product, if multiple exist within a given card programY
merchantSTRINGClean merchant nameY
merchant_category_codeSTRING4-digit value used to classify businesses into market segmentsY
merchant_category _code_groupSTRINGHigh-level group labeling used in classifying businesses into market segmentsY
merchant_category _code_descriptionSTRINGA more granular labeling used in classifying businesses into market segmentsY
balance_impactSTRINGC or D if it is credit then amount should be multiplied by a (+) if debit then multipled by a (-)
NB for non-balance
Y
amountINTEGERAlways positive, amount is in cents (no decimals)N
transaction_feeINTEGERAlways positive, amount is in cents (no decimals) - fees charged to the user in certain transaction typesY