Transaksi H2H Format YM & XML :
Transaksi
isi Pulsa Pelanggan :
-
Ketik : Kodevchr.nohp.pin
-
Contoh : HS20.081357361xxx.1234
Format
Pembelian PLN TOKEN (Host To Host) : -
Ketik : Kode.ID_PEL.NO_HP_PELANGGAN.PIN - Contoh :
HPT20.14023xxx.081330351xxx.1234
Informasi Server Berikut
ini adalah informasi server PS-PULSA
IP Address : 36.85.89.223
Port : 54321
Path : recharge.php
Berikut ini adalah spesifikasi interkoneksi H2H dengan format XML
POST. Format XML :
<?xml
version=”1.0″?> <pulsamatic> <command>RECHARGE</command> <vtype>KODEVOUCHER</vtype> <userid>USERNAME</userid> <time>HH24MMSS</time> <msisdn>MSISDN</msisdn> <trxid>TRXID</trxid> <sign>SIGNATURE</sign> </pulsamatic>
Keterangan :
ITEM Keterangan KODE VOUCHER Kode
voucher, misal untuk Simpati 20000 adalah HS20, dan lain sebagainya
USERNAME Username yang diberikan untuk proses transaksi H2H.
Diberikan pada saat pendaftaran. HH24MMSS Waktu transaksi dalam jam,
menit, detik. Jam dalam format 24 Jam. Contoh: 211104 MSISDN Nomor
yang akan ditransaksikan TRXID Nomor referensi transaksi klien H2H
TruGee SIGN
Signature sesuai dengan perhitungan
berikut ini: a= + 4 digit terakhir b= 4 digit terakhir dibalik +
password 6 digit (password akan diberikan oleh PulsaCentre) = a XOR b
lalu di base64encoded Contoh perhitungan signature: Time = 191001
Msisdn = 0812345678 Password = abcdef a = 1910015678 b = 8765abcdef
SIGN = base64encoded(a XOR b) CQ4HBVFTVlJSXg==
Respon dari Pulsa Matic :
<?xml
version=”1.0″?> <pulsamatic> <date>TANGGAL</date> <result>STATUS</result> <message>MESSAGE</message> <trxid>VSN</trxid> <partner_trxid>PARTNERTRXID</partner_trxid
> </pulsamatic>
ITEM
|
Keterangan
|
TANGGAL
|
Waktu terjadinya transaksi. Contoh: 2007-12-27 15:44:55
|
STATUS
|
Status hasil transaksi. Contoh: success, failed
|
MESSAGE
|
Pesan yg dihasilkan dari transaksi. Contoh: SUKSES! Trx S20
0852345678 berhasil. TrxID: 00001222820. Saldo: Rp. 514.150
|
VSN
|
ID transaksi dari Pulsa Matic. Contoh: 00001222820
|
PARTNERTRXID
|
ID transaksi anda
|
REVERSAL : Jika
terjadi kegagalan transaksi maka dikirimkan message reversal dengan
format http get sebagai berikut
: http://urlmitra?result=11&msg=Reversal&trxid=PulsamaticTrxId&partner_trxid=TRXID&msisdn=MSISDN
Contoh
: http://urlpartner?result=11&msg=Reversal&trxid=10001&partner_trxid=12345&msisdn=0812345678
Informasi Server Berikut ini adalah informasi
server PS-PULSA
IP Address : 36.85.89.223
Port : 54321
Path : topup.php
Berikut ini adalah spesifikasi interkoneksi H2H dengan format XML
POST. Format XML :
<?xml
version=”1.0″?> <pulsamatic> <command>TOPUP</command> <vtype>KODEVOUCHER</vtype> <userid>USERNAME</userid> <time>HH24MMSS</time> <msisdn>MSISDN</msisdn> <trxid>TRXID</trxid> <sign>SIGNATURE</sign> </pulsamatic>
Format XML Untuk Transaksi PPOB dan PLN Prepaid:
<?xml
version=”1.0″?> <pulsamatic> <command>TOPUP</command> <vtype>KODEVOUCHER</vtype> <userid>USERNAME</userid> <time>HH24MMSS</time> <msisdn>IDPELANGGANPLN.MSISDN</msisdn> <trxid>TRXID</trxid> <sign>SIGNATURE</sign> </pulsamatic>
Keterangan :
ITEM
|
Keterangan
|
KODE VOUCHER
|
Kode
voucher, misal untuk Simpati 20000 adalah HS20, dan lain
sebagainya
|
USERNAME
|
Username
yang diberikan untuk proses transaksi H2H. Diberikan pada saat
pendaftaran.
|
HH24MMSS
|
Waktu
transaksi dalam jam, menit, detik. Jam dalam format 24 Jam.
Contoh: 211104
|
MSISDN
|
Nomor yang
ditransaksikan. utk transaksi PPOB atau PLN id pelanggannya
disertakan contoh IDPLN.NOHP
|
TRXID
|
Nomor
referensi transaksi klien H2H TruGee
|
SIGN
|
Signature
sesuai dengan perhitungan berikut ini: a= + 4 digit terakhir b= 4
digit terakhir dibalik + password 6 digit (password akan
diberikan oleh PulsaCentre) = a XOR b lalu di base64encoded
Contoh perhitungan signature: Time = 191001 Msisdn = 0812345678
Password = abcdef a = 1910015678 b = 8765abcdef SIGN =
base64encoded(a XOR b) CQ4HBVFTVlJSXg==
|
Respon dari Pulsa Matic :
<?xml
version=”1.0″?> <pulsamatic> <date>TANGGAL</date> <result>STATUS</result> <message>MESSAGE</message> <trxid>VSN</trxid> <partner_trxid>PARTNERTRXID</partner_trxid
> </pulsamatic>
ITEM
|
Keterangan
|
TANGGAL
|
Waktu
terjadinya transaksi. Contoh: 2007-12-27 15:44:55
|
STATUS
|
Status
hasil transaksi. Contoh: success, failed
|
MESSAGE
|
Pesan yg
dihasilkan dari transaksi. Contoh: SUKSES! Trx S20 0852345678
berhasil. TrxID: 00001222820. Saldo: Rp. 514.150
|
VSN
|
ID
transaksi dari Pulsa Matic. Contoh: 00001222820
|
PARTNERTRXID
|
ID
transaksi anda
|
RESULT : Reply
transaksi real untuk mengetahui status transaksi berhasil, gagal atau
refund maka akan dikirimkan message result dengan format http get
sebagai berikut
: http://urlresult?pid=%5btrxid%5d&code=%5bstatus%5d&produk=%5bvtype%5d&sn=%5bvsn%5d&msisdn=%5bmsisdn%5d&msg=%5bmsg%5d&data=%5bdata%5d;
Contoh
: http://aaa.bbb.ccc/result/duta.php?pid=5866722&code=4&produk=HPLN20&sn=0236-0161-7420-0197-3419&msisdn=14025694374.081335917763&msg=2011-08-18+11%3A37+TRX+HPLN20+14025694374.081335917763+ BERHASIL+S%2FN%3A+0236-0161-7420-0197-3419+Harga%3A18650+Saldo %3A+3
58650&data=PAY+reffno%3A20110818113709000000000000779809%7 Cnmpel%3ABAMBANG+TALI+PRIYAMBODO%7Cidpel%3A514500588399%7 Cnomet%3A14025694374%7Ctarifdaya%3AR1%2F900%7Cbayar%3A20000% 7Cppj%3A1.519%2C27%7Cppn%3A0%2C00%7Cmeterai%3A0%2C00%7 Cangsuran%3A0%2C00%7Cpp%3A16.880%2C73%7Ckwh%3A28%2C00%7 Ctoken%3A0236-0161-7420-0197-3419
ITEM
|
Keterangan
|
TRXID
|
Nomor
referensi dari server.
|
CODE
|
Status
hasil transaksi. Contoh: 2=gagal , 3=refund , 4=berhasil.
|
PRODUK
|
Kode
voucher.
|
SN
|
Serial
number transaksi.
|
MSISDN
|
Nomor
transaksi.
|
MSG
|
Pesan
lengkap transaksi.
|
HARGA
|
Harga
voucher yang ditransaksikan.
|
SALDO
|
Sisa saldo
akhir.
|
DATA
|
Data
optional yaitu apabila melakukan transaksi PPOB atau PLN akan
menampilkan data nama dan id pelanggan, jumlah kwh, dan lain-lain
|
Informasi Server Berikut ini adalah informasi
server PulsanyaKita.
IP Address : 36.85.89.223
Port : 9788
Path : /
INQUIRY
Fungsi Proses
permintaan pengecekan tagihan ke server PPOB PULSAMATIC
Struktur XMLRPC
<?xml version=”1.0″
encoding=”UTF-8″?> <methodCall> <methodName>PPOB.Inquiry</methodName> <params> <param> <value> <struct> <member><name>user</name><value><string>[user]</string></value></member> <member><name>waktu</name><value><string>[time]</string></value></member> <member><name>produk</name><value><string>[produk]</string></value></member> <member><name>idpel</name><value><string>[idpel]</string></value></member> <member><name>hppel</name><value><string>[hppel]</string></value></member> <member><name>reffid</name><value><string>[trxid]</string></value></member> <member><name>signature</name><value><string>[sign]</string></value></member> </struct> </value> </param> </params> </methodCall>
Keterangan:
ITEM
|
KETERANGAN
|
[user]
|
Username
yang terdaftar di server PPOB
|
[time]
|
Waktu
transaksi dalam format YYYY-MM-DD HH:NN:SS. Contoh: 2011-08-20
11:40:30
|
[produk]
|
Produk PPOB yang tersedia di server. Untuk sementara yang
tersedia saat ini adalah: - TELKOM, mencakup semua produk
telkom seperti PSTN, Flexi Pasca ataupun Speedy - PLN -
HALO - PDAM meliputi beberapa kota dengan syntax produk
berbeda-beda yaitu antara lain:
Jakarta
= PDAMJKT
Denpasar
= PDAMDPR
Balikpapan
= PDAMBLPN
Manado
= PDAMMND
Pontianak
= PDAMPTN
Boyolali
= PDAMBYL
Cilacap
= PDAMCLP
Semarang
= PDAMSMR
Makasar
= PDAMPSM
|
[idpel]
|
Adalah
Nomor IDPelanggan yang akan di inquiry tagihannya. Bisa berupa
No. PSTN, No. Flexi Pasca, No. Speedy atau IDPelanggan PLN
|
[hppel]
|
Optional,
Nomor HP Pelanggan yang melakukan transaksi PPOB, bertujuan
sebagai no tujuan pengiriman notifikasi jika proses pembayaran
tagihan berhasil.
|
[trxid]
|
No
Transaksi disisi klien PPOB sebagai referensi disistem kami.
|
[sign]
|
Signature,
merupakan hasil MD5([user] + [password] + [time]
|
Response PPOB.Inquiry Format
Response:
<?xml version=”1.0″
encoding=”UTF-8″?> <methodResponse> <params> <param> <value> <struct> <member><name>code</name><value><string>[code]</string></value></member> <member><name>message</name><value><string>[msg]</string></value></member> <member><name>refid</name><value><string>[refid]</string></value></member> <member><name>trxid</name><value><string>[trxid]</string></value></member> </struct> </value> </param> </params> </methodResponse>
Contoh Response PPOB.Inquiry PRODUK
PLN
<?xml version="1.0"
encoding="UTF-8"?> <methodResponse> <params> <param> <value> <struct> <member><name>code</name><value><string>00</string></value></member> <member><name>message</name><value><string>idpel:517103002889|nmpel:HOSNAN| periode:JUL11,AGT11|tagihan:34905|usage:735900-743700|billqty:2| tarifdaya:R1/450|plnref:9562E91DFFEE45C18D13B6EFD92AB172| mkmref:00000000021051113018229011120109|nonsub:0|billtot:02|charge:35405| saldo:10000000</string></value></member> <member><name>refid</name><value><string>1234</string></value></member> <member><name>trxid</name><value><string>11082000602</string></value></member> </struct> </value> </param> </params>
PRODUK TELKOM
<?xml version="1.0"
encoding="UTF-8"?> <methodResponse> <params> <param> <value> <struct> <member><name>code</name><value><string>00</string></value></member> <member><name>message</name><value><string>idpel:0411491335|nmpel:ABD
KADIR DG
TULA| periode:AGT11|tagihan:197234|billqty:1| charge:195384|saldo:10000000 </string></value></member> <member><name>refid</name><value><string>1235</string></value></member> <member><name>trxid</name><value><string>0411491335</string></value></member> </struct> </value> </param> </params>
PRODUK HALO
<?xml version="1.0"
encoding="UTF-8"?> <methodResponse> <params> <param> <value> <struct> <member><name>code</name><value><string>00</string></value></member> <member><name>message</name><value><string>idpel:081122222|nmpel:NORMAN|tagihan:197234| billqty:1|charge:195384|saldo:10000000 </string></value></member> <member><name>refid</name><value><string>1235</string></value></member> <member><name>trxid</name><value><string>081122222</string></value></member> </struct> </value> </param> </params>
PRODUK PDAM
<?xml version="1.0"
encoding="UTF-8"?> <methodResponse> <params> <param> <value> <struct> <member><name>code</name><value><string>00</string></value></member> <member><name>message</name><value><string>idpel:081122222|nmpel:NORMAN|tagihan:197234| billqty:1|charge:195384|saldo:10000000 </string></value></member> <member><name>refid</name><value><string>1235</string></value></member> <member><name>trxid</name><value><string>081122222</string></value></member> </struct> </value> </param> </params>
PAYMENT
melakukan permintaan pembayaran
tagihan berdasarkan respon inquiry yang telah diterima.
<?xml version="1.0"
encoding="UTF-8"?> <methodCall> <methodName>PPOB.Payment</methodName> <params> <param> <value> <struct> <member><name>user</name><value><string>[user]</string></value></member> <member><name>waktu</name><value><string>[time]</string></value></member> <member><name>produk</name><value><string>[produk]</string></value></member> <member><name>idpel</name><value><string>[idpel]</string></value></member> <member><name>bayar</name><value><string>[jmltag]</string></value></member> <member><name>reffid</name><value><string>[trxid]</string></value></member> <member><name>signature</name><value><string>[sign]</string></value></member> </struct> </value> </param> </params> </methodCall>
Keterangan:
ITEM
|
KETERANGAN
|
[user]
|
Username
yang terdaftar di server PPOB
|
[time]
|
Waktu
transaksi dalam format YYYY-MM-DD HH:NN:SS. Contoh: 2011-08-20
11:40:30
|
[produk]
|
Produk PPOB
yang tersedia di server. Untuk sementara yang tersedia saat ini
adalah: - TELKOM, mencakup semua produk telkom seperti PSTN,
Flexi Pasca ataupun Speedy - PLN - HALO
|
[idpel]
|
Adalah
Nomor IDPelanggan yang akan di inquiry tagihannya. Bisa berupa
No. PSTN, No. Flexi Pasca, No. Speedy, IDPelanggan PLN, Nomor
Halo.
|
[jmltag]
|
Jumlah
tagihan sesuai dengan hasil response dari proses Inquiry.
|
[trxid]
|
No
Transaksi disisi klien PPOB sebagai referensi disistem kami.
|
[sign]
|
Signature,
merupakan hasil MD5([user] + [password] + [time])
|
|