robas/tf-utils

Utilities to help with CTF and ITF files

TF Utils

Misc tools to help with CTF, ITF and Bundle files.

Intro

Ctfxtract script allows the extraction of specific fields from specific TCs in CTF/ITF/Bundle files.

TF Tools currently supports:

• Parsing of CTF, ITF and Bundle files
• Extraction of CLI specified fields to a .csv file

Usage

usage: ctfxtract.py [-h] -f FILENAME -tc TC -fields FIELDS

optional arguments:
  -h, --help            show this help message and exit

  -f FILENAME, --file FILENAME
                        Input CTF/ITF/Bundle file to be processed
  -tc TC, --transactioncode TC
                        Target transaction code (TC) to filter for
  -fields FIELDS, --fields FIELDS
                        Fields name to filter

Note: In order to be able to directly execute the file with ./ctfxtract.py instead of python ctfxtract.py, it is necessary to allow the file execution with:

chmod +x ctfxtract.py

Examples

./ctfxtract.py -f "FILENAME.ITF" -tc 05 -fields "Acquirer Reference Number,Merchant Category Code,Merchant City,Source Amount,Source Currency Code"

./ctfxtract.py -f files/TEST.ITF -tc 20 -fields "Transaction Identifier, Source Amount,Reason Code, Country Code,Event Date (MMDD),Message Text"

utils/pdf2dict.sh

The mappings.py file was generated with the help of pdf2dict.sh script. The script generates python dictionary entries directly from copy and paste of Visa pdf table contents.

1. Paste the Visa pdf table content and save it to a file.
2. Execute ./pdf2dict.sh /path/to/filename.
3. Pdf2dict script will generate a /path/to/filename.csv with the resulting dictionary entries.

tf-utils's Issues

Add TC33 VCR layout

Add the VCR layout TCR0 and TCR1 to the parsing engine.

TC33 TCR1 processing not aware of TC33 type

TC33 is a multipurpose TC, for example CAS and VCR.
There is an indicator of the TC33 type in its TCR0, but when it comes to TCR1 there is no such indicator.