[SPESIFIKASI H2H IP AMPM]

Transkripsi

1 2016 KiosAMPM By Anargya Sandy Afrian [SPESIFIKASI H2H IP AMPM] Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 1

2 BAB I PENDAHULUAN Modul Host To Host KiosAMPM menggunakan metode HTTP GET dengan respon XML, JSON ataupun Plaintext dengan keamanan transaksi menggunakan filter IP Address beserta Password IP yang sudah di daftarkan pada system kami. 1.1 HTTP GET HTTP GET adalah metode pengiriman data mengggunakan query string, jadi seluruh nilai pada form akan dikirim ke sisi server/file dan nilai dari form akan tampil pada baris URL / Address bar. Pada metode GET : 1. Variabel terlihat pada URL, data setiap variabel dipisahkan 2. Dibatasi oleh panjang string sebanyak 2047 karakter 3. Memungkinkan pengunjung langsung memasukkan nilai variabel pada form proses Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 1

3 BAB II SPESIFIKASI DAN RESPONSE 2.1 PARAMTER REQUEST & RESPONSE Untuk melakukan transaksi hanya menggunakan metode HTTP Get dan harus mengirimkan parameter-parameter berikut : 1. PARAMETER TRANSAKSI Berikut parameter-parameter yang harus di kirimkan : url transaksi : (ip dan port akan di infokan setelah terdaftar di h2h ampm) PARAMETER memberid pin password reffid msisdn produk resp KETERANGAN kode / id mitra yang di dapatkan setelah terdaftar pin yang di dapatkan setelah terdaftar password transkai h2h didapatkan seteleh terdaftar id transaksi dari mitra yang berguna untuk referensi (harus unik) nomor tujuan yang akan di topup produk yang akan di transaksikan tipe response yang di inginkan (xml, json atau plaintext) Contoh parameter menggunakan HTTP GET dengan response XML: trx.php?memberid=k00001&reffid=99847&msisdn= &pin=1123f&passwor d=938470&produk=xl5&resp=xml Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 2

4 Response Transaksi Sukses: XML : <ampm> <rc>0000</rc> <status>sukses</status> <memberid>k00001</memberid> <msisdn> </msisdn> <produk>xl5</produk> <reffid>99847</reffid> <sn> </sn> <trxid>2282</trxid> <message> #2282 IM5 ke: SUKSES. SN/Ref: Sisa saldo Rp. 250,000 - Rp. 10,000 = Rp. 240,000! </message> </ampm> JSON : {"rc":"0000","status":"sukses","memberid":"k00001","msisdn":" ","produk":"xl5", "reffid":"99847","sn":" ","message":"#2282 IM5 ke: SUKSES. SN\/Ref: Sisa saldo Rp. 250,000 - Rp. 10,000 = Rp. 240,000!","trxid":"2282"} PLAINTEXT : ":"#2282 IM5 ke: SUKSES. SN\/Ref: Sisa saldo Rp. 250,000 - Rp. 10,000 = Rp. 240,000! Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 3

5 Response Transaksi Gagal: XML : <ampm> <rc>0015</rc> <status>gagal</status> <memberid>k00001</memberid> <msisdn> </msisdn> <produk>xl5</produk> <reffid>12345</reffid> <sn></sn> <message> #2234 XL/AXIS XL GAGAL. Nomor tujuan salah. Sal </message> <trxid>2234</trxid> </ampm> JSON : {"rc":"0015","status":"gagal","memberid":"k00001","msisdn":" ","produk":"xl5"," reffid":"12345","sn":"","message":"xl\/axis XL GAGAL. Nomor tujuan salah. Sal PLAINTEXT : #2234 XL\/AXIS XL GAGAL. Nomor tujuan salah. Sal Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 4

6 Response Transaksi Pending: XML : <ampm> <rc>0061</rc> <status>pending</status> <memberid>k00001</memberid> <msisdn> </msisdn> <produk>xl5</produk> <reffid>12345</reffid> <sn></sn> <trxid>15412</trxid> <message> #15412 XL akan di Saldo = </message> </ampm> JSON : {"rc": "0061","status": "pending","memberid": "K00001","msisdn": " ", "produk":"xl5","reffid": "12345","trxid": "15412", "message": " #15412 XL akan di Saldo = 5.113"} PLAINTEXT : #15412 XL akan di Saldo = Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 5

7 Response Transaksi Sudah Pernah: XML : <ampm> <rc>0054</rc> <status>sudah pernah</status> <memberid>k00001</memberid> <msisdn> </msisdn> <produk>xl5</produk> <reffid>12345</reffid> <sn> </sn> <trxid>2281</trxid> <message> #2281 IM sdh pernah jam 10:55:00, status sukses. SN/Ref: Trx ke-2/hr: IM pin. Saldo 7,469 </message> </ampm> JSON : {"rc": "0054","status": "sudah pernah","memberid": "K00001","msisdn": " ","produk": "xl5","reffid": "12345","sn": " ","trxid":"2281","message": "#2281 IM sdh pernah jam 10:55:00, status sukses. SN/Ref: Trx ke-2/hr: IM pin. Saldo 7,469" } PLAINTEXT : #2281 IM sdh pernah jam 10:55:00, status sukses. SN/Ref: Trx ke-2/hr: IM pin. Saldo 7,469 Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 6

8 Response Transaksi Error: XML : <ampm> <rc>0005</rc> <status>error</status> <memberid>k00001</memberid> <msisdn> </msisdn> <produk>xl5</produk> <reffid>12345</reffid> <sn></sn> <trxid></trxid> <message> Server tidak meresponse silahkan hubungi CS kami </message> </ampm> JSON : {"rc": "0005","status": "error","memberid": "K00001","msisdn": " ","produk":"xl5","reffid": "12345","message":"Server tidak meresponse silahkan hubungi CS kami"} PLAINTEXT : Server tidak meresponse silahkan hubungi CS kamia Note: akan mendapatkan status akan di proses ( pending/menunggu jawaban ) jika sudah sukses akan mengirimkan ke callback yang sudah di daftarkan pada system atau dengan metode kirim ulang dengan parameter yang sama akan mendapatkan respon sudah pernah ( transaksi double ) Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 7

9 2. PARAMETER CEK TRANSAKSI Berikut parameter-parameter yang harus di kirimkan : url transaksi : (ip dan port akan di infokan setelah terdaftar di h2h ampm) reffid msisdn produk PARAMETER KETERANGAN id transaksi dari mitra yang berguna untuk referensi No tujuan atau id pelanggan Kode produk yang sebelumnya di transaksikan memberid Id/kode mitra yang didapatkan setelah terdaftar resp Tipe respon yang di inginkan ( xml,json,plaintext ) RESPONSE yang diberikan oleh server sama dengan response transaksi Contoh paramter Metode HTTP GET : cekstatus.php?reffid=3&msisdn= &produk=xl5&memberid=k00003 Contoh Output/Screen Note : : Jika di status rc bukan 0000 dan 0054 maka silahkan ulangi transaksinya Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 8

10 3. PARAMETER CEK SALDO/BALANCE Berikut parameter-parameter yang harus di kirimkan : url transaksi : (ip dan port akan di infokan setelah terdaftar di h2h ampm) PARAMETER memberid pin password resp KETERANGAN kode / id mitra yang di dapatkan setelah terdaftar pin yang di dapatkan setelah terdaftar password transkai h2h didapatkan seteleh terdaftar tipe response yang di inginkan (xml, json atau plaintext) Contoh Parameter Metode HTTP GET: balance.php?memberid=k00003&pin=134652&password=test Contoh Output/Screen : Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 9

11 Response Cek Saldo/Balance Sukses: XML : <ampm> <rc>0000</rc> <status>sukses</status> <memberid>k00001</memberid> <message> Yth. testingakun, ID K Saldo Rp Dalam proses Rp. 0 Pakai hari ini Rp </message> </ampm> JSON : {"rc":"0000","status":"sukses","memberid":"k00001","message":"yth. testingakun, ID K Saldo Rp Dalam proses Rp. 0 Pakai hari ini Rp "} PLAINTEXT : Yth. testingakun, ID K Saldo Rp Dalam proses Rp. 0 Pakai hari ini Rp LIST RESPONSE CODE (RC) RC STATUS KETERANGAN 0000 sukses Sukses 0061 pending Ada kesalah pada server silahkan hubungi cs kami 0062 pending Server error silahkan hubungi cs kami 0015 gagal Transkasi gagal (message berdasarkan kondisi gagal) 0005 error Server tidak meresponse silakan hubungi cs kami 0033 error Parameter yang anda kirimkan salah atau kurang 0063 error Transaksi Tidak ditemukan Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 10

12 BAB III BERKAS DOKUMENTASI Berkas dokumentasi bertujuan untuk mempermudah mencari response dalam tahap develn berikut informasi mengenai berkas dokumentasi kami. 1. Cek Saldo ( balance.php ) Cek Saldo Menggunakan parameter yang benar balance.php?memberid=k00003&pin=134652&password=test Cek Saldo Dengan Parameter Salah/Kurang balance.php?memberid=k00003&pin= Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 11

13 Cek Saldo Dengan parameter benar tapi password/pin salah/kosong balance.php?memberid=k00003&pin=134652&password=testing Cek Saldo Dengan Parameter benar tapi member id, pass, pin salah balance.php?memberid=k &pin=543&password=543 Cek Saldo Dengan parameter benar tapi memberid salah pin benar dan password benar balance.php?memberid=k00004&pin=134652&password=test Note : Mitra K00004 tidak memiliki password channel ip dan tidak memiliki channel ip jika memiliki channel ip akan mendapatkan respon messages Invalid PIN Or Password Cek Saldo dengan parameter benar memberid, pin & password benar tapi ip yang di daftarkan tidak cocok balance.php?memberid=k00003&pin=134652&password=test Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 12

14 Cek Saldo dengan parameter benar tapi password IP belum di set balance.php?memberid=k00003&pin=134652&password=test Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 13

15 2. Transaksi ( Trx.php ) Transaksi Dengan parameter benar dan value benar trx.php?memberid=k00003&reffid=1&msisdn= &pin=134652&password=test& produk=ht2&resp=xml Note: akan mendapatkan status akan di proses ( pending/menunggu jawaban ) jika sudah sukses akan mengirimkan ke callback yang sudah di daftarkan pada system atau dengan metode kirim ulang dengan parameter yang sama akan mendapatkan respon sudah pernah ( transaksi double ) seperti di bawah Dengan asumsi untuk H2H tidak bisa 1 Demon 1 No yang sama pada hari yang sama. Server Akan Mengirimkan Balasan Status Pada Callback menggunakan METODE HTTP GET Ke IP Callback Yang Sudah Di Daftarkan Dengan Parameter Seperti Di Bawah : /?dest= &message=#15843 HT2 ke: SUKSES. SN: Sisa saldo Rp Rp = Rp ! Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 14

16 Transaksi Dengan Password atau PIN Salah dengan refid sama trx.php?memberid=k00003&reffid=1&msisdn= &pin=134652&password=testi &produk=ht2&resp=xml Transaksi Dengan Password atau PIN salah dengan refid beda trx.php?memberid=k00003&reffid=2&msisdn= &pin=134652&password=testi &produk=ht2&resp=xml Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 15

17 Transaksi IP Address Salah/Belum Terdaftar Pada System Transaksi IP Address Sudah Terdaftar Transaksi Dengan Parameter Benar NoTujuan Salah ( Prefix ) trx.php?memberid=k00003&reffid=2&msisdn= &pin=134652&password=test& produk=xl5&resp=xml Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 16

18 Transaksi dengan Kode Produk Salah/Tidak Ada trx.php?memberid=k00003&reffid=2&msisdn= &pin=134652&password=test& produk=ml5&resp=xml Contoh Respon Json Contoh Respon Plain Text Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 17

19 3. Cek Status ( cekstatus.php ) Cek Status Dengan Parameter yang kumplit dan benar cekstatus.php?reffid=3&msisdn= &produk=xl5&memberid=k00003 Note : Jika di status rc bukan 0000 dan 0054 maka silahkan ulangi transaksinya Cek Status Dengan Parameter yang salah/kurang cekstatus.php?reffid=3&msisdn= &produk=xl5&member=k00003 Layanan Mitra KiosAMPM Anargya Media Indonesia Halaman 18