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.asmx
Contoh :
http://171.0.0.3:8080/IsoHubTossWebService/H2HTransaction.asmx

Method
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>