API to API

Products

Sinkronisasi produk Miharogames ke katalog mitra.

Terakhir diperbarui: 2 September 2026.

Products digunakan untuk mengambil katalog Miharogames yang tersedia untuk mitra. Produk dan harga yang tampil mengikuti pengaturan komersial API-to-API milik mitra.

Rekomendasi utama: gunakan Product Sync untuk menyimpan katalog Miharogames ke database sistem mitra. Setelah tersimpan, sistem mitra dapat menampilkan produk dari database sendiri ke customer/warung/outlet/cabang/kasir. Product List bersifat opsional jika mitra ingin mengambil produk aktif langsung dari Miharogames saat runtime.

Daftar produk dan harga API ditentukan oleh tim Miharogames sesuai kesepakatan bisnis dengan mitra. Jika konfigurasi belum aktif, endpoint dapat mengembalikan pesan Price plan API mitra belum dikonfigurasi, hubungi tim Miharogames untuk informasi lebih lanjut.

Product Category

Produk memiliki alur berbeda bergantung jenis transaksinya.

Kategori	Kapan digunakan	Halaman
Pulsa & Paket Data	Produk nominal reguler tanpa inquiry.	Pulsa & Paket Data
Top Up E-Money / E-Wallet	Produk e-wallet yang wajib inquiry nomor akun terlebih dahulu.	Top Up E-Money / E-Wallet
Listrik PLN	Produk PLN Prabayar, Pascabayar, dan Non-Taglis dengan alur inquiry khusus.	Listrik PLN

Produk inquiry internal seperti INQ* tidak ditampilkan di Product Sync atau Product List. Kode tersebut digunakan melalui endpoint Inquiry, bukan sebagai produk checkout langsung.

Product Sync

Endpoint ini digunakan untuk menyamakan katalog produk ke sistem mitra. Gunakan endpoint ini sebagai sumber utama untuk menyimpan produk Miharogames ke database mitra. Product Sync cukup menggunakan X-SECRET-KEY mitra, tanpa Authorization: Bearer token customer.

Product Sync mengembalikan produk active dan inactive sesuai pengaturan price plan mitra. Simpan keduanya agar sistem mitra dapat memperbarui katalog lokal. Produk dengan status inactive tidak dapat digunakan untuk transaksi dan sebaiknya dinonaktifkan atau disembunyikan di aplikasi mitra.

Mitra disarankan melakukan Product Sync secara berkala, misalnya menggunakan cronjob setiap 15 menit, untuk memperbarui status dan harga produk di database lokal mitra.

GET /client/v2/product/sync?sub_category=prabayar&page=1&pageSize=50
X-SECRET-KEY: {partner_secret_key}

Query

Query	Wajib	Keterangan
`sub_category`	Ya	Kode text sub kategori, contoh `prabayar`.
`page`	Tidak	Nomor halaman. Default `1`.
`pageSize`	Tidak	Jumlah data per halaman. Maksimal `100`.

Contoh Response

{
  "status": true,
  "data": {
    "products": [
      {
        "id": 15676,
        "code": "S20",
        "name": "TELKOMSEL REGULER 20.000",
        "description": "",
        "pricing": {
          "base_price": 20000,
          "final_price": 20000
        },
        "promotion": null,
        "status": "active",
        "operator": {
          "id": 1,
          "name": "Telkomsel",
          "logo": "https://dev-asset.miharogames.co.id/uploads/files/m_operator_logo/telkomsel.svg"
        }
      }
    ]
  },
  "pagination": {
    "total": 1,
    "page": 1,
    "perPage": 50,
    "totalPages": 1
  },
  "message": "OK"
}

Product List

Endpoint ini digunakan untuk mengambil produk aktif yang dapat dibeli pada saat permintaan dilakukan. Endpoint ini opsional karena katalog utama sebaiknya sudah disimpan dari Product Sync.

Berbeda dari Product Sync, Product List hanya mengembalikan produk yang aktif dan tersedia untuk transaksi. Gunakan endpoint ini jika aplikasi mitra perlu membaca produk langsung dari Miharogames saat customer/warung/outlet/cabang/kasir memilih produk.

GET /client/v2/product/list?phone_number=082340378657&sub_category=prabayar
Authorization: Bearer o8coocg8k0ss4wcgk0o8........
X-SECRET-KEY: {partner_secret_key}

Query

Query	Wajib	Keterangan
`phone_number`	Ya	Nomor tujuan. Untuk pulsa/data harus format Indonesia diawali `08`.
`sub_category`	Ya	Kode text sub kategori produk.
`reference_id`	Kondisional	Wajib khusus `pln-prabayar`, menggunakan `reference_id` inquiry sukses yang belum kedaluwarsa.

Contoh Response

{
  "status": true,
  "data": {
    "operator": {
      "id": 1,
      "name": "Telkomsel",
      "logo": "https://dev-asset.miharogames.co.id/uploads/files/m_operator_logo/telkomsel.svg"
    },
    "products": [
      {
        "id": 15676,
        "code": "S20",
        "name": "TELKOMSEL REGULER 20.000",
        "description": "",
        "pricing": {
          "base_price": 20000,
          "final_price": 20000
        },
        "promotion": null
      }
    ]
  },
  "message": "OK"
}

Product Status

Status	Muncul di	Arti
`active`	Product Sync	Produk tersedia dan dapat ditawarkan ke customer.
`inactive`	Product Sync	Produk tidak tersedia untuk transaksi. Mitra sebaiknya menonaktifkan produk ini di katalog lokal.

Product List tidak menampilkan field status karena endpoint ini hanya mengembalikan produk yang aktif dan siap digunakan untuk transaksi.

Kode Response

HTTP	Kondisi	Message
`200`	Produk berhasil dimuat, kosong, atau subkategori belum tersedia.	`OK`, `Subkategori tidak ditemukan.`, `Subkategori belum tersedia.`
`400`	Query wajib tidak valid, termasuk `reference_id` PLN Prabayar.	Lihat `message` pada response.
`401`	Secret key salah atau tidak aktif.	`Secret Key wajib diisi.` / `Secret Key tidak valid.`
`500`	Gangguan sistem.	Mengikuti pesan error server.

Previous CustomerProvision account dan profile customer warung/cabang. Next Pulsa & Paket DataIntegrasi katalog produk Pulsa & Paket Data.