API Documentation

API Reference

Selamat datang di dokumentasi API MasterPulsa Gateway. Semua permintaan (request) harus dikirimkan menggunakan metode POST dengan tipe konten application/json.

Otentikasi (Signature)

Setiap request wajib menyertakan parameter sign untuk memvalidasi identitas mitra. Nilai sign dihasilkan menggunakan algoritma MD5. Rumus penggabungan string untuk di-hash berbeda-beda pada setiap endpoint.

Catatan Penting: Parameter apikey Anda TIDAK BOLEH dikirimkan di dalam payload request. apikey bersifat rahasia dan hanya digunakan di sisi server mitra untuk menghitung hash MD5.

POST

/api/balance

Endpoint ini digunakan untuk mengecek sisa saldo Anda.

Rumus Sign:

MD5(username + apikey + memberID)

Parameter JSON:

Field	Wajib	Deskripsi
username	Ya	Username akun mitra Anda.
memberID	Ya	ID Agen / Member ID Anda.
pin	Ya	PIN transaksi Anda.
password	Ya	Password akun Anda.
sign	Ya	Hasil hash MD5.

Contoh Request Payload

{
  "username": "mitra01",
  "memberID": "MBR12345",
  "pin": "123456",
  "password": "password123",
  "sign": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
}

POST

/api/trx

Endpoint ini digunakan untuk melakukan transaksi pengisian pulsa/PPOB.

Rumus Sign:

MD5(username + apikey + refID)

Parameter JSON:

Field	Wajib	Deskripsi
username	Ya	Username akun mitra Anda.
product	Ya	Kode produk (misal: S10).
qty	Ya	Jumlah/Kuantitas (default: 1).
dest	Ya	Nomor tujuan / ID Pelanggan.
refID	Ya	ID Transaksi dari sisi mitra (harus unik).
memberID	Ya	ID Agen / Member ID Anda.
pin	Ya	PIN transaksi Anda.
password	Ya	Password akun Anda.
sign	Ya	Hasil hash MD5.

Contoh Request Payload

{
  "username": "mitra01",
  "product": "S10",
  "qty": "1",
  "dest": "081234567890",
  "refID": "TRX-20261012-001",
  "memberID": "MBR12345",
  "pin": "123456",
  "password": "password123",
  "sign": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
}

POST

/api/saldo

Endpoint ini digunakan untuk request penambahan saldo (Tiket Deposit).

Rumus Sign:

MD5(username + apikey + amount)

Parameter JSON:

Field	Wajib	Deskripsi
username	Ya	Username akun mitra Anda.
memberid	Ya	ID Agen / Member ID Anda.
amount	Ya	Nominal request tiket (hanya angka).
pin	Ya	PIN transaksi Anda.
password	Ya	Password akun Anda.
sign	Ya	Hasil hash MD5.

Contoh Request Payload

{
  "username": "mitra01",
  "memberid": "MBR12345",
  "amount": "500000",
  "pin": "123456",
  "password": "password123",
  "sign": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
}

Respon & Reply

Respon Transaksi (Proses)

status=1&message=S10.081352136547 akan diproses @19:02:02. Saldo 330,742,469

status=1&message=novita S10.082165218004 masih dalam proses.Jangan di ulang lagi. Mohon ditunggu ya bosku

Sukses Transaksi

report?t=190205&refid=F5633921907&status=20&price=10950&memberID=MBR0001&message=S10.081313750893 B3RHASIL SN:04136600000072953346.Sal 351,990-10,950=Rp.341,040 @29/04/26 17:26:33

Gagal Transaksi

report?t=190827&refid=F5633&status=52&price=10365&memberID=MBR0001&message=MAAF Trx,S10.082165218004 GAGAL, Coba cek ulang nomor tujuan, Saldo 175,553.@25/04 17:08:18

status=52&message=MAAF Trx,S10.082165218004 GAGAL, Coba cek ulang nomor tujuan, Saldo 175,553.@25/04 17:08:18

report?t=185947&refid=F56339219&status=40&price=10365&memberID=MBR0001&message=MAAF,S10 ke 081298768086 GAGAL. . Saldo 330,752,834 @18:59:47

report?t=190628&refid=F5633&status=45&price=10365&memberID=MBR0001&message=MAAF, S10.081372136547 GAGAL. Produk Sedang ditutup Gunakan Nominal Lain. Saldo 330,742,469 @19:06:28

report?t=190659&refid=F5633&status=47&price=10365&memberID=MBR0001&message=T10.08972265874 GAGAL karena Sedang mengalami GANGGUAN . kami akan informasikan apabila sudah kembali normal . Saldo 882.279 R# @11:24

Kode Respon (Status)

Berikut adalah daftar kode respon (status) yang mungkin dikembalikan oleh server.

Status Code	Keterangan
2	Menunggu jawaban
20	Sukses
40	Gagal
43	Saldo tidak cukup
45	Stok kosong
46	Transaksi double
47	Produk gangguan
50	Dibatalkan
52	Tujuan salah
53	Tujuan di luar wilayah
54	Kode area tidak sesuai
56	Nomor blacklist
58	Nomor tidak aktif
59	Harga tidak sesuai
61	Qty tidak sesuai
69	Cutoff

Informasi Response (Format XML/Text)

Saat ini API Gateway akan merespon menggunakan format asal dari server Engine. Pastikan sistem Anda siap mem-parsing balasan berformat teks plain atau XML sesuai standar engine yang kami gunakan.