Click here to Skip to main content
12,892,796 members (56,300 online)
Click here to Skip to main content
Add your own
alternative version


14 bookmarked
Posted 3 May 2012


, 25 Mar 2013 BSD
Rate this:
Please Sign up or sign in to vote.
Implementation of ISO8583 in .NET


BIM-ISO8583.NET is a .NET library that allows developers to parse and create ISO8583 messages.

This library was released to help financial system developers to fully comply with ISO 8583 protocol's standard and make development fast and easy.


The program method and technique used in this library were developed by Bim Garcia. He aims to establish a significant contribution for the enhancement and advancement of the present technology specifically in the financial industry. 

Using the Library

Here's how to use the library:  

  1. Download full source code of library (click here to download)
  2. Use the codes below.

Create an ISO8583 message:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using BIM_ISO8583;

namespace Sample_ISO8583_Message_Builder
    class Program
        static void Main(string[] args)
            //1. Set/Define Data
            //Message Type Identifier (Financial Message Request)
            string MTI = "0200";
            //Primary Account No or Card No. [DE #2]
            string PAN ="60197105032103634";
            //Processing Code.[DE #3] (Purchase Transaction, Savings)
            string ProCode= "001000";
            //Transaction Amount.[DE #4] (X100) (ex: $150.75 = 15075 or
            // 000000015075)  or simply remove the decimal.
            string Amount ="15075";    
            //Transmission Date and Time.[DE #7] (format: MMDDhhmmss)
            string DateTime ="0429104720";
            //System Trace Audit No.[DE #11] (456 or 000456)
            string STAN ="456";
            //Terminal ID. [DE #41]    
            string TID="44449999";
            //Point of Service Entry Mode. [DE #22] (02 - Magnetic Stripe)
            string POSEM = "02";

            //2.Create an object BIM-ISO8583.ISO8583
            BIM_ISO8583.NET.ISO8583 iso8583 = new BIM_ISO8583.NET.ISO8583();

            //3. Create Arrays
            string[] DE = new string[130];

            //4. Assign corresponding data to each array
            //   Ex: ISO8583 Data Element No.2 (PAN) shall assign to newly created array, DE[2];

            DE[2] = PAN;
            DE[3] = ProCode;
            DE[4] = Amount;
            DE[7] = DateTime;
            DE[11] = STAN;
            DE[22] = POSEM;
            DE[41] = TID;

            //5.Use "Build" method of object iso8583 to create a new  message.
            string NewISOmsg= iso8583.Build(DE, MTI);
            Console.WriteLine("Build ISO8583 Message");
            Console.WriteLine( NewISOmsg);

Parse an ISO8583 message:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using BIM_ISO8583;

namespace Parser
    class Program
        static void Main(string[] args)
            //<<< 1. Create an object of iso8583 >>>>

            BIM_ISO8583.NET.ISO8583 iso8583 = new BIM_ISO8583.NET.ISO8583();

            //2.<<< Prepare ISO8583 message to be parsed >>>

            string ISO8583Message = "0200722004000080000016601971" + 
            //3. <<< Declare String Arrays >>>

            string[] DE;

            //4. <<< Use "Parse" method of object iso8583. >>>

            DE = iso8583.Parse(ISO8583Message);

            //That was it!!!

            //If there is no error occurred then you have successfully parsed a valid ISO8583 message

            //Here's how to use the newly parsed ISO8583 Data Elements

            string PrimaryBitMap = DE[0];
            string SecondaryBitMap = DE[1];
            string PAN = DE[2];
            string ProcessingCode = DE[3];
            string Amount = DE[4];
            string TransmissionTime = DE[7];
            string SystemTraceNo = DE[11];
            string TerminalID = DE[41];
            string MerchantID = DE[42];
            string AdditionalData = DE[48];
            string MTI = DE[129];               

            //Displaying  Data Elements

            Console.WriteLine("Please Press 'ENTER' to continue...");
            Console.WriteLine(" PrimaryBitMap = DE[0]" + " = {0}", DE[0]);
            Console.WriteLine(" SecondaryBitMap = DE[1]" + "= {0}", DE[1]);
            Console.WriteLine(" PAN = DE[2]" + "= {0}", DE[2]);
            Console.WriteLine(" ProcessingCode = DE[3]" + "= {0}", DE[3]);
            Console.WriteLine(" Amount = DE[4]" + "= {0}", DE[4]);
            Console.WriteLine(" TransmissionTime = DE[7]" + "= {0}", DE[7]);
            Console.WriteLine(" SystemTraceNo = DE[11]" + "= {0}", DE[11]);
            Console.WriteLine(" TerminalID = DE[41]" + "= {0}", DE[41]);
            Console.WriteLine(" MerchantID = DE[42]" + "= {0}", DE[42]);
            Console.WriteLine(" AdditionalData = DE[48]" + "= {0}", DE[48]);


This article, along with any associated source code and files, is licensed under The BSD License


About the Author

Bim Garcia
Software Developer (Senior)
Philippines Philippines
He's a Banking and Payment System Specialist based in Manila. His corporate career started when he enhanced the world's first Interbank Mobile Banking System known as Globe Mobile Banking System (Globe MBS).

Currently, He's working with a payment gateway company and some financial institutions to develop another payment technology.

He's also an Information Security Researcher.

In 2012, he has developed some military grade security boxes, which will make banking and payment ecosystem more secured.

Currently, he is developing an internetless access to Bitcoin account. This will help banked the unbanked and underbanked.

You may also be interested in...

Comments and Discussions

QuestionHow to add sub fields in 127DE i.e. 127.2, 127.33 etc Pin
Er. Imran Khan16-Jan-17 20:59
professionalEr. Imran Khan16-Jan-17 20:59 
QuestionHow to implement ISO8583_93 Pin
Member 1231604710-Feb-16 1:07
memberMember 1231604710-Feb-16 1:07 
QuestionSending the parsed ISO 8583 Message to a switch. Pin
Member 1219394529-Jan-16 3:15
memberMember 1219394529-Jan-16 3:15 
QuestionISO8583 BizTalk Parser Pin
Member 1191437617-Aug-15 1:32
memberMember 1191437617-Aug-15 1:32 
QuestionConvert hexa to 8583 message Pin
Zobayer Rabbi5-Aug-15 18:29
memberZobayer Rabbi5-Aug-15 18:29 
QuestionSome Field in ISO8583 Pin
leontiy_leo14-Apr-15 4:05
memberleontiy_leo14-Apr-15 4:05 
QuestionSend using socket or winsock Pin
DebugMePls3-Mar-15 14:15
memberDebugMePls3-Mar-15 14:15 
QuestionUsing the dll in passbook printing application Pin
Black_Rose15-Sep-14 20:05
memberBlack_Rose15-Sep-14 20:05 
QuestionHow to know at what index to set which value? Pin
Ibrahim Islam28-Jun-14 22:27
memberIbrahim Islam28-Jun-14 22:27 
AnswerRe: How to know at what index to set which value? Pin
CDMTJX25-Sep-15 11:06
memberCDMTJX25-Sep-15 11:06 
QuestionDynamic Message Length Pin
nonintrusive24-Dec-13 22:13
membernonintrusive24-Dec-13 22:13 
QuestionHow to Add headers details Pin
khan khateeb21-Jul-13 21:32
memberkhan khateeb21-Jul-13 21:32 
QuestionField 123 and 127 Pin
Programm3r22-Apr-13 21:52
memberProgramm3r22-Apr-13 21:52 
QuestionDoubts on ISO8583 standard Pin
Amajaya12321-Feb-13 19:40
memberAmajaya12321-Feb-13 19:40 
AnswerRe: Doubts on ISO8583 standard Pin
Bim Garcia10-Apr-13 18:18
memberBim Garcia10-Apr-13 18:18 
GeneralRe: Doubts on ISO8583 standard Pin
George Panou14-Oct-14 4:45
memberGeorge Panou14-Oct-14 4:45 
QuestionEBCDIC Pin
Member 390018714-Dec-12 20:49
memberMember 390018714-Dec-12 20:49 
AnswerRe: EBCDIC Pin
Bim Garcia15-Jan-13 20:46
memberBim Garcia15-Jan-13 20:46 
QuestionHello Pin
thomy198420-Sep-12 22:19
memberthomy198420-Sep-12 22:19 
AnswerRe: Hello Pin
Bim Garcia20-Sep-12 22:41
memberBim Garcia20-Sep-12 22:41 
GeneralMy vote of 4 Pin
Nuren Geodakov22-Aug-12 3:16
memberNuren Geodakov22-Aug-12 3:16 
Pretty good code that explains the ISO 8583 messages structure. Can be used as a start pad for future ISO 8583 versions
GeneralRe: My vote of 4 Pin
Bim Garcia18-Sep-12 18:31
memberBim Garcia18-Sep-12 18:31 
GeneralHi Pin
Gopa Panda20-Jun-12 19:44
memberGopa Panda20-Jun-12 19:44 
GeneralRe: Hi Pin
Bim Garcia18-Sep-12 18:33
memberBim Garcia18-Sep-12 18:33 
QuestionPadRight Pin
jfriedman5-May-12 9:06
memberjfriedman5-May-12 9:06 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.170424.1 | Last Updated 25 Mar 2013
Article Copyright 2012 by Bim Garcia
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid