/transaction-sms-parser

Library to parse transactional SMS texts. Give structured information about transaction from the SMS notifications received when transacting from banks, cards, wallets etc.

Primary LanguageTypeScriptMIT LicenseMIT

Transaction SMS Parser

A library to parse transaction sms text to extract relevant information from it. A naive implementation using mostly regular expressions.

How to use

The main method to use be used is:

getTransactionInfo(message: string): ITransactionInfo

It takes sms text as input and will give an object of ITransactionInfo type

interface ITransactionInfo {
  account: IAccountInfo;
  transactionAmount: string | null;
  transactionType: 'debit' | 'credit' | null;
  balance: IBalance | null;
}

interface IBalance {
  available: string | null;
  outstanding: string | null;
}

interface IAccountInfo {
  type: IAccountType | null;
  number: string | null;
  name: string | null;
}

enum IAccountType {
  CARD = 'CARD',
  WALLET = 'WALLET',
  ACCOUNT = 'ACCOUNT',
}

Example

import { getTransactionInfo } from 'transaction-sms-parser';

const sms =
  'INR 2000 debited from A/c no. XX3423 on 05-02-19 07:27:11 IST at ECS PAY. Avl Bal- INR 2343.23.';

const transactionInfo = getTransactionInfo(sms);
//output
{
    account: {
        type: 'ACCOUNT',
        number: '3423',
        name: null,
    },
    transactionAmount: '2000.00',
    transactionType: 'debit',
    balance: { available: '2343.23', outstanding: null },
}

API Documentation generated by typedoc is hosted on gh-pages

Testing

How to unit test ?

Tested with the SMS text from following banks/cards/wallets:

Banks:

  • Axis
  • ICICI
  • Kotak
  • HDFC
  • Standard Charted
  • IDFC
  • Niyo global

Credit Cards:

  • HSBC
  • Citi Bank
  • Sodexo
  • ICICI
  • Uni Card
  • Indusind Bank
  • Slice

Wallets

  • Paytm
  • Amazon pay
  • Lazypay
  • Simpl