[SPESIFIKASI H2H IP AMPM]

2016 KiosAMPM By Anargya Sandy Afrian

[SPESIFIKASI H2H IP AMPM] 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. Memungkinkan pengunjung langsung memasukkan nilai variabel pada form proses

Layanan Mitra KiosAMPM | Anargya Media Indonesia

Halaman 1

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 msisdn

id transaksi dari mitra yang berguna untuk referensi (harus unik) 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


Halaman 2

Response Transaksi Sukses: XML : 0000 <status>sukses <memberid>K00001 <msisdn>087764766373 <produk>xl5 99847 <sn>0098983948739847686 2282 <message> #2282 IM5 ke:086386487387 SUKSES. SN/Ref: 0098983948739847686. Sisa saldo Rp. 250,000 Rp. 10,000 = Rp. 240,000!

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!


Halaman 3

Response Transaksi Gagal: XML : 0015 <status>gagal <memberid>K00001 <msisdn>087764766373 <produk>xl5 12345 <sn> <message> #2234 XL/AXIS XL5.0815683414255 GAGAL. Nomor tujuan salah. Sal 748 @19:33:08 2234

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 : #2234 XL\/AXIS XL5.0815683414255 GAGAL. Nomor tujuan salah. Sal 748 @19:33:08


Halaman 4

Response Transaksi Pending: XML : 0061 <status>pending <memberid>K00001 <msisdn>087764766373 <produk>xl5 12345 <sn> 15412 <message> #15412 XL5.087764766373 akan di proses @16:09:15. Saldo 10.643 – 5530 = 5.113

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 : #15412 XL5.087764766373 akan di proses @16:09:15. Saldo 10.643 – 5530 = 5.113


Halaman 5

Response Transaksi Sudah Pernah: XML : 0054 <status>sudah pernah <memberid>K00001 <msisdn>087764766373 <produk>xl5 12345 <sn>0098983948739847686 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

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


Halaman 6

Response Transaksi Error: XML : 0005 <status>error <memberid>K00001 <msisdn>087764766373 <produk>xl5 12345 <sn> <message> Server tidak meresponse silahkan hubungi CS kami

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 )


Halaman 7

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

Note : : Jika di status rc bukan 0000 dan 0054 maka silahkan ulangi transaksinya


Halaman 8

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 :


Halaman 9

Response Cek Saldo/Balance Sukses: XML : 0000 <status>sukses <memberid>K00001 <message> Yth. testingakun, ID K00003. Saldo Rp. 748. Dalam proses Rp. 0 Pakai hari ini Rp. 6.500

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


Halaman 10

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=134652


Halaman 11

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 balance.php?memberid=k00003&pin=134652&password=test


Halaman 12

Cek Saldo dengan parameter benar tapi password IP belum di set balance.php?memberid=k00003&pin=134652&password=test


Halaman 13

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!


Halaman 14

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


Halaman 15

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


Halaman 16

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

Contoh Respon Plain Text


Halaman 17

3. Cek Status ( cekstatus.php ) Cek Status Dengan Parameter yang kumplit dan benar cekstatus.php?reffid=3&msisdn=087764766373&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=087764766373&produk=xl5&member=k00003


Halaman 18

[SPESIFIKASI H2H IP AMPM]

Recommend Documents