FORMAT XML - M-PULSA

ALAMAT SERVER
URL	http://xxx.xxx.xxx.xxx:13165 atau https://xxx.xxx.xxx.xxx:13165
PARAM	timeout=x (optional dalam detik, jika param timeout tidak dicantumkan, maka server akan memberi timeout 20detik )
CONTOH	http://203.201.171.xxx:13165
	http://203.201.171.22:13165/?timeout=10

HTTP REQUEST
POST : http://xxx.xxx.xxx.xxx:9900

<?xml version="1.0"?>
<evoucher>
   <command>TOPUP</command>
   <product>PRODUCTID</product>
   <userid>USERID</userid>
   <time>HH24MISS</time>
   <msisdn>MSISDN</msisdn>
   <partner_trxid>TRXID</partner_trxid>
   <signature>SIGN</signature>
   <hd>HARGAMIN</hd>
   <cluster>KODEPOS</cluster>
</evoucher>

HTTP RESPONSE

<?xml version="1.0"?>
<evoucher>
   <result>0</result>
   <msg>Diproses. Pengisisian pulsa berhasil. No transaksi 10001. dst </msg>
   <trxid>10001</trxid>
   <partner_trxid>12345</partner_trxid>
   <product>S20 </product>
   <msisdn>0812345678</msisdn>
   <price>20000</price>
   <balance>1980000</balance>
</evoucher>

REVERSAL
HTTP REQUEST GET

Parameter : 
cust_id,server_trxid, client_trxid, product, msisdn, status, price, balance, vn, vsn, msg

ALUR

1. TOPUP

<?xml version="1.0"?>
<evoucher>
   <command>TOPUP</command>
   <product>S20</product>
   <userid>userid</userid>
   <time>191001</time>
   <msisdn>0812345678</msisdn>
   <partner_trxid>12345</partner_trxid>
   <hd>19000</hd>
   <cluster>62351</cluster>
   <signature>CQ4HBVFTVlJSXg==</signature>
</evoucher>

PENJELASAN
<product>	Kode produk Dealer, misalnya S20 untuk Simpati 20rb, M10 untuk Mentari 10rb, dsb.
	Kode bisa diganti Nominal Pulsa, maka Dealer akan otomatis menyesuaikan dg kode sesuai operator MSISDN.
<userid>	userid yang digunakan untuk proses topup (akan diberikan oleh Dealer)
<time>	Waktu transaksi dalam jam, menit, detik (HH24MISS). Contoh: 191001
<msisdn>	Nomor yang akan di topup
	Nomor referensi transaksi Anda
<hd>	(optional, number) 1harga cek maksimum, jika harga diatas nilai element ini, maka SIPServer akan langsung menolak topup.
<cluster>	(optional) cluster/area member yang diisi pulsa.
<signature>	signature sesuai dengan perhitungan di bawah :
	a= + 4 digit terakhir
	b= 4 digit terakhir dibalik + password 6 digit (password akan diberikan oleh Dealer)
	= a XOR b lalu di base64encoded

Contoh Signature :

Time = 191001
Msisdn = 0812345678
Password = abcdef
a = 1910015678
b = 8765abcdef
SIGN = base64encoded(a XOR b) => CQ4HBVFTVlJSXg==

Perhitungan signature bisa dibaikan, dengan cara mengganti isinya dengan password h2h saja, misal <signature>123456</signature>

Contoh XML yang dikirim :

<?xml version="1.0"?>
<evoucher>
   <command>TOPUP</command>
   <product>S20</product>
   <userid>iduser</userid>
   <time>191001</time>
   <msisdn>0812345678</msisdn>
   <partner_trxid>12345</partner_trxid>
   <signature>CQ4HBVFTVlJSXg==</signature>
</evoucher>

2. ACKNOWLEDGE

Response singkron balasan dari SIPServer.
Contoh :

<?xml version="1.0"?>
<evoucher>
<result>0</result>
<msg>Diproses. Pengisisian pulsa berhasil. No transaksi 10001. dst </msg>
<trxid>10001</trxid>
<partner_trxid>12345</partner_trxid>
<product>S20 </product>
   	<msisdn>0812345678</msisdn>
	<price>20000</price>
	<balance>1980000</balance>
</evoucher>

PENJELASAN
<resut>	(number) status kode hasil transaksi.
	Result 0 => Transaksi Diproses.
	Result selain 0 => Transaksi GAGAL, misal :
	11 => Transaksi GAGAL
	10 => Transaksi GAGAL karena topup yang sama sudah diterima sebelumnya dan statusnya MASIH DALAM PROSES (duplicate order).
	40 => Transaksi GAGAL karena topup yang sama sudah diterima sebelumnya dan statusnya sudah BERHASIL (duplicate order).

3. REPLY ASINGKRON & REVERSAL

Untuk setiap topup, dikirim balik status topup dengan method HTTP GET dengan parameter sebagai berikut :

PENJELASAN
cust_id
server_trxid
client_trxid	Nomor referensi transaksi Anda.
product	Kode produk
msisdn	Nomor yang akan di topup
status	0 => Berhasil, 11 => Gagal
price	Harga jual (number)
balance	Saldo akhir (number)
vn	Voucher number (nomor kartu fisik/gesek)
vsn	Serial Number
msg	Pesan

Contoh Berhasil :

http://xxx.xxx.xxx.xxx/reversal.php?cust_id=iduser&server_trxid=d5d8g5b8&client_trxid=12345&product=S20&msisdn=0812345678&status=0&price=20000&balance=1980000&vn=&sn=25030325878745&msg=BERHASIL+

Contoh Gagal :

http://xxx.xxx.xxx.xxx/reversal.php?cust_id=iduser&server_trxid=d5d8g5b8&client_trxid=12345&product=S20&msisdn=0812345678&status=11&price=&balance=&vn=&sn=&msg=Gagal+No+HP+Salah

PPOB

Layanan Payment Poin Online Bank (PPOB) PPOB dimana anda dapat melakukan pembayaran tagihan PLN, Telkom, Speedy, dll.

Tahap :

Partner mengirim perintah (Topup) dengan kode produk CEKXXX
Lalu, Partner mengirim perintah (Topup) dengan kode produk BAYARKXXX
Topup dengan kode BAYARXXX harus dikirim pada hari yang sama.

Paramater tambahan pada reply Asingkron & Reversal :

http://xxx.xxx.xxx.xxx/reversal.php?cust_id=H20059&server_trxid=1t5ii7hom&client_trxid=4krtus4n7&product=PLN50&msisdn=22130984135&status=0&result=0&price=48500&balance=1444461&vn=&sn=10380428506823299821&msg=BERHASIL+&ppob_tag=50000&ppob_adm=1600&ppob_bilqty=0& infoSMS=Token%3D10380428506823299821%0A%0ANama%3A+HATIB+KY+SOSRO%0ATD%3A+R1%2F450%0AAdm%3A+1600%0APPN%3A+0%0APPJ%3A+4400%0AAngs%3A+0%0ARpToken%3A+44000%0AJmKWH%3A+106.1s

PENJELASAN
ppob_tag	Jumlah tagihan termasuk admin bank
ppob_adm	Admin Bank
ppob_bilqty	Jumlah periode bulan
infoSMS	SMS yang harus dikirim ke pelanggan

HTTP REQUEST POST : http://xxx.xxx.xxx.xxx:9900