Pengenalan H2H API
Platform Host-to-Host (H2H) Melostore.id dirancang dengan mengutamakan performa tinggi dan latensi rendah. Setiap transaksi diproses secara prioritas agar sukses dikirim dalam hitungan detik.
Uji Coba Sandbox Mode
Setiap akun baru didefaultkan dalam Sandbox Mode. Anda dapat menguji seluruh response code dan alur integrasi tanpa memotong saldo H2H nyata.
Otentikasi Header
Setiap pemanggilan endpoint H2H membutuhkan verifikasi kredensial ganda yang dikirimkan melalui header HTTP request:
| Header Key | Deskripsi |
|---|---|
| X-API-Key | Prefix API Key publik dari dashboard partner. |
| X-Secret-Key | Secret key rahasia yang digenerate oleh partner. |
Retrieve Profile
Endpoint ini digunakan untuk memperoleh informasi lengkap profil mitra, tingkat tier active, rate limit sisa, dan status sandbox mode.
Retrieve Balance
Endpoint efisien berlatensi rendah untuk memeriksa saldo H2H yang tersedia saat ini secara real-time.
Retrieve Product Pricelist
Mengambil daftar produk aktif yang tersedia untuk H2H beserta detail modal beli dan harga khusus tier partner Anda.
Membuat Transaksi
Mengirimkan request pembelian voucher atau pulsa. Request diproses secara asinkron dan status akhirnya akan dikirim via Webhook callback.
Request Body (JSON Parameters):
| Parameter | Status | Deskripsi |
|---|---|---|
| sku_code | Wajib | Kode SKU produk (contoh: ML86). |
| customer_target | Wajib | Nomor target ID / nomor tujuan penerima pulsa. |
| customer_target_zone | Opsional | Nomor zone ID game (jika dibutuhkan, seperti Mobile Legends). |
| idempotency_key | Opsional | Kunci idempoten unik dari sistem Anda untuk mencegah pemesanan ganda. |
Cek Status Transaksi
Melakukan polling / pengecekan status manual untuk satu ID transaksi tertentu.
Webhook Callback
Setiap transaksi berhasil diselesaikan atau gagal, backend Melostore akan mengirimkan POST request callback ke URL webhook terkonfigurasi.
Validasi Tanda Tangan Webhook
Gunakan header signature X-H2H-Signature yang dikirim untuk memvalidasi keaslian body request. Tanda tangan diperoleh dari hash HMAC SHA256 dari payload JSON mentah menggunakan webhook_secret akun Anda.
curl -X GET "https://api.melostore.id/api/v1/h2h/profile" \ -H "X-API-Key: YOUR_API_KEY" \ -H "X-Secret-Key: YOUR_SECRET_KEY"
{
"success": true,
"message": "Welcome to Melostore H2H API Service",
"version": "1.0.0"
}Kirim header Content-Type: application/json pada request POST.