API to API

Terakhir diperbarui: 20 Agustus 2026.

API-to-API dipakai 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:

Login akun mitra utama dan mendapatkan token akses untuk kebutuhan akses dashboard/laporan mitra;
Membuat atau memakai akun customer, warung, outlet, cabang, atau anak mitra;
Menyinkronkan katalog produk sesuai daftar produk mitra;
Melakukan checkout untuk melihat harga final sebelum transaksi;
Membuat transaksi memakai saldo, koin, payment gateway, atau kombinasi yang tersedia;
Mengecek status pembayaran dan status transaksi;
Mengambil riwayat transaksi customer;
Menerima callback saat status transaksi berubah.

Struktur akun

Akun mitra utama menjadi pintu integrasi. Akun di bawahnya bisa disebut customer, warung, outlet, cabang, atau anak mitra sesuai istilah yang dipakai mitra.

Akun	Fungsi
Mitra utama	Login awal, monitoring lintas customer/warung/cabang, laporan, dan akses product sync.
Customer/warung/cabang	Akun yang melakukan checkout, payment, dan melihat riwayat transaksinya sendiri.

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

Simpan X-SECRET-KEY yang diberikan Miharogames.
Login mitra dan verifikasi OTP untuk mendapat token mitra utama.
Buat atau sinkronkan akun customer/warung/cabang bila dibutuhkan.
Sync produk dari akun mitra utama.
Checkout produk untuk validasi nomor tujuan, harga, promo, saldo, dan koin.
Buat payment memakai partner_trx_id yang unik.
Baca payment status atau transaction history untuk monitoring.
Terima callback untuk update transaksi otomatis.

Environment

Environment	Base URL	Penggunaan
Development	`https://dev-api.miharogames.co.id`	Testing integrasi dan credential sandbox.
Production	`https://api.miharogames.co.id`	Transaksi live dan credential production.

Header autentikasi

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

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 memakai dua status agar pembayaran dan proses transaksi mudah dibaca.

Field	Fungsi	Value
`payment_status`	Status pembayaran saldo, koin, atau payment gateway.	`UNPAID`, `PAID`, `EXPIRED`, `FAILED`
`transaction_status`	Status proses transaksi di Miharogames.	`WAITING_PAYMENT`, `PROCESSING`, `SUCCESS`, `FAILED`

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

Rekomendasi integrasi

Gunakan partner_trx_id unik dari sistem mitra untuk setiap transaksi.
Simpan transaction_number dari Miharogames untuk kebutuhan pencarian dan rekonsiliasi.
Jangan bergantung hanya pada callback; sediakan polling status sebagai fallback.
Buat receiver callback idempotent memakai event_id atau partner_trx_id.
Catat semua request dan response penting di sistem mitra untuk audit transaksi.

Next AuthenticationLogin mitra, OTP, dan token akses API.