This library is used to convert messages from one format to another. The supported formats are ISO 8583, JSON, and XML.
Beginner programmers often experience difficulties when parsing and building data with ISO 8583 format. Most programmers are more familiar with human readable formats such as JSON and XML. On the other hand, however, the company requires the ISO 8583 format because some or all of the partners use that format.
Using this library, both senior programmers and novice programmers will be easier to build applications that use the ISO 8583 message format.
You can save the configuration on file or database as string.
- Convert JSON to ISO 8583
- Convert XML to ISO 8583
- Convert ISO 8583 to JSON
- Convert ISO 8583 to XML
- Convert JSON to XML
- Convert XML to JSON
Script
packagetest;importjava.io.IOException;importorg.json.JSONArray;importorg.json.JSONException;importorg.json.JSONObject;importcom.bgw.translator.MessageTranslator;publicclassTest {publicstaticvoidmain(String[]args)throwsIOException {StringconfigStr ="[{\"field\":\"2\",\"format\":\"%-6s\",\"variable\":\"pan\",\"options\":\"\",\"type\":\"LLVAR\",\"field_length\":\"6\"},{\"field\":\"3\",\"format\":\"%06d\",\"variable\":\"processing_code\",\"options\":\"\",\"type\":\"NUMERIC\",\"field_length\":\"6\"},{\"field\":\"4\",\"format\":\"%012d\",\"variable\":\"amount\",\"options\":\"\",\"type\":\"NUMERIC\",\"field_length\":\"12\"},{\"field\":\"7\",\"format\":\"%-10s\",\"variable\":\"transmission_date_time\",\"options\":\"\",\"type\":\"STRING\",\"field_length\":\"10\"},{\"field\":\"11\",\"format\":\"%06d\",\"variable\":\"stan\",\"options\":\"\",\"type\":\"NUMERIC\",\"field_length\":\"6\"},{\"field\":\"12\",\"format\":\"%-6s\",\"variable\":\"local_time\",\"options\":\"\",\"type\":\"STRING\",\"field_length\":\"6\"},{\"field\":\"13\",\"format\":\"%-4s\",\"variable\":\"local_date\",\"options\":\"\",\"type\":\"STRING\",\"field_length\":\"4\"},{\"field\":\"15\",\"format\":\"%-4s\",\"variable\":\"settlement_date\",\"options\":\"\",\"type\":\"STRING\",\"field_length\":\"4\"},{\"field\":\"18\",\"format\":\"%04d\",\"variable\":\"merchant_type\",\"options\":\"\",\"type\":\"NUMERIC\",\"field_length\":\"4\"},{\"field\":\"32\",\"format\":\"%-3s\",\"variable\":\"acq_institution_code\",\"options\":\"\",\"type\":\"LLVAR\",\"field_length\":\"3\"},{\"field\":\"37\",\"format\":\"%012d\",\"variable\":\"reference_number\",\"options\":\"\",\"type\":\"NUMERIC\",\"field_length\":\"12\"},{\"field\":\"41\",\"format\":\"%-8s\",\"variable\":\"card_acceptor_terminal\",\"options\":\"\",\"type\":\"STRING\",\"field_length\":\"8\"},{\"field\":\"42\",\"format\":\"%15s\",\"variable\":\"acceptor_identification_code\",\"options\":\"\",\"type\":\"STRING\",\"field_length\":\"15\"},{\"field\":\"48\",\"format\":\"%-7s%011d%012d%01d%-32s%-32s%-25s%4s%-9s\",\"variable\":\"switcher_id, meter_id, customer_id, id_selector, pln_reference_number, ba_reference_number, customer_name, tariff, ceiling\",\"options\":\"\",\"type\":\"LLLVAR\",\"field_length\":\"133\"},{\"field\":\"49\",\"format\":\"%03d\",\"variable\":\"transaction_currency_code\",\"options\":\"\",\"type\":\"NUMERIC\",\"field_length\":\"3\"}]";MessageTranslatormt =newMessageTranslator();Stringmti_id ="0210";Stringiso ="0210723A400108C1800006364235361000000000050000072751515134657351515107270728678903555232442364723376832 234822 1339876 7183712217171837122171212462348242265823582523523547223323582375872385728357823758235235KAMSHORY, MT R51350 360";Stringiso_new ="";Stringxml ="";JSONArrayconfig =newJSONArray();JSONObjectjson =newJSONObject();try {config =newJSONArray(configStr);json =mt.parseISO8583(iso,config);iso_new =newString(mt.buildISO8583(json,config,mti_id));xml =mt.buildXML(json,"data");System.out.println("Demonstration of conversion of ISO 8583 - JSON - XML");System.out.println("Config : ");System.out.println(config.toString());System.out.println("=============================================================");System.out.println("Original ISO 8583 : ");System.out.println("'"+iso+"'");System.out.println("Convert ISO to JSON");System.out.println("JSON : ");System.out.println(json.toString());System.out.println("=============================================================");System.out.println("Now, convert JSON to new ISO");System.out.println("New ISO 8583 : ");System.out.println("'"+iso_new+"'");System.out.println("=============================================================");System.out.println("Now, convert JSON to XML");System.out.println("XML : ");System.out.println(xml);System.out.println("=============================================================");}catch (JSONExceptione) {e.printStackTrace();}}}Output
Demonstration of conversion of ISO 8583 - JSON - XMLConfig : [{"field":"2","format":"%-6s","variable":"pan","options":"","field_length":"6","type":"LLVAR"},{"field":"3","format":"%06d","variable":"processing_code","options":"","field_length":"6","type":"NUMERIC"},{"field":"4","format":"%012d","variable":"amount","options":"","field_length":"12","type":"NUMERIC"},{"field":"7","format":"%-10s","variable":"transmission_date_time","options":"","field_length":"10","type":"STRING"},{"field":"11","format":"%06d","variable":"stan","options":"","field_length":"6","type":"NUMERIC"},{"field":"12","format":"%-6s","variable":"local_time","options":"","field_length":"6","type":"STRING"},{"field":"13","format":"%-4s","variable":"local_date","options":"","field_length":"4","type":"STRING"},{"field":"15","format":"%-4s","variable":"settlement_date","options":"","field_length":"4","type":"STRING"},{"field":"18","format":"%04d","variable":"merchant_type","options":"","field_length":"4","type":"NUMERIC"},{"field":"32","format":"%-3s","variable":"acq_institution_code","options":"","field_length":"3","type":"LLVAR"},{"field":"37","format":"%012d","variable":"reference_number","options":"","field_length":"12","type":"NUMERIC"},{"field":"41","format":"%-8s","variable":"card_acceptor_terminal","options":"","field_length":"8","type":"STRING"},{"field":"42","format":"%15s","variable":"acceptor_identification_code","options":"","field_length":"15","type":"STRING"},{"field":"48","format":"%-7s%011d%012d%01d%-32s%-32s%-25s%4s%-9s","variable":"switcher_id, meter_id, customer_id, id_selector, pln_reference_number, ba_reference_number, customer_name, tariff, ceiling","options":"","field_length":"133","type":"LLLVAR"},{"field":"49","format":"%03d","variable":"transaction_currency_code","options":"","field_length":"3","type":"NUMERIC"}]=============================================================Original ISO 8583 : '0210723A400108C1800006364235361000000000050000072751515134657351515107270728678903555232442364723376832 234822 1339876 7183712217171837122171212462348242265823582523523547223323582375872385728357823758235235KAMSHORY, MT R51350 360'Convert ISO to JSONJSON : {"ceiling":"1350 ","amount":"50000","settlement_date":"0728","switcher_id":"9876 ","ba_reference_number":"23582375872385728357823758235235","processing_code":"361000","transaction_currency_code":"360","id_selector":"1","reference_number":"232442364723","local_date":"0727","pln_reference_number":"24623482422658235825235235472233","local_time":"515151","transmission_date_time":"0727515151","stan":"346573","acq_institution_code":"555","card_acceptor_terminal":"376832 ","tariff":" R5","acceptor_identification_code":"234822 ","customer_name":"KAMSHORY, MT ","pan":"364235","customer_id":"718371221712","meter_id":"71837122171","merchant_type":"6789"}=============================================================Now, convert JSON to new ISONew ISO 8583 : '0210723A400108C1800006364235361000000000050000072751515134657351515107270728678903555232442364723376832 234822 1339876 7183712217171837122171212462348242265823582523523547223323582375872385728357823758235235KAMSHORY, MT R51350 360'=============================================================Now, convert JSON to XMLXML : <data><ceiling>1350 </ceiling><amount>50000</amount><settlement_date>0728</settlement_date><switcher_id>9876 </switcher_id><ba_reference_number>23582375872385728357823758235235</ba_reference_number><processing_code>361000</processing_code><transaction_currency_code>360</transaction_currency_code><id_selector>1</id_selector><reference_number>232442364723</reference_number><local_date>0727</local_date><pln_reference_number>24623482422658235825235235472233</pln_reference_number><local_time>515151</local_time><transmission_date_time>0727515151</transmission_date_time><stan>346573</stan><acq_institution_code>555</acq_institution_code><card_acceptor_terminal>376832 </card_acceptor_terminal><tariff> R5</tariff><acceptor_identification_code>234822 </acceptor_identification_code><customer_name>KAMSHORY, MT </customer_name><pan>364235</pan><customer_id>718371221712</customer_id><meter_id>71837122171</meter_id><merchant_type>6789</merchant_type></data>=============================================================
You can also use JSONObject as config type.
StringconfigStr ="{\"f41\":{\"format\":\"%-8s\",\"variable\":\"terminal_id\",\"options\":\"\",\n" +"\"field_length\":\"8\",\"type\":\"STRING\"},\"f63\":{\"format\":\"%-32s%-30s%-50s%-\n" +"18s\",\"variable\":\"locket_code, locket_name, locket_address, locket_phone\",\n" +"\"options\":\"\",\"field_length\":\"130\",\"type\":\"LLLVAR\"},\"f32\":{\"format\":\"%-\n" +"11s\",\"variable\":\"acq_institution_code\",\"options\":\"\",\"field_length\":\"11\",\n" +"\"type\":\"LLVAR\"},\"f121\":{\"format\":\"%-32s\",\"variable\":\"payment_reference\",\n" +"\"options\":\"\",\"field_length\":\"32\",\"type\":\"LLLVAR\"},\"f12\":{\"format\":\"%-6s\",\n" +"\"variable\":\"local_time\",\"options\":\"\",\"field_length\":\"6\",\n" +"\"type\":\"STRING\"},\"f120\":{\"format\":\"%-20s\",\"variable\":\"product_code\",\n" +"\"options\":\"\",\"field_length\":\"20\",\"type\":\"LLLVAR\"},\"f11\":{\"format\":\"%-6s\",\n" +"\"variable\":\"stan\",\"options\":\"\",\"field_length\":\"6\",\n" +"\"type\":\"STRING\"},\"f33\":{\"format\":\"%-11s\",\n" +"\"variable\":\"fwd_institution_code\",\"options\":\"\",\"field_length\":\"11\",\n" +"\"type\":\"LLVAR\"},\"f13\":{\"format\":\"%-4s\",\"variable\":\"local_date\",\n" +"\"options\":\"\",\"field_length\":\"4\",\"type\":\"STRING\"},\"f49\":{\"format\":\"%03d\",\n" +"\"variable\":\"transaction_currency_code\",\"options\":\"\",\"field_length\":\"3\",\n" +"\"type\":\"NUMERIC\"},\"f15\":{\"format\":\"%-4s\",\"variable\":\"settlement_date\",\n" +"\"options\":\"\",\"field_length\":\"4\",\"type\":\"STRING\"},\"f37\":{\"format\":\"%-12s\",\n" +"\"variable\":\"reference_number\",\"options\":\"\",\"field_length\":\"12\",\n" +"\"type\":\"STRING\"},\"f48\":{\"format\":\"%-13s\",\"variable\":\"registration_number\",\n" +"\"options\":\"\",\"field_length\":\"13\",\"type\":\"LLLVAR\"},\"f2\":{\"format\":\"%-19s\",\n" +"\"variable\":\"pan\",\"options\":\"\",\"field_length\":\"19\",\n" +"\"type\":\"LLVAR\"},\"f18\":{\"format\":\"%04d\",\"variable\":\"merchant_type\",\n" +"\"options\":\"\",\"field_length\":\"4\",\"type\":\"NUMERIC\"},\"f3\":{\"format\":\"%06d\",\n" +"\"variable\":\"processing_code\",\"options\":\"\",\"field_length\":\"6\",\n" +"\"type\":\"NUMERIC\"},\"f7\":{\"format\":\"%-10s\",\n" +"\"variable\":\"transmission_date_time\",\"options\":\"\",\"field_length\":\"10\",\n" +"\"type\":\"STRING\"},\"f127\":{\"format\":\"%-20s%-32s\",\"variable\":\"username,\n" +"password\",\"options\":\"\",\"field_length\":\"52\",\"type\":\"LLLVAR\"}}";JSONObjectconfig =newJSONObject();try {config =newJSONObject(configStr);}catch (JSONExceptione) {e.printStackTrace();}