iso8583 pln prepaid ver1.1 bank jatim-sms_ver may2013

Bank Jatim: Payment PLN

Format Messaging PrepaidJKPINDO V1.1

JKPINDOPT. Jaya Kreasi Putra Indonesia

May 2013

Prepaid Page 1

1. PENDAHULUAN

PLN adalah perusahaan milik negara yang menyediakan listrik diseluruh Indonesia.Untuk meningkatkan pelayanan kepada nasabahnya PLN menyediakan sistempembayaran listrik secara realtime online.

PT. Jaya Kreasi Putra Indonesia (JKPINDO) adalah Swtching Provider PLN yangdiberikan akses ke Billing Server PLN untuk Bank JATIM.

Bank JATIM adalah salah satu Collector Agent (CA), yang ditunjuk oleh PLN sebagaitempat pembayan listrik. Aliran proses bisnis penerimaan pembayaran global dapatdijelaskan dibawah ini :

1. Pelanggan PLN mendatangi outlet CA yang berupa teller.2. Setelah nometer/idpelanggan di input ke sistem front end CA, maka sistem CA akan

mengirikannya ke Host CA.3. Host CA akan melakukan format paket data sesuai U-Req ISO-8583 dan

mengirimkannya ke JKPINDO.4. Setelah menerima paket data dari Host CA, JKPINDO akan memproses data

tersebut (Inquiry) dan merespon/mengembalikan paket data tersebut ke Host CA.5. Sistem front end CA akan menampilkan respon inquiry tersebut.6. Jika pelanggan telah menyerahkan dana sesuai dengan nominal yang ditampilkan

pada sistem front end CA maka teller melakukan proses payment pada sistem frontend CA.

7. Sistem front end akan mengirimkan request payment ke Host CA dan Host CA akanmelakukan format paket data sesuai U-Req ISO-8583 dan meneruskannya keJKPINDO.

8. Setelah menerima paket data dari Host CA, JKPINDO memproses data tersebut(payment) dan merespon/mengembalikan hasil proses ke Host CA untuk diteruskanke sistem front end CA.

9. Sistem front end CA akan mencetak tanda terima apabila telah menerima respondari Host CA.

10. Pada H+1 tanggal transaksi CA mengirimkan data rekonsiliasi ke PLN, begitu jugaPLN mengirimkan data hasil rekonsiliasi ke CA.

11. Hasil rekonsiliasi adalah file koreksi data Force atau cancel, yang akan dikirimkanoleh PLN kepada CA.

Prepaid Page 2

NETWORK

CA hanya dapat mengakses JKPINDO melalui jaringan permanen seperti leased line,DOV, Satelit atau teknologi jaringan lainnya selama dapat terhubung secara permanen.Koneksi jaringan secara dial-up hanya diperbolehkan selama masa development,stadard protokol komunikasi yang digunakan adalah TCP/IP.

MESSAGING SYSTEM

CA hanya dapat mengirimkan paket data dalam format standar ISO-8583, danselanjutnya menjadi media pertukaran data antara CA dan JKPINDO, jenis transaksiyang digunakan dalam pertukaran data ini adalah sebagai berikut :

1. Financial Transaction Message.2. Reversal Transaction Message.3. Network Management Message.

HEADER MESSAGE

Setiap message yang dikirimkan oleh CA harus didahului dengan header messageberupa check length yang menunjukan panjang masing-masing message, begitu pulasebaliknya ketikan JKPINDO mengirimkan respon kepada CA.Jenis header message yang digunakan adalah jenis include, yang berarti check lengthmenunjukan panjang message ditambah 2 byte check length tersebut. Sebagai contohjika panjang message 135 maka check length harus berisi 135 + 2 = 137, dimana 2adalah panjang header message (check length itu sendiri).Formula check length adalah sebagai berikut :

Panjang message adalah 137, maka jika konversi kedalam bentuk binner =00000000 10001001, dan jika di conversi kedalam bentuk hexa menjadi 00 89

Sedangkan contoh message dengan panjang lebih dari 255, seperti terlihat dibawah ini :

Prepaid Page 3

Panjang message adalah 535 sudah termasuk 2 byte check length, jika dikonversikedalam bentuk binner adalah 00000010 00010111, jika dikonversi kedalam bentukhexa desimal adalah 02 17 yang berarti :

Prepaid Page 4

DATA ELEMENT

Bit # Nama Bit Format Attribute Keterangan1 Bit Map Extended b-1 A series of 64 bits used to identify the

presence (denote by 1) or absence(denote by 0) of each data element(Converted to Hexa Decimal)

2 Primary Account Number LLVAR n…19 A series of digits used to identify acustomer account or relationship

3 Processing Code n-6 A series of digits used to describe theeffect of a transaction on the customeraccount and the accounts affected.

4 Transaction Amount n-12 Amount that customer must pay, includingbank administration charges (ifapplicable). It is equal to TOTAL in thecustomer receipt.

7 Transaction date and time MMDDhhmmss n-10 GMT Time11 System Trace Audit Number n-6 Uniquely Trace Number Of Message12 Time Local Transaction Hhmmss n-6 The local time at which the transaction

take place13 Date Local Transaction MMDD n-4 The local month and day which the

transaction take place14 Expiration Date YYMM n-4 Year and month after the card expires15 Settlement Date MMDD n-4 Day and month fund transferred to PLN

by CA18 Merchant’s Type n-4 The Classification Merchant’s Type of

business product32 Acquiring institution

identification codeLLVAR n…11 Code Identifying Acquiring Institution

37 Retrieval Reference Number An-12 A Document Reference number suppliedby acquiring institution system

39 Response Code An-2 Numeric Code which define thedisposition of copy message

41 Card Acceptor Terminalidentification

n-8 ID-Terminal

48 Additional Data (PLN Data) LLLVAR An…999 Detail Data Information required in thetransaction (the bit will be off if inquiryresponse code not like 00)

49 Transaction Currency Code n-3 Use 360 for Indonesian Rupiah60 JKPINDOTrace Number LLLVAR n-6 JKPINDOTrace Number61 Private Data2 LLLVAR An…999 Information63 Produck Code n-3 Code Product Identification70 Network Management

Information Coden-3 Network Status Code

Prepaid Page 5

0200 – Format Inquiry / Payment Request

Bit # Nama Format Atribut StatusMessage Type = 0200 mBitmap b-1 m

2 Primary Account Number LLVAR n…19 c3 Processing Code n-6 m4 Transaction Amount n-12 m7 Transmission Date and Time MMDDhhmmss n-10 m

11 System Trace Audit Number n-6 m12 Time, Local Transaction hhmmss n-6 m13 Date, Local Transaction MMDD n-4 m15 Settlement Date MMDD n-4 m18 Merchant’s type n-4 c32 Acquiring institution indentification

codeLLVAR n…11 m

37 Retrieval Reference Number an-12 m41 Card Acceptor Terminal ID Code n-8 m48 Data LLLVAR ans…999 m49 Currency Code n-3 m60 JKPINDOTrace Number LLLVAR n-6 JKPINDOTrace

Number63 Produck Code n-3 m

0210 – Format Inquiry / Payment Response


2 Primary Account Number LLVAR n…19 c3 Processing Code n-6 m4 Transaction Amount n-12 m7 Transmission Date and Time MMDDhhmmss n-10 m

11 System Trace Audit Number n-6 m12 Time, Local Transaction hhmmss n-6 m13 Date, Local Transaction MMDD n-4 m15 Settlement Date MMDD n-4 m18 Merchant’s type n-4 c32 Acquiring institution indentification

codeLLVAR n…11 m

37 Retrieval Reference Number an-12 m39 Response Code n-2 M41 Card Acceptor Terminal ID Code n-8 M48 Data LLLVAR ans…999 M49 Currency Code n-3 M60 JKPINDOTrace Number LLLVAR n-6 JKPINDOTrace

Number61 Private Data2 LLLVAR Ans…999 M63 Produck Code n-3 M

Prepaid Page 6

0220 / 0221– Purchase Advice (Repeat) Request Message

Bit # Nama Format Atribut StatusMessage Type = 0220 / 0221 MBitmap b-64 M

1 Secondary Bitmap b-64 M2 Primary Account Number LLVAR n..19 c3 Processing Code n-6 M4 Transaction Amount n-12 M7 Transmission Date and Time MMDDhhmmss n-10 M

11 System Trace Audit Number n-6 M12 Time, Local Transaction hhmmss n-6 M13 Date, Local Transaction MMDD n-4 M15 Settlement Date MMDD n-4 M18 Merchant’s type n-4 C32 Acquiring institution indentification

codeLLVAR N…11 M

37 Retrieval Reference Number an-12 M41 Card Acceptor Terminal ID Code n-8 M48 Data LLLVAR ans…999 M49 Currency Code n-3 M60 JKPINDOTrace Number LLLVAR n-6 JKPINDOTrace

Number63 Produck Code n-6 M

0230/0231 – Purchase Advice (Repeat) Response Message

Bit # Nama Format Atribut StatusMessage Type = 0230 / 0231 MBitmap b-64 M

1 Secondary Bitmap b-64 m2 Primary Account Number LLVAR N…19 C3 Processing Code n-6 M4 Transaction Amount n-12 M7 Transmission Date and Time MMDDhhmmss n-10 M

11 System Trace Audit Number n-6 M12 Time, Local Transaction hhmmss n-6 M13 Date, Local Transaction MMDD n-4 M15 Settlement Date MMDD n-4 M18 Merchant’s type n-4 C32 Acquiring institution indentification

codeLLVAR N…11 M

37 Retrieval Reference Number an-12 M39 Response Code n-2 M41 Card Acceptor Terminal ID Code n-8 M48 Data LLLVAR ans…999 M49 Currency Code n-3 M60 JKPINDOTrace Number LLLVAR n-6 JKPINDOTrace

Number61 Private Data2 LLLVAR Ans…999 M63 Produck Code n-6 M

Prepaid Page 7

0800 – Format Network Management Request


1 Bitmap extended b-1 m7 Transmission Date and Time MMDDhhmmss n-10 m11 System Trace Audit Number n-6 m70 Network Management Information

Coden-3 m

0810 – Format Network Management Request Response


1 Bitmap extended b-1 m7 Transmission Date and Time MMDDhhmmss n-10 m11 System Trace Audit Number n-6 m39 Response Code n-2 m70 Network Management Information

Coden-3 m

Prepaid Page 8

KETERANGAN DATA ELEMENT

Bit # 1 Bit Map Extended =Mendefinisikan bit-bit aktif mulai bit 65 s/d bit 128.

Bit # 2 Primary Account NumberStatus Bit ini adalah Conditional, dapat berisi nomor rekening nasabah

Bit # 3 Processing Code380000 inquiry dari teller (cash)170000 Payment/Reversal Bill dari teller (cash)

Bit # 4 Transaction AmountJumlah nominal yang harus dibayarkan oleh nasabah,

Bit # 7 Transaction Date and TimeTanggal dan waktu transaksi (waktu GMT)

Bit # 11 System Trace Audit Number

Nomor identifikasi message, harus unik setiap harinya.

Bit # 12 Time Local TransactionWaktu lokal dimana transaksi dilakukan.

Bit # 13 Date Local TransactionTanggal lokal transaksi (WIB).

Bit # 15 Date SettlementTanggal pengiriman dana ke PLN

Bit # 18 Merchant’s Type

5131 Teller .5132 Auto Debit5133 ATM5134 ADM5135 Phone Banking5136 EDC5137 Internet Banking5151 SMS

Bit # 32 Acquiring institution Identification Code000114 = BANK JATIM

Bit # 37 Retrieval Reference NumberNomor id dokumen/idtransaksi pada receive

Prepaid Page 9

Bit # 39 Response Code

ResponseCode

Description

00 Transaksi disetujui01 Belum Sign On03 Kode merchant tidak terdaftar05 Error tidak terdefinisi07 Mandatory bit tidak aktif09 Message tidak lengkap12 Transaksi ditolak karena kesalahan prosedur seperti payment

tanpa inquiry13 Besar uang tidak sesuai14 Id Pelanggan tidak terdaftar15 Ada Tunggakan25 Autoreversal ditolak karena message payment belum diterima30 Message tidak sesuai dengan spesifikasi31 Kode bank tidak terdaftar40 Jenis transaksi tidak terdaftar41 Batas minimal pembelian42 Batas maksimal pembelian68 Time out dari database PLN8889

Sudah LunasTagihan belum tersedia

91 Koneksi ke database PLN terputus92 Message Tidak dapat di ruting94 Duplikasi STAN

Bit # 41 Card Acceptor Terminal ID Code

ID Terminal

Prepaid Page 10

Bit # 48 DATA PLN

Message Type ProcessCode

Nama Subbit Format Keterangan

0200 Inq 380000 Nometer N11

Idpel N12Flag N1 0= input dgn

nometer1=Input dgn idpel

0210 Inq 380000 Nometer N11Idpel N12Flag N1PLN Ref Number An32Name An25Subcriber Segmetation N4Power consuming catagory N9Minor unit of Admin charge N1Admin Charge N10Distribution Code N2Service Unit An5Service Unit Phone N15Max KWH Limit N5Total Repeat N1 0..2Power Purchase Unsold N11 Repeat

0200 Pay 170000 Nometer N11Idpel N12Flag N1PLN Ref Number An32Name An25Subcriber Segmetation N4Power consuming catagory N9Minor unit of Admin charge N1Admin Charge N10Buying Options N1 0= Buy New Token

1= Buy TokenUnsold

Distribution Code N2Service Unit An5Service Unit Phone N15Max KWH Limit N5Total Repeat N1 0..2Power Purchase Unsold N11 Repeat

0210 Pay 170000 Nometer N11Idpel N12Flag N1PLN Ref Number An32Switcher Ref Number An32

Prepaid Page 11

Vending Receipt Number N8Name An25Subcriber Segmetation N4Power consuming catagory N9Buying Options N1Minor unit of Admin charge N1Admin Charge N10Minor unit of Stamp Duty N1Stamp Duty N10Minor unit of Value Added Tax N1Added Tax N10Minor unit of Public LightingTax

N1

Public Lighting Tax N10Minor unit of CustomerPayables Installment

N1

Customer Payables Installment N10Minor unit of Power Purchase N1Power Purchase N12Minor unit of Purchased KWhUnit

N1

Purchased KWH Unit N10Token Number N20Distribution Code N2Service Unit An5Service Unit Phone N15Max KWH Limit N5Total Repeat N1 0..2Power Purchase Unsold N11 Repeat

0220 Advice0221 Repeat Advice

170000 Nometer N11Idpel N12Flag N1PLN Ref Number An32Name An25Subcriber Segmetation N4Power consuming catagory N9Minor unit of Admin charge N1Admin Charge N10Buying Options N1 0= Buy New Token

1= Buy TokenUnsold

Distribution Code N2Service Unit An5Service Unit Phone N15Max KWH Limit N5Total Repeat N1 0..2Power Purchase Unsold N11 Repeat

Prepaid Page 12

0230 Resp Advice0231 Resp RepeatAdvice

170000 Nometer N11Idpel N12Flag N1PLN Ref Number An32Switcher Ref Number An32Vending Receipt Number N8Name An25Subcriber Segmetation N4Power consuming catagory N9Buying Options N1Minor unit of Admin charge N1Admin Charge N10Minor unit of Stamp Duty N1Stamp Duty N10Minor unit of Value Added Tax N1Value Added Tax N10Minor unit of Public LightingTax

N1

Public Lighting Tax N10Minor unit of CustomerPayables Installment

N1

Customer Payables Installment N10Minor unit of Power Purchase N1Power Purchase N12Minor unit of Purchased KWhUnit

N1

Purchased KWH Unit N10Token Number N20Distribution Code N2Service Unit An5Service Unit Phone N15Max KWH Limit N5Total Repeat N1 0..2Power Purchase Unsold N11 Repeat

Bit # 49 Kode Mata Uang

360 = Indonesia Rupiah (IDR)

Bit # 60 JKPINDOTrace Number

Berisi nomor trace JKPINDO, yang harus dikembalikan sama pada saat request payment

Bit # 63 Product Code

513 = PLN Prepaid

Prepaid Page 13

Bit # 70 Network Management Information Code

001 – Sign On 002 – Sign Off 201 – Cut Off 301 – Echo Test

Prepaid Page 14

Attachment AFormat Bukti bayar

PREPAID

Tipe I (tidak menampilkan reff No Bank)

dd/mm/yy hh:mm (14) Tgl dan jam transaksixxxxxxxxxxxxxxxxxxxx (20) No. Ref *)xxxxxxxxxxxxxxxxxxxxx (21) Namaxxxxxxxxxxx (11) No meterxxxxxxxxxxxx (12) IDPELxx/xxxxxx (11) Tarif/DayaRp xxxxxxxxx (12) Rp BayarkWh xxxxx,x (12) Jml kWhStroom/Token xxxx xxxx xxxx xxxx xxxx (31) Stroom/TokenSUKSES (6)

(150) karakter

Tipe II (menampilkan reff No Bank)

dd/mm/yy hh:mm (14) Tgl dan jam transaksixxxxxxxxxxxxx (13) No Referensi Bankxxxxxxxxxxxxxxxxxxxx (20) No. Ref *)xxxxxxxxxxxxxxxxxxxxx (21) Nama12345678912 (11) No meterxxxxxxxxxxxx (12) IDPELxx/xxxxxx (11) Tarif/DayaRp xxxxxxxxx (12) Rp BayarkWh xxxxx,x (12) Jml kWhStroom/Token xxxx xxxx xxxx xxxx xxxx (31) Stroom/TokenSUKSES (6)

(154) karakter

*)bukan narasi tercetak

Prepaid Page 15

KETERANGAN:

NO NARASI KETERANGAN FORMAT CONTOH1. TANGGAL

DAN JAMTRANSAKSI

Tanggal dan jam terjadinya reply responsetransaksi pembelian Stroom/Token melaluisms banking, bukan tanggal dan jampenerimaan reply respons oleh pelanggan.

8 characterdan

6 character

05/07/11 12:48

2. JKP REF Nomor Referensi Switching sebagai kodepengaman keaslian bukti bayar.

Bebas ABCD1234567890DEF123

3. NAMA Nama Pelanggan / Calon Pelanggan yangtertera di Data Induk Pelanggan PLN atausesuai permohonan. Untuk struk smsbanking apabila space tidak cukup, namadapat diperpendek.

Minimal 12character

JENGKELIN

4. NO METER Adalah 11 digit nomor unique sebagaiidentitas pelanggan ListrikPraBayar (LPB)dan juga merupakan nomor meter kwhyang tepasang di lokasi instalasi listrikpelanggan LPB.

11 character 04176855965

5. IDPEL / IDPelanggan

Identitas Pelanggan adalah 12 digit nomorunique di seluruh Indonesia sebagaiidentitas pelanggan PLN.

Dua digit pertama merupakan kodedistribusi/wilayah PLN (53 untuk PLNDistribusi Jawa Barat dan Banten), tiga digitberikutnya adalah kode UPJ (misal : 551untuk UPJ Bandung Selatan), tujuh digitterakhir adalah nomor urut pelanggan.

12character

535511234567

6. TARIF/DAYA Tarif dan Daya Pelanggan adalah tarif dandaya tersambung pelanggan yang terterapada Data Induk Langganan.

4 characterdan

9 number

R1/450VA

7. RP BAYAR Rupiah yang dibayar pelanggan LPB untukmembeli STROOM/TOKEN.

Penulisan mata uang : Rp atau IDR

15 number 150.000

8. JML KWH Jumlah kWh yang dibeli sesuai nilai RpSTROOM/TOKEN. Jumlah kWh – RpSTROOM/TOKEN dibagi harga LPB per kWHuntuk tarif dan daya tertentu.

9,1 number 113,3

9. STROOM/TOKEN

20 deret angka sebagai kodeSTROOM/TOKEN untuk di-entry-kan kemeter LPB sehingga kWh yang sudah dibelidapat dimanfaatkan oleh pelanggan LPB.Untuk kemudahan bagi pelanggan, angka

20 number 1234 5678 91012345 6789

Prepaid Page 16

tsb tercetak dengan ukuran font berbedadengan informasi lainnya.

10. SUKSES Baris khusus yang dipergunakan PLN untukinformasi kepada pelanggan

6 character

Prepaid Page 17

Attachment BReconciliation Specification

Transaction File by Switching (.ftr) (1140000-50502-yymmdd.ftr)No Colomn Name Type Length Format Description

1 Date &Time,LocalTransaction

N 14 CCYYMMDDhhmmss Date & Local time whenthe transactiontakesplace

2 Switcher ID N 7 zeroleft-padding Switcher IdentificationCode

3 MerchantCategory Code

N 4 zeroleft-padding Merchant Category Code

4 PLN Ref Number AN 32 PLN Reference Number5 Switching Ref

NumberAN 32 spaceright-padding Switch Ref Number

6 Meter Number N 11 spaceleft-padding Prepaid Meter Number7 Transaction

AmountN 12 zeroleft-padding Total Charges must be

paid(last two digits aredecimal)TC=AC+SD+PTx+PI+PP

8 Admin Charge(AC)

N 10 zeroleft-padding Admin Charge(last two digits aredecimal)

9 Stamp Duty (SD) N 10 zeroleft-padding Stamp Duty(last two digits aredecimal)

10 Value Added Tax(VTx)

N 10 zeroleft-padding Value Added Tax(last two digits aredecimal)

11 Public LightingTax (PTx)

N 10 zeroleft-padding Public Lighting Tax(last two digits aredecimal)

12 CustomerPayableInstallment(PI)

N 10 zeroleft-padding Customer Payableinstallment(last two digits aredecimal)

13 Power Purchase(PP)

N 12 zeroleft-padding Purchased PowerAmount(last two digits aredecimal)

14 Purchased kWHunit (PU)

N 10 zeroleft-padding Purchased Kwh unit(last two digits aredecimal

15 Token N 20 Token to be entered toprepaid meter

Prepaid Page 18

Reconciliation File by CA (.rcn) (1140000-50502-yymmdd.rcn)

No Colomn Name Type Length Format Description

1 ReconciliationResult Type

N 1 1= Force Purchase2= Cancel Purchase










paid (last two digits aredecimal)TC=AC+SD+PTx+PI+PP

9 Admin Charge(AC)














Prepaid Page 19

Final Reconciliation File (.fcn) (1140000-50502-yymmdd.fcn)No Colomn Name Type Length Format Description

1 ReconciliationResult Type

N 1 3=Success for Force4=Fail For Force5=Success for Cancel6=Fail for Cancel










paid (last two digits aredecimal)TC=AC+SD+PTx+PI+PP

9 Admin Charge(AC)














iso8583 pln prepaid ver1.1 bank jatim-sms_ver may2013

Documents