Dokumen panduan ini menjelaskan cara melakukan interkoneksi dengan Software iRS, interkoneksi ini biasa dikenal dengan istilah Host to Host (H2H). Dalam dokumen panduan ini tidak mencakup penyelesaian apabila terjadi error atau kesalahan.
Informasi:
Dokumen panduan ini ditujukan untuk pengguna Software iRS yang ingin
melakukan interkoneksi secara mandiri. Mengingat proses interkoneksi ada
resiko kesalahan dan butuh pengetahuan teknis, disarankan untuk proses
interkoneksi dilakukan oleh tim Technical Support.
Catatan Rilis
Informasi:
- Software iRS versi 9 ke bawah menggunakan 2 protokol untuk
interkoneksi yaitu HTTP GET dan XML RPC. - Software iRSX (versi 10) menggunakan 1 protokol untuk interkoneksi
yaitu HTTP GET.
Adapun software iRSX adalah merupakan versi terbaru dari pengembangan software iRS dengan informasi produk sebagai berikut:
Alur Komunikasi Interkoneksi
Penjelasan mengenai alur komunikasi interkoneksi sebagai berikut:
- Server mitra mengirimkan format transaksi via protokol HTTP GET atau XML-RPC ke server iRS untuk melakukan transaksi pulsa/ppob.
- Server iRS akan merespons transaksi diproses jika semua validasi sudah dilewati atau merespons gagal jika ada kesalahan dalam proses validasi transaksi.
- Server iRS akan mengirimkan status transaksi ke URL Report server mitra via protokol HTTP GET atau XML-RPC.
- Untuk keamanan server mitra wajib mendaftarkan IP Address sebagai identitas/keamanan akun.
Transaksi dan Parameter
Transaksi dapat menggunakan 2 jenis protokol yaitu HTTP GET atau XML RPC. Penjelasan format transaksi dan parameter sebagai berikut:
Protokol HTTP GET
Format transaksi PULSA
Contoh Request:
● ip_addres misal 114.141.55.68
● port misal 8888
Contoh Response:
Format transaksi PPOB
Contoh Request:
● ip_addres misal 114.141.55.68
● port misal 8888
Contoh Response:
Pengulangan Transaksi
Request transaksi/pengulangan berdasarkan ID transaksi mitra, artinya
jika transaksi dengan ID transaksi mitra yang sama, maka di sistem
iRS hanya akan mengecek status transaksi (sukses/pending/gagal)
transaksi sebelumnya jika ada. Pengulangan transaksi dengan Id/Reff
Trx yang berbeda akan menjadi transaksi BARU.
Protokol XML-RPC
Server mitra melakukan transaksi via protokol XML-RPC dengan parameter berikut ini:
Format Transaksi
Contoh Request:
● methodName: topUpRequest
● MSISDN: 0818055661122
● REQUESTID: 11002200
● PIN: 1122
● NOHP: 0818882220
● NOM: S10
Contoh Response:
Report Transaksi/ Reversal
Sistem IRS akan mengirim balasan SUKSES/GAGAL ke URL mitra dengan format sebagai berikut:
Protokol HTTP GET
Balasan menggunakan parameter berikut ini:
Format Balasan:
Contoh Balasan:
● urlmitra: 123.123.123.123:8080/report.php
● serverid: 12512344
● clientid: 3245
● statuscode: 1
● msisdn: 085738082844
● sn: 1169076472
● msg: TRX I5.085738082844 BERHASIL, HRG:5.400 SN: 1169076472. SISA
SALDO:48.670.962
Protokol XML-RPC
Contoh Balasan:
● RESPONSECODE: 00
● REQUESTID: 123456
● MESSAGE: TOP UP BERHASIL
● TRANSACTIONID: 666333
Tabel Response Code:
