H2H IP XML

INTERKONEKSI HOST2HOST

 

 

SUPPORTED BY INTEGRATED RELOAD SYSTEM

IT TEAM 01/11/2017

TANGGALREVISION
01/01/2013RELEASE
01/01/2015PENAMBAHAN PROTOKOL XML
01/11/2017PENAMBAHAN METHOD XML INQ & PAY

 

ALUR KOMUNIKASI DATA

 

 

  1. Mitra mengirimkan topUpRequest xml atau httpget ke server IRS untuk melakukan transaksi pulsa/ppob.
  2. IRS akan merespons transaksi diproses jika semua validasi sudah dilewati, atau merespons gagal, jika ada kesalahan dalam proses validasi transaksi.
  3. IRS akan mengirimkan status transaksi ke URL report mitra berupa httpget atau XML topupreport
  4. Mitra Harus mendaftarkan IP address sebagai identitas/keamanan akun.

 

PARAMETER

  1. TRANSAKSI.

          TERDAPAT 2 FORMAT TRANSAKSI YAITU HTTP GET DAN XML POST.HTTP GET.

 

A. HTTP GET

<IDRS>ID MITRA/RESELLER
<PIN>PIN
<USER>User dan Password Didapat dari ketik resetweb.pin
kirim ke sms/telegram
<PASS>
<KODE>Kodeproduk yg di transaksikan: S10
<Tujuan>No.tujuan transaksi.
<IDTRX>ID Transaksi Mitra.

 

Url : https://uwaispusath2h.web.id/api/h2h?id=<IDRS>&pin=<PIN>&user=<USER>&pass=<PASS>& kodeproduk=<KODE>&tujuan=<TUJUAN>&counter=1&idtrx=<IDTRX>

contoh :

https://uwaispusath2h.web.id/api/h2h?id=IS0002&pin=11212&user=23FGHx&pass=2928475&k odeproduk=S10&tujuan=081236797479&counter=1&idtrx=10120304

RESPONS :

{“success”:true,”msg”:”Request X25 ke 081805566661 under proses..”}

Catatan Pengulangan Transaksi:

Request transaksi/pengulangan berdasarkan ID transaksi Mitra, artinya jika transaksi dengan ID transaksi mitra yg sama. maka di system diIRS hanya akan mengecek status transaksi. (sukses/pending/gagal) transaksi sebelumnya JIKA ada.Pengulangan transaksi dengan Id/Reff Trx yg berbeda akan menjadi Transaksi BARU.

 

        B. XML RPC

Fungsi topUpRequest

Mitra megirimkan XML-RPC dengan meth parameter berikut ini

keytypeketerangan
JENIS TRANSAKSI
METHOD NAME1.topUpRequest
2.INQ
3.PAY
INQ: Untuk Inquiry/cek tagihan ppob
PAY: untuk Payment/Bayar tagihan PPOB
MSISDNString 20No Telp yang didaftarkan di IRS
REQUESTIDString 20RequestID from Mitra
PINString 20PIN
NOHPString 20MSISDN yang akan diisi
NOMString 10Kode Produk

 

<?xml version=”1.0″?>

<methodCall>

<methodName>topUpRequest</methodName>

<params>

<param>

<value>

<struct>

<member>

<name>MSISDN</name>

<value><string>0818055661122</string></value>

</member>

<member>

<name>REQUESTID</name>

<value><string>11002200</string></value>

</member

<member>

<name>PIN</name>

<value><string>1122</string></value>

</member>

<member>

<name>NOHP</name>

<value><string>0818882220</string></value>

</member>

<member>

<name>NOM</name>

<value><string>S10</string></value>

</member>

</struct>

</value>

</param>

</params></methodCall>

 

Ack topUpRequest :

Berikut adalah respons yg diberikan dari IRS ke mitra

KEYTYPEKETERANGAN
RESPONSECODEString‘00’: BERHASIL
‘68’: PENDING
selain itu adalah gagal.
REQUESTIDString 20ID TRX MITRA.
MESSAGEString 200Message dari IRS
TRANSACTIONIDStringTransaction ID yang di generate dari IRS

 

<?xml version=”1.0″?>

<methodResponse>

<params>

<param>

<value>

<struct>

<member>

<name>RESPONSECODE</name>

<value><string>00</string></value>

</member>

<member>

<name>REQUESTID</name>

<value><string>11002200</string></value>

</member>

<member>

<name> MESSAGE</name>

<value>

<string> TRX I5.085738082844 BERHASIL, HRG:5.400 SN: 1169076472. SISA SALDO:48.670.962</string></value>

</member>

<member>

<name> TRANSACTIONID </name>

<value><string>11993876</string></value>

</member>

</struct>

</value>

</param>

</params>

</methodResponse>

 

 

REPORT TRANSAKSI/ REVERSAL

 

System IRS akan mengirim balasan SUKSES/GAGAL ke url Mitra Dengan format sebagai berikut.:

  1. Protokol HTTP GET

http://urlmitra?serverid=xxxx&clientid=xxxx&statuscode=1&kp=HX10&msisdn=081 2345678&sn=302020202&msg=pesan contoh http://123.123.123.123:8080/report.php?serverid=12512344&clientid=3245&status code=1&kp=HI5&msisdn=085738082844 &sn=1169076472&msg=TRX I5.085738082844 BERHASIL, HRG:5.400 SN: 1169076472. SISA SALDO:48.670.962

FIELDKETERANGAN
SERVERIDIDTRANSAKSI/REFF SERVER IRS
CLIENTIDIDTRANSAKSI/REFF CLIENT/MITRA
STATUSCODESTATUSTRANSAKSI SERVER
1=SUKSES 2=GAGAL
KPKode Produk
MSISDNNOMOR TUJUAN TRANSAKSI
SNNOMOR SERI TRANSAKSI (SN OPERATOR)
MSGKETERANGAN/PESAN TRANSAKSI

 

  1. XML

Format XML yg dikirimkan oleh sistem irs ke url Mitra:

<?xml version=”1.0″?>

<methodResponse>

<params>

<param>

<value>

<struct>

<member>

<name>RESPONSECODE</name>

<value><string>00</string></value>

</member>

<member>

<name>REQUESTID</name>

<value><string>123456</string></value>

</member>

<member>

<name>MESSAGE</name>

<value><string>TOP UP BERHASIL</string></value>

</member>

<member>

<name>TRANSACTIONID</name>

<value><string>666333</string></value>

</member>

</struct>

</value>

</param>

</params>

</methodResponse>