vsi_pln_pre.py

"""
XML-HTTP
PARTNER
PLN-PREPAID MODULE
Version 1.0.0 (June 2016)
2016
REVISIONS
VERSION DATE DESCRIPTION
1.0.0 June 7th, 2016 Initial release
1
PREPAID
"""
# 1. Inquiry: protokol untuk melakukan pengecekan data tagihan/pembelian
"""
REQ :
?
        modul=PRE
        command=INQ
        msn={IDPEL/MSN}
        cid={CLIENTID}
        dt={DTTRX}
        hc={HASH}
        trxid={UniqueID}
        resp=XML

Contoh response Sukses:
<?xml version="1.0"?>
<root>
    <status>SUCCESS</status>
    <rc>0000</rc>
    <rcm>[0] CEK TAGIHAN SUKSES ke:88888888888 refnum:D0EE65CAB0C04601878612867541EEA5</rcm>
    <text>88888888888
        TestDu''mmyP
        R2/7000 VA
        Token Unsold: 0
        Adm 1.600,00
        *Denom Belum Termasuk Admin
    </text>
    <refnum>D0EE65CAB0C04601878612867541EEA5</refnum>
    <msn>88888888888</msn>
    <idpel>885555555555</idpel>
    <nama>TestDu''mmyPanjang8855555</nama>
    <tarifdaya>R2/7000</tarifdaya>
    <adm>1600</adm>
    <jmltokenunsold>0</jmltokenunsold>
</root>

        Contoh response Error:
<?xml version="1.0"?>
<root>
    <status>ERROR</status>
    <rc>0014</rc>
    <rcm>[14] IDPEL YANG ANDA MASUKKAN SALAH, MOHON TELITI KEMBALI. ke:888888888</rcm>
</root>
"""
# 2. Payment:
"""
        modul=PRE
        command=PAY
        nominal={NOMINAL}
        refnum={INQREF}
        cid={CLIENTID}
        dt={DTTRX}
        hc={HASH}
        trxid={UniqueID}
        resp=XML

Contoh response Sukses:

<?xml version="1.0"?>
<root>
    <status>SUCCESS</status>
    <rc>0000</rc>
    <rcm>[0] PEMBAYARAN SUKSES ke:88888888888 refnum:05062135116139A54A95CCC549DDA94C</rcm>
    <text>08/06/16 11:50
        05062135116139A54A95CCC549DDA94C
        TestDu''mmyP
        88888888888
        881111111111
        R2/6600 VA
        RP 201.600
        KWH352,0
        STROOM/TOKEN 2593 0960 8106 1072 1376
        ADM 1.600,00</text>
    <tanggal>2016-06-08 11:50:22</tanggal>
    <nama>TestDu''mmyPanjang8811111</nama>
    <msn>88888888888</msn>
    <idpel>881111111111</idpel>
    <tarifdaya>R2/6600</tarifdaya>
    <nominal>201600</nominal>
    <jmlkwh>352</jmlkwh>
    <token>2593-0960-8106-1072-1376</token>
    <ppn>0</ppn>
    <ppj>0</ppj>
    <adm>1600</adm>
    <angsuran>24000</angsuran>
    <materai>0</materai>
</root>

Contoh response Error:
<?xml version="1.0"?>
<root>
    <status>ERROR</status>
    <rc>0068</rc>
    <rcm>[68] TRANSAKSI TIDAK BISA DILAKUKAN SAAT INI, SILAHKAN LAKUKAN MANUAL
        ADVICE BEBERAPA SAAT LAGI. ke:233313211212
    </rcm>
</root>
"""
# 3. Advice: protokol untuk melakukan pengecekan transaksi dengan input payment refnum
"""
REQ :
?
        modul=PRE
        command=ADV
        nominal={NOMINAL}
        refnum={PAYREF}
        cid={CLIENTID}
        dt={DTTRX}&hc={HASH}
        trxid={UniqueID}
        resp=XML

        Contoh Response Sukses:
<?xml version="1.0"?>
<root>
<status>SUCCESS</status>
    <rc>0000</rc>
    <rcm>[0] PEMBAYARAN SUKSES ke:88888888888 refnum:051158BB9F2741AB893DCE972396DB59</rcm>
    <text>08/06/16 11:50
        05062135116139A54A95CCC549DDA94C
        TestDu''mmyP
        88888888888
        881111111111
        R2/6600
        RP 201.600
        KWH352,0
        STROOM/TOKEN 2593 0960 8106 1072 1376
        ADM 1.600,00
    </text>
    <tanggal>2016-06-08 11:50:22</tanggal>
    <nama>TestDu''mmyPanjang8811111</nama>
    <msn>88888888888</msn>
    <idpel>881111111111</idpel>
    <tarifdaya>R2/6600</tarifdaya>
    <nominal>201600</nominal>
    <jmlkwh>352</jmlkwh>
    <token>2593-0960-8106-1072-1376</token>
    <ppn>0</ppn>
    <ppj>0</ppj>
    <adm>1600</adm>
    <angsuran>24000</angsuran>
    <materai>0</materai>
</root>

Contoh response Error:
<?xml version="1.0"?>
<root><status>ERROR</status><rc>0096</rc><rcm>[96] ERROR TRANSAKSI TIDAK DITEMUKAN
ke:23331321121</rcm></root>
"""
# 4. Auto Payment :protokol untuk melakukan pembayaran/pembelian dengan tanpa melakukan inquiry
"""
REQ :
?
    modul=PRE
    command=PAY
    msn={22222222222}
    nominal={NOMINAL}
    cid={CLIENTID}
    dt={DTTRX}
    hc={HASH}
    trxid={UniqueID}
    resp=XML
Contoh Response Sukses:

Contoh response Error:
<?xml version="1.0"?>
<root><status>ERROR</status><rc>0068</rc><rcm>[68] TRANSAKSI TIDAK BISA DILAKUKAN SAAT INI,
SILAHKAN LAKUKAN MANUAL ADVICE BEBERAPA SAAT LAGI. ke:233313211212</rcm></root>
5. Advice Tanpa PAYREF: protokol untuk melakukan pengecekan transaksi tanpa input payment refnum
REQ :
?modul=PRE&command=ADV&msn={22222222222}&nominal={NOMINAL}&cid={CLIENTID}&dt={DTTRX}&hc={HASH
}&trxid={UniqueID}&resp=XML
Contoh Response:
<?xml version="1.0"?>
<root>
    <status>SUCCESS</status>
    <rc>0000</rc>
    <rcm>[0] PEMBAYARAN SUKSES ke:88888888888
        refnum:051158BB9F2741AB893DCE972396DB59</rcm><text>08/06/16 11:50
        05062135116139A54A95CCC549DDA94C
        TestDu''mmyP
        88888888888
        881111111111
        R2/6600
        RP 201.600
        KWH 352,0
        STROOM/TOKEN 2593 0960 8106 1072 1376
        ADM 1.600,00</text>
    <tanggal>2016-06-08 11:50:22</tanggal>
    <nama>TestDu''mmyPanjang8811111</nama>
    <msn>88888888888</msn>
    <idpel>881111111111</idpel>
    <tarifdaya>R2/6600</tarifdaya>
    <nominal>201600</nominal>
    <jmlkwh>352</jmlkwh>
    <token>2593-0960-8106-1072-1376</token>
    <ppn>0</ppn>
    <ppj>0</ppj>
    <adm>1600</adm>
    <angsuran>24000</angsuran>
    <materai>0</materai>
</root>

Contoh response Error:
<?xml version="1.0"?>
<root>
    <status>ERROR</status>
    <rc>0096</rc>
    <rcm>[96] ERROR TRANSAKSI TIDAK DITEMUKAN ke:23331321121</rcm>
</root>

Keterangan:
1. cid = identitas mitra, akan diinfokan ke mitra pada saat test maupun production.
2. dt = tanggal jam transaksi (YYYYMMDD).
3. hc = SHA256(cid+dt+secret key) , secret key dan cid akan diinfokan ke mitra pada saat test maupun production.
4. Semua info/nilai yang diapit oleh {…} wajib diganti dengan nilai yang seharusnya (tanpa mengandung {}).
5. trxid merupakan unique id dari mitra per transaksi dengan panjang maksimum 50 character.
6. resp merupakan format respon yang diinginkan (XML), secara default jika dikosongkan maka responnya merupakan format plaintext.Pesan Transaksi :
Pembayaran Sukses
[4] ERROR Biller Tidak terdaftar
[5] ERROR Lainnya
[6] ERROR Sentral diblok
[7] ERROR PPID diblok
[8] ERROR Waktu akses tidak valid
[9] ERROR Akun tidak aktif
[11] ERROR NEED TO SIGN ON
[12] ERROR Tidak bisa dibatalkan
[13] ERROR Nilai Transaksi tidak valid
8
[14] ERROR ID Tidak Terdaftar
[15] ERROR No Meter Tidak Terdaftar
[16] ERROR PRR SUBSCRIBER
[17] ERROR ID Punya Tunggakan
[18] ERROR Permintaan Sedang diproses
[26] Quota Transaksi Agen Tidak Mencukupi. Silahkan Kontak Agen.
[29] ERROR Kode Hash tidak valid
[30] ERROR Pesan tidak valid
[31] ERROR Kode Bank tidak terdaftar
[32] ERROR Sentral tidak terdaftar
[33] ERROR Produk tidak terdaftar
[34] ERROR PPID Tidak terdaftar
[35] ERROR Akun Tidak Terdaftar
[41] ERROR Nilai Transaksi dibawah Nilai Minimum
[42] ERROR Nilai Transaksi diatas Nilai Maximum
[43] ERROR Daya Baru Lebih Kecil dari Daya Sekarang
[44] ERROR Nilai Daya Tidak Valid
[45] ERROR Nilai Biaya Administrasi Tidak Valid
[46] ERROR Deposit Tidak Mencukupi
[47] ERROR Diluar Batas KWH
[48] ERROR Permintaan sudah kadaluarsa
[51] ERROR Transaksi Gagal dari Mesin Vending
[52] ERROR Transaksi dipending dari Mesin Vending
[53] ERROR Produk tidak ditemukan
[54] ERROR Jawaban dari Biller Tidak ditemukan
[55] ERROR Lainnya Mesin Vending
[56] ERROR Nomor Telpon Tidak diketahui
[63] ERROR Tidak ada Pembayaran
[60] ERROR Akun sudah didaftarkan
[67] ERROR CANNOT CONNECT
[68] ERROR Timeout
[69] ERROR Sertifikat tidak dikenal
[70] ERROR Timeout tidak refund
[72] ERROR Permintaan tidak mungkin dilayani
[73] ERROR Request dipending di Biller
[77] ERROR Id di suspend
[88] ERROR Tagihan sudah dibayar
[89] ERROR Tagihan tidak tersedia
[90] ERROR sedang proses CUT OFF
[91] ERROR Database
[92] ERROR Nomor Referensi Switching tidak ditemukan
[93] ERROR Nomor Referensi Switching tidak valid
[94] ERROR Pembatalan sudah dilakukan
[95] ERROR Kode Merchant tidak terdaftar
[96] ERROR Transaksi tidak ditemukan
[97] ERROR SW BANK Tidak identik
[98] ERROR Nomor Referensi Switching tidak valid
[146] ERROR di servis deposit
"""

import requests
import xmltodict

from .vsi import Vendor as VendorClass


class Vendor(VendorClass):
    def pars_data(self, data):
        return {
                "bill_no": "subid" in data and data["subid"] or self.bill_no,
                "nama": "nama" in data and data["nama"] or "NO-NAME",
                "pokok": "tagihan" in data and data["tagihan"] or 0,
                "denda": "denda" in data and data["denda"] or 0,
                "admin": "admin" in data and data["admin"] or 0,
                "total": "total" in data and data["total"] or 0,
                "ppn": "ppn" in data and data["ppn"] or 0,
                "trx_id": "trxid" in data and data["trxid"] or self.partner_log_id,
                "ref_no": "refnum" in data and data["refnum"] or "",
                "jml_bulan": "bulan" in data and data["bulan"] or "",
                "tgh_bulan": "blth" in data and data["blth"] or "",
                "tarif": "tarif" in data and data["tarif"] or "",
                "tgl_bayar" : "date" in data and data["date"] or "",
                "info" : "info1" in data and data["info1"] or "",
                "stand_meter" : "standmeter" in data and data["standmeter"] or "",
            }

    def inquiry(self):
        """
        :return:
        :parameter url tobe submitted
            cid = {CLIENTID}
            dt = {DATE}
            hc = {HASHCODE}
            modul = pln
            command = INQ
            idpel = {IDPELANGGAN}
            resp = XML
            trxid = {IDTRANSAKSI}
        :sukses response
            <?xml version="1.0"?>
            <root>
                <status>SUCCESS</status>
                <rc>0000</rc>
                <rcm>
                    [0] CEK TAGIHAN SUKSES ke:532110000060 refnum:33ECE3543E62474AA0C6C3147D94A31D
                </rcm>
                <text>532110000060
                    DU'MMY-VSI-532110000
                    1 BLN
                    JUN16
                    RP TAG PLN RP 887.817
                    ADM RP 1.600
                    TOTAL RP 890.929
                </text>
                <refnum>33ECE3543E62474AA0C6C3147D94A31D</refnum>
                <idpel>532110000060</idpel>
                <nama>DU'MMY-VSI-532110000060</nama>
                <bulan>1 BLN</bulan>
                <blntagihan>JUN16</blntagihan>
                <admin>1600</admin>
                <tagihan>889329</tagihan>
                <total>890929</total>
            </root>

        :error response
            <?xml version = "1.0"?>
            <root>
                <status>ERROR</status>
                <rc>0014</rc>
                <rcm>
                    [14] IDPEL YANG ANDA MASUKKAN SALAH, MOHON TELITI KEMBALI.
                </rcm>
            < / root >
        : notes
            1. cid = identitas mitra, akan diinfokan ke mitra pada saat test
               maupun production.
            2. dt = tanggal jam transaksi (YYYYMMDD).
            3. hc = SHA256(cid+dt+secret key) , secret key dan cid akan
               diinfokan  ke mitra pada saat test maupun production.
            4. Semua info/nilai yang diapit oleh {…} wajib diganti dengan
               nilai yang seharusnya (tanpa mengandung {}).
            5. trxid merupakan unique id dari mitra per transaksi dengan
               panjang maksimum 50 character.
            6. resp merupakan format respon yang diinginkan (XML), secara
               default jika dikosongkan maka responnya merupakan format plaintext.
        """
        params = self.get_params(cmd='INQ', modul='PRE')
        params["msn"] = self.bill_no
        # params["voucherid"] = self.v_produk_kd
        self.request = params
        self.save_log('inquiry')
        params['trxid'] =  self.partner_log_id
        result = requests.get(self.url, params=params)
        if result.ok:
            data = xmltodict.parse(result.text)["root"]
        else:
            data = dict(error=result.text,
                        code=result.status_code)

        self.response = data
        self.save_log('inquiry')
        if "status" in data and data["status"] and data["status"] == "SUCCESS":
            # data = self.pars_data(data)
            pass

        elif "status" in data and data["status"] and data["status"] == "ERROR":
            #todo: apakah data akan dimapping errornya?
            data = dict(error=data["rcm"],
                        code=data["rc"])

        return data

    def payment(self):
        """
        :parameter
            cid = {CLIENTID}
            dt = {DATE}
            hc = {HASHCODE}
            modul = pln
            command = PAY
            idpel = {IDPELANGGAN}
            resp = XML
            trxid = {IDTRANSAKSI}
        :response sukses
            <?xml version="1.0"?>
            <root>
                <status>SUCCESS</status>
                <rc>0000</rc>
                <rcm>[0] PEMBAYARAN SUKSES ke:532110000060 refnum:0506213515100D3399B27293E3DBC535</rcm>
                <text>22/06/16 14:29
                        0506213515100D3399B27293E3DBC535
                        532110000060
                        DU'MMY-VSI-532110000
                        R1/450
                        BLN JUN16
                        RP 887.729
                        ADM RP 1.600
                        TOTAL RP 890.929
                        SUKSES
                </text>
                <date>2016-06-22 14:29:25</date>
                <refnum>0506213515100D3399B27293E3DBC535</refnum>
                <idpel>532110000060</idpel>
                <nama>DU'MMY-VSI-532110000060</nama>
                <segmenpower>R1/450</segmenpower>
                <startend>888800-889900</startend>
                <blntagihan>JUN16</blntagihan>
                <ppn>0</ppn>
                <denda>0</denda>
                <totaltagihanpln>887729</totaltagihanpln>
                <admin>1600</admin>
                <total>890929</total>
                <info1>Informasi Hubungi Call Center: 123 Atau Hub. PLN Terdekat:</info1>
                <info2>Terima Kasih</info2>
            </root>
        :response error
            <?xml version="1.0"?>
            <root>
                <status>ERROR</status>
                <rc>0088</rc>
                <rcm>[88] TAGIHAN SUDAH TERBAYAR</rcm>
            </root>
        """
        params = self.get_params(cmd='PAY', modul='PRE')
        params["msn"] = self.bill_no
        # params["voucherid"] = self.v_produk_kd
        self.request = params
        # todo: apakah harus di cek dulu data inquirynya
        self.save_log('payment')
        params['trxid'] = self.partner_log_id
        result = requests.get(self.url, params=params)
        if result.ok:
            data = xmltodict.parse(result.text)["root"]
        else:
            data = dict(error=result.status_code)
        self.response = data
        self.save_log('payment')
        if "status" in data and data["status"] and data["status"] == "SUCCESS":
            # data = self.pars_data(data)
            pass

        elif "status" in data and data["status"] and data["status"] == "ERROR":
            #todo: apakah data akan dimapping errornya?
            data = dict(error=data["rcm"],
                        code=data["rc"])
        return data