API to API

Terakhir diperbarui: 28 Agustus 2026.

API-to-API digunakan saat sistem mitra ingin menghubungkan backend mereka langsung ke Miharogames tanpa iframe. Integrasi ini cocok untuk mitra yang sudah punya sistem sendiri, katalog sendiri, kasir sendiri, atau dashboard monitoring transaksi sendiri.

Kegunaan utama

Dengan integrasi ini, mitra dapat:

• Membuat atau menyinkronkan akun customer, warung, outlet, cabang, atau anak mitra;
• Menyinkronkan katalog produk (Product Sync & List) sesuai daftar price plan mitra;
• Melakukan pengecekan data pelanggan (Inquiry) sebelum transaksi;
• Melakukan checkout untuk melihat harga final dan promo aktif sebelum transaksi;
• Membuat transaksi (Payment) menggunakan saldo, koin, payment gateway, atau kombinasi yang tersedia;
• Mengecek status transaksi secara real-time (Payment Status / Transaction Status);
• Menerima callback (Webhook) otomatis saat status transaksi selesai atau di-update.

Struktur akun

Transaksi dari akun customer di bawah mitra dapat dipantau dari dashboard mitra utama. Di sisi mitra, akun customer ini bisa disebut warung, outlet, cabang, kasir, anak mitra, atau istilah lain sesuai operasional mitra.

Pengaturan komersial

Daftar produk, harga, dan aturan komisi untuk integrasi API-to-API ditentukan di awal oleh tim Miharogames sesuai kesepakatan bisnis dengan mitra. Mitra tidak perlu mengirim konfigurasi harga atau komisi pada request API.

Jika pengaturan komersial API belum aktif, endpoint produk, checkout, atau payment dapat mengembalikan error konfigurasi. Hubungi tim Miharogames untuk aktivasi atau perubahan kesepakatan.

Alur integrasi

1. Daftarkan Webhook: Hubungi tim Miharogames untuk mengonfigurasi callback_url mitra guna menerima callback otomatis.
2. Otentikasi: Gunakan X-SECRET-KEY mitra untuk mengidentifikasi request sistem Anda.
3. Provision Akun: Buat atau sinkronkan akun customer/warung/outlet/cabang/kasir via POST /client/v2/customer/provision_account untuk mendapatkan token akses customer.
4. Sync Katalog: Ambil katalog produk menggunakan GET /client/v2/product/sync, lalu simpan dan tampilkan produk dari database sistem mitra. GET /client/v2/product/list bersifat opsional jika butuh lookup langsung saat runtime.
5. Inquiry (Wajib untuk E-Wallet / PLN): Lakukan verifikasi nomor pelanggan menggunakan POST /client/v2/inquiry untuk mengambil data nama dan validasi akun tujuan.
6. Checkout: Lakukan validasi harga final, promo, dan ketersediaan stok via POST /client/v2/checkout.
7. Payment: Buat pembayaran transaksi via POST /client/v2/payment menggunakan partner_trx_id yang unik per hari.
8. Callback & Monitoring: Terima callback otomatis pada URL webhook mitra atau lakukan polling status via GET /client/v2/payment/status.

Diagram alur integrasi

Berikut adalah gambaran alur sequence integrasi backend-to-backend antara sistem Mitra dan Miharogames API:

Environment

Header autentikasi

Endpoint client/v2 menggunakan secret key mitra. Endpoint yang mengakses data akun menggunakan bearer token sesuai akun yang sedang digunakan.

X-SECRET-KEY: {partner_secret_key}
Authorization: Bearer o8coocg8k0ss4wcgk0o8........

Format umum response

{
  "status": true,
  "data": {},
  "message": "OK"
}

Jika gagal, status bernilai false dan message berisi alasan yang dapat ditampilkan atau dicatat di sistem mitra.

Status utama

Response transaksi menggunakan dua status agar pembayaran dan proses transaksi mudah dibaca.

Pembayaran dan proses transaksi dipisah karena transaksi bisa sudah dibayar, tetapi hasil transaksi masih diproses.