ISO TOSS
Host2Host API
Spesifikasi & Dokumentasi
1. URL Transaksi (TOPUP)
URL untuk transaksi diberikan oleh pihak server.
Formatnya sebagai berikut:
http://host:port/IsoHubTossWebService/H2HTransaction.asmxContoh :
http://171.0.0.3:8080/IsoHubTossWebService/H2HTransaction.asmxMethod
Deskripsi
Mengirim transaksi topup ke server.
Parameter
Nama Tipe Deskripsi
---------------------------------------------
memberID string kode member
customerHpNumber string nomor selular yang ditopup
voucherCodeAlias string kode produk
refTopUpClient string ID referensi dari client waktu melakukan topup
timeRequest string format ‘yyyy-MM-dd HH:mm:ss’
sign string MD5(timeRequest+userPassword)
* MD5 Generator untuk sign di atas bisa memakai tool bantuan di sini.
HTTP POST
POST /IsoHubTossWebService/H2HTransaction.asmx/H2HTopUpTransaction HTTP/1.1
Host: 171.0.0.3:8080
Content-Type: application/x-www-form-urlencoded
Content-Length: length
memberID=string&customerHpNumber=string&voucherCodeAlias=string&refTopUpClient=string&timeRequest=string&sign=string
HTTP GET
GET /IsoHubTossWebService/H2HTransaction.asmx/H2HTopUpTransaction?memberID=string&customerHpNumber=string&voucherCodeAlias=string&refTopUpClient=string&timeRequest=string&sign=string HTTP/1.1
Host: 171.0.0.3:8080
Result
Nama Tipe Deskripsi
------------------------------------------------------------------
result string status transaksi,
‘OK’
‘InvalidLogin’
‘MemberNotExist’
‘InvalidIPAddress’
topUpTransactionPK integer nomor seri/ID transaksi
message string pesan lengkap balasan dari server
XML Topup Response
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<StructH2HTopUpTransaction xmlns="
http://topupsolution.com/WebServices">
<Result>string</Result>
<RefTopUpClient>string</RefTopUpClient>
<TopUpTransactionPK>long</TopUpTransactionPK>
<Message>string</Message>
</StructH2HTopUpTransaction>
2. Reversal
Reversal transaksi akan diarahkan ke IP VPN masing masing server pada port: 7777. Silahkan dilakukan konfigurasi disisi aplikasi
Berikut adalah konfigurasi XML POST yang akan dikirim dari HTTP Reversal Forwarder ke URL client :
<?xml version="1.0" encoding="utf-8"?>
<Reversal>
<MemberID></MemberID>
<TopUpPK></TopUpPK>
<RefTopUpClient></RefTopUpClient>
<TransactionTime></TransactionTime>
<HPNumber></HPNumber>
<VoucherCode></VoucherCode>
<SN></SN>
<Status></Status>
<Signature></Signature>
</Reversal>
Contoh :
<?xml version="1.0" encoding="utf-8"?>
<Reversal>
<MemberID>AGEN-B</MemberID>
<TopUpPK>199777</TopUpPK>
<RefTopUpClient>1234567890</RefTopUpClient>
<TransactionTime>2011-01-07 09:41:30</TransactionTime>
<HPNumber>087879999999</HPNumber>
<VoucherCode>X25</VoucherCode>
<SN>11020243007920</SN>
<Status>Success</Status>
<Signature>428415EB-83A6-4DBC-A58D-0B85DD36842C</Signature>
</Reversal>
Client memiliki 2 alternatif untuk mendevelop aplikasi XML Reversal Receiver :
1. Client bisa menerima langsung XML POST di alamat URL tertentu
langsung melalui aplikasinya sendiri.
2. Disediakan juga simple client XML Reversal Receiver yang setiap kali menerima
data XML POST akan membuat sebuah file unik di folder tertentu dengan
format nama file yyyy-MM-dd-hh-mm-ss-tttt.xml
contoh : 2011-02-02-16-28-16-5262.xml
yang mana client kemudian dapat membuat suatu simple aplikasi untuk melakukan
polling process di folder tersebut, dengan flow sbb :
1. Search file yang umurnya paling tua atau yang lebih duluan diterima.
2. Open and Read file
3. Proses
4. Close and Delete file
3. Check Balance
URL :
http://171.0.0.3:7777/CheckBalance/Parameter:
MemberID : userID member TOSS
TimeRequest : format YYYY-MM-DD hh:nn:ss
Sign : MD5(timeRequest+userPassword)
Response:
<?xml version="1.0" encoding="utf-8"?>
<data>
<balancepo>243349950</balancepo>
<denom_10000>107280</denom_10000>
<msisdn>6287857000000</msisdn>
<minimumbalance>12800000</minimumbalance>
<denom_5000>113579</denom_5000>
<dealername>Dompul TOSS</dealername>
<expireddate>20121231</expireddate>
<denom_1000>0</denom_1000>
</data>
Sok ah, di haturanan ka para dealer otomax supados linggih di ieu thread kanggo masihan tutorial na... haturnuhun...