[SPESIFIKASI H2H IP AMPM]

(1)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman

1

2016

KiosAMPM

By Anargya Sandy Afrian

[SPESIFIKASI H2H IP AMPM]

(2)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 1

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)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 2

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 : https://ip-public-ampm:port/trx.php (ip dan port akan di infokan setelah

terdaftar di h2h ampm)

PARAMETER

KETERANGAN

memberid

kode / id mitra yang di dapatkan setelah terdaftar

pin

pin yang di dapatkan setelah terdaftar

password

password transkai h2h didapatkan seteleh terdaftar

reffid

id transaksi dari mitra yang berguna untuk referensi (harus

unik)

msisdn

nomor tujuan yang akan di topup

produk

produk yang akan di transaksikan

resp

tipe response yang di inginkan (xml, json atau plaintext)

Contoh parameter menggunakan HTTP GET dengan response XML:

trx.php?memberid=K00001&reffid=99847&msisdn=087764766373&pin=1123f&passwor

d=938470&produk=xl5&resp=xml

(4)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 3

Response Transaksi Sukses:

XML :

<ampm> <rc>0000</rc> <status>sukses</status> <memberid>K00001</memberid> <msisdn>087764766373</msisdn> <produk>xl5</produk> <reffid>99847</reffid> <sn>0098983948739847686</sn> <trxid>2282</trxid> <message>

#2282 IM5 ke:086386487387 SUKSES. SN/Ref: 0098983948739847686. Sisa saldo Rp. 250,000 - Rp. 10,000 = Rp. 240,000!

</message> </ampm>

JSON :

{"rc":"0000","status":"sukses","memberid":"K00001","msisdn":"087764766373","produk":"xl5", "reffid":"99847","sn":" 0098983948739847686","message":"#2282 IM5 ke:086386487387 SUKSES. SN\/Ref: 0098983948739847686. Sisa saldo Rp. 250,000 - Rp. 10,000 = Rp. 240,000!","trxid":"2282"}

PLAINTEXT :

":"#2282 IM5 ke:086386487387 SUKSES. SN\/Ref: 0098983948739847686. Sisa saldo Rp. 250,000 - Rp. 10,000 = Rp. 240,000!

(5)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 4

Response Transaksi Gagal:

XML :

<ampm> <rc>0015</rc> <status>gagal</status> <memberid>K00001</memberid> <msisdn>087764766373</msisdn> <produk>xl5</produk> <reffid>12345</reffid> <sn></sn> <message>

#2234 XL/AXIS XL5.0815683414255 GAGAL. Nomor tujuan salah. Sal 748 @19:33:08 </message>

JSON :

{"rc":"0015","status":"gagal","memberid":"K00001","msisdn":"087764766373","produk":"xl5"," reffid":"12345","sn":"","message":"XL\/AXIS XL5.0815683414255 GAGAL. Nomor tujuan salah. Sal 748 @19:33:08","trxid":"2234"}

PLAINTEXT :

(6)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 5

Response Transaksi Pending:

XML :

<ampm> <rc>0061</rc> <status>pending</status> <memberid>K00001</memberid> <msisdn>087764766373</msisdn> <produk>xl5</produk> <reffid>12345</reffid> <sn></sn> <trxid>15412</trxid> <message>

#15412 XL5.087764766373 akan di proses @16:09:15. Saldo 10.643 – 5530 = 5.113 </message>

</ampm>

JSON :

{"rc": "0061","status": "pending","memberid": "K00001","msisdn": "087764766373", "produk":"xl5","reffid": "12345","trxid": "15412", "message": "

#15412 XL5.087764766373 akan di proses @16:09:15. Saldo 10.643 – 5530 = 5.113"}

PLAINTEXT :

(7)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 6

Response Transaksi Sudah Pernah:

XML :

<ampm> <rc>0054</rc> <status>sudah pernah</status> <memberid>K00001</memberid> <msisdn>087764766373</msisdn> <produk>xl5</produk> <reffid>12345</reffid> <sn>0098983948739847686</sn> <trxid>2281</trxid> <message>

#2281 IM5.086386487387 sdh pernah jam 10:55:00, status sukses. SN/Ref: 0098983948739847686. Trx ke-2/hr: IM5.086386487387.pin. Saldo 7,469 </message>

</ampm>

JSON :

{"rc": "0054","status": "sudah pernah","memberid": "K00001","msisdn": "087764766373","produk": "xl5","reffid": "12345","sn":

"0098983948739847686","trxid":"2281","message": "#2281 IM5.086386487387 sdh pernah jam 10:55:00, status sukses. SN/Ref: 0098983948739847686. Trx ke-2/hr: IM5.086386487387.pin. Saldo 7,469" }

PLAINTEXT :

#2281 IM5.086386487387 sdh pernah jam 10:55:00, status sukses. SN/Ref: 0098983948739847686. Trx ke-2/hr: IM5.086386487387.pin. Saldo 7,469

(8)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 7

Response Transaksi Error:

XML :

<ampm> <rc>0005</rc> <status>error</status> <memberid>K00001</memberid> <msisdn>087764766373</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":

"087764766373","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 )

(9)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 8

2. PARAMETER CEK TRANSAKSI

Berikut parameter-parameter yang harus di kirimkan :

url transaksi :

https://ip-public-ampm:port/cekstatus.php (ip dan port akan di infokan

setelah terdaftar di h2h ampm)

PARAMETER

KETERANGAN

reffid

id transaksi dari mitra yang berguna untuk referensi

msisdn

No tujuan atau id pelanggan

produk

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=087764766373&produk=xl5&memberid=k00003

Contoh Output/Screen

(10)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 9

3. PARAMETER CEK SALDO/BALANCE

Berikut parameter-parameter yang harus di kirimkan :

url transaksi :

https://ip-public-ampm:port/balance.php (ip dan port akan di infokan

setelah terdaftar di h2h ampm)

PARAMETER

KETERANGAN

memberid

kode / id mitra yang di dapatkan setelah terdaftar

pin

pin yang di dapatkan setelah terdaftar

password

password transkai h2h didapatkan seteleh terdaftar

resp

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 :

(11)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 10

Response Cek Saldo/Balance Sukses:

XML :

<ampm> <rc>0000</rc> <status>sukses</status> <memberid>K00001</memberid> <message>

Yth. testingakun, ID K00003. Saldo Rp. 748. Dalam proses Rp. 0 Pakai hari ini Rp. 6.500 </message>

</ampm>

JSON :

{"rc":"0000","status":"sukses","memberid":"K00001","message":"Yth. testingakun, ID K00003. Saldo Rp. 748. Dalam proses Rp. 0 Pakai hari ini Rp. 6.500"}

PLAINTEXT :

Yth. testingakun, ID K00003. Saldo Rp. 748. Dalam proses Rp. 0 Pakai hari ini Rp. 6.500

2.2 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

(12)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 11

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

(13)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 12

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=k0000000&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

(14)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 13

Cek Saldo

dengan parameter benar tapi password IP belum di set

(15)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 14

2. Transaksi ( Trx.php )

Transaksi

Dengan parameter benar dan value benar

trx.php?memberid=K00003&reffid=1&msisdn=089615119455&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=089615119455&message=#15843 HT2 ke:089615119455 SUKSES.

SN:1215160937101973102. Sisa saldo Rp. 10.673 - Rp. 2.050 = Rp. 8.623!

(16)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 15

Transaksi

Dengan Password atau PIN Salah dengan refid sama

trx.php?memberid=K00003&reffid=1&msisdn=089615119455&pin=134652&password=testi

&produk=HT2&resp=xml

Transaksi

Dengan Password atau PIN salah dengan refid beda

trx.php?memberid=K00003&reffid=2&msisdn=089615119455&pin=134652&password=testi

&produk=HT2&resp=xml

(17)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 16

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=081564766373&pin=134652&password=test&

produk=xl5&resp=xml

(18)

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 17

Transaksi

dengan Kode Produk Salah/Tidak Ada

trx.php?memberid=K00003&reffid=2&msisdn=087764766373&pin=134652&password=test&

produk=ML5&resp=xml

Contoh Respon Json

(19)