Dokumentasi API DEMO LYZHUSTORE
Halo, selamat datang di Dokumentasi Integrasi DEMO LYZHUSTORE .
Getting Started
Untuk Kamu yang sudah mempunyai web topup game, Kamu dapat menghubungkan website topup game Kamu menggunakan Open API dari DEMO LYZHUSTORE.
Untuk memulai Kamu memerlukan API ID dan API KEY (tersedia di menu Akun setelah akses API diaktifkan) serta mendaftarkan IP Address server Kamu (whitelist IP) untuk proses Authentication ke sistem kami. Whitelist IP dan Callback URL diatur sendiri di menu Akun. Whitelist IP wajib diisi untuk membuat order (transaksi). Jika dikosongkan, endpoint baca (saldo, profil, layanan, status) tetap bisa diakses dari IP mana pun, tetapi order akan ditolak.
Callback dikirim dari server kami ke URL Kamu. Jika server Kamu memakai firewall, izinkan request masuk dari server kami. Hubungi admin untuk mengetahui IP Address server kami.
BASE URL:
-
Production: https://demo.lyzhustore.com
Autentikasi
Semua endpoint memakai method POST dengan Content-Type: application/x-www-form-urlencoded. Tiga parameter di bawah ini wajib dikirim pada setiap request.
Gabungkan api_id dan api_key (tanpa pemisah), lalu hash dengan MD5.
$signature = md5($apiId . $apiKey);{
"status": false,
"msg": "API ID atau API KEY Tidak Ditemukan"
}{
"status": false,
"msg": "Pengguna dengan kredensial API yang diberikan tidak ditemukan"
}{
"status": false,
"msg": "Signature Tidak Valid. Silakan periksa kredensial API Anda"
}{
"status": false,
"msg": "IP 127.0.0.1 tidak ada dalam whitelist"
}{
"status": false,
"msg": "Terlalu banyak percobaan otentikasi API yang gagal dari IP Anda. Coba lagi dalam 5 menit."
}{
"status": false,
"msg": "Terlalu banyak permintaan. Silakan coba lagi dalam 42 detik."
}API Utama
Untuk layanan Top Up Game, Voucher, dan PPOB. Layanan SMM dan Aplikasi Premium memakai endpoint terpisah, lihat tab API SMM dan API Aplikasi Premium.
- Saldo dipotong saat order dibuat. Jika status akhir Gagal, saldo otomatis dikembalikan.
- Harga yang dipakai mengikuti role akun Kamu (Basic / Gold / Platinum).
- Semua request memakai method POST dengan parameter api_id, api_key, dan signature (lihat bagian Autentikasi).
curl -X POST "{BASE_URL}/api/balance" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "api_id={API_ID}" \
-d "api_key={API_KEY}" \
-d "signature={SIGNATURE}"- Saldo yang sama dipakai untuk API Utama, API SMM, dan API Aplikasi Premium.
- role adalah role akun Kamu (Basic, Gold, atau Platinum) yang menentukan harga di Daftar Layanan.
{
"status": true,
"msg": "berhasil mendapatkan data saldo",
"data": {
"balance": 150000,
"role": "Basic"
}
}curl -X POST "{BASE_URL}/api/service" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "api_id={API_ID}" \
-d "api_key={API_KEY}" \
-d "signature={SIGNATURE}"- Gunakan field id sebagai service_id saat membuat order.
- harga otomatis sesuai role akun Kamu (Basic, Gold, atau Platinum), jadi cukup tampilkan apa adanya.
- Layanan dengan status "tidak aktif" tidak dapat dipesan.
[
{
"status": true,
"msg": "berhasil mendapatkan data layanan",
"data": {
"id": "1",
"game": "Mobile Legends",
"nama_layanan": "14 Diamonds ( 13 + 1 Bonus )",
"harga": 3310,
"status": "aktif"
}
},
...
]curl -X POST "{BASE_URL}/api/order" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "api_id={API_ID}" \
-d "api_key={API_KEY}" \
-d "signature={SIGNATURE}" \
-d "order_id=TESTING-001" \
-d "service_id=1" \
-d "target_id=12345678" \
-d "target_server=1234" \
-d "jumlah=1"- order_id final dibentuk sistem: order_id Kamu + "_" + 25 karakter acak, contoh TESTING-001_4KX9M2Q7WB1ZN5P6R0T8Y3U2A. Simpan order_id dari response untuk cek status dan mencocokkan callback.
- Jika jumlah lebih dari 1, sistem membuat satu order terpisah untuk setiap jumlah (lihat all_orders). Saldo hanya dipotong untuk order yang berhasil dibuat.
- Status awal umumnya Proses. Jika provider langsung membalas berhasil, status bisa langsung Sukses. Hasil akhir dikirim lewat Callback, atau cek lewat endpoint Cek Status.
{
"status": true,
"msg": "Pesanan Anda sedang diproses. Mohon tunggu!",
"data": {
"order_id": "TESTING-001_4KX9M2Q7WB1ZN5P6R0T8Y3U2A",
"nama_layanan": "14 Diamonds ( 13 + 1 Bonus )",
"service_id": "1",
"target_id": "12345678",
"target_server": "1234",
"jumlah_diproses": 1,
"jumlah_gagal": 0,
"status": "Proses",
"note": "Pesanan Anda sedang diproses. Mohon tunggu!",
"all_orders": [
"TESTING-001_4KX9M2Q7WB1ZN5P6R0T8Y3U2A"
]
}
}{
"status": false,
"msg": "order_id wajib diisi"
}{
"status": false,
"msg": "order_id ini sudah pernah digunakan. Silakan cek statusnya melalui API status.",
"data": {
"order_id": "TESTING-001_4KX9M2Q7WB1ZN5P6R0T8Y3U2A",
"status": "Sukses"
}
}{
"status": false,
"msg": "service_id tidak ditemukan"
}{
"status": false,
"msg": "Layanan sedang tidak aktif"
}{
"status": false,
"msg": "target_id wajib diisi"
}{
"status": false,
"msg": "Maksimal jumlah order adalah 10"
}{
"status": false,
"msg": "Saldo anda tidak mencukupi untuk 1 order. Total yang diperlukan: 3.310"
}{
"status": false,
"msg": "Pesanan Anda gagal diproses. Mohon coba lagi."
}{
"status": false,
"msg": "Akun Anda telah disuspend sehingga tidak dapat melakukan transaksi via API. Alasan: -"
}curl -X POST "{BASE_URL}/api/status" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "api_id={API_ID}" \
-d "api_key={API_KEY}" \
-d "signature={SIGNATURE}" \
-d "order_id=TESTING-001_4KX9M2Q7WB1ZN5P6R0T8Y3U2A"{
"status": true,
"msg": "Detail transaksi berhasil didapatkan",
"data": {
"order_id": "TESTING-001_4KX9M2Q7WB1ZN5P6R0T8Y3U2A",
"data_id": "12345678 (1234)",
"service": "Mobile Legends - 14 Diamonds ( 13 + 1 Bonus )",
"status": "Sukses",
"note": "Pesanan Anda telah berhasil diproses!",
"sn": "SN123456789",
"price": 3310
}
}{
"status": false,
"msg": "order_id tidak ditemukan",
"data": {
"order_id": "",
"status": "error"
}
}API SMM
Untuk layanan Social Media Marketing (followers, likes, views, dan sejenisnya). Dipisah dari API Utama karena order memakai target berupa link / username dan kuantitas, diproses bertahap, dan hasilnya memiliki progres (start_count, remains).
- Autentikasi, signature, dan saldo sama dengan API Utama. Cek saldo memakai endpoint /api/balance.
- Status berjalan: Pending, In progress, lalu Completed. Status Partial berarti sebagian kuantitas tidak terkirim, sisanya dikembalikan ke saldo (lihat refund_amount).
- Status Canceled berarti pesanan dibatalkan dan saldo dikembalikan penuh.
- Progres pesanan disinkronkan otomatis oleh sistem, jadi callback tetap terkirim walaupun Kamu tidak mengecek status.
curl -X POST "{BASE_URL}/api/smm/service" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "api_id={API_ID}" \
-d "api_key={API_KEY}" \
-d "signature={SIGNATURE}"- harga otomatis sesuai role akun Kamu dan dihitung per 1.000 kuantitas. Total harga = harga x quantity / 1000.
- quantity pada order harus berada di antara min dan max layanan. Jika max bernilai null berarti tidak ada batas maksimal.
[
{
"status": true,
"msg": "berhasil mendapatkan data layanan SMM",
"data": {
"id": "1725",
"platform": "Instagram",
"nama_layanan": "Followers Indonesia - Garansi 30 Hari",
"min": 100,
"max": 10000,
"harga": 25500,
"status": "aktif"
}
},
...
]curl -X POST "{BASE_URL}/api/smm/order" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "api_id={API_ID}" \
-d "api_key={API_KEY}" \
-d "signature={SIGNATURE}" \
-d "order_id=SMM-001" \
-d "service_id=1725" \
-d "target=https://instagram.com/username" \
-d "quantity=1000"- Satu request = satu order. Kuantitas dikirim lewat quantity (bukan jumlah seperti API Utama).
- order_id final dibentuk sistem: order_id Kamu + "_" + 25 karakter acak.
- Status awal Proses dengan smm_status Pending. Progres dan hasil akhir dikirim lewat Callback, atau cek lewat endpoint Cek Status SMM.
{
"status": true,
"msg": "Pesanan SMM berhasil dibuat. Pesanan sedang diproses",
"data": {
"order_id": "SMM-001_7QH2N8VXD4M1KZ5B9R3T6W0YC",
"nama_layanan": "Instagram - Followers Indonesia - Garansi 30 Hari",
"service_id": "1725",
"target": "https://instagram.com/username",
"quantity": 1000,
"total_harga": 25000,
"status": "Proses",
"smm_status": "Pending",
"note": "Pesanan Anda sedang diproses. Mohon tunggu!"
}
}{
"status": false,
"msg": "order_id wajib diisi"
}{
"status": false,
"msg": "order_id ini sudah pernah digunakan. Silakan cek statusnya melalui API status.",
"data": {
"order_id": "SMM-001_7QH2N8VXD4M1KZ5B9R3T6W0YC",
"status": "Sukses"
}
}{
"status": false,
"msg": "service_id tidak ditemukan"
}{
"status": false,
"msg": "Layanan sedang tidak aktif"
}{
"status": false,
"msg": "target wajib diisi"
}{
"status": false,
"msg": "quantity harus antara 100 sampai 10000"
}{
"status": false,
"msg": "Saldo anda tidak mencukupi. Total yang diperlukan: 25.000"
}{
"status": false,
"msg": "Akun Anda telah disuspend sehingga tidak dapat melakukan transaksi via API. Alasan: -"
}curl -X POST "{BASE_URL}/api/smm/status" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "api_id={API_ID}" \
-d "api_key={API_KEY}" \
-d "signature={SIGNATURE}" \
-d "order_id=SMM-001_7QH2N8VXD4M1KZ5B9R3T6W0YC"{
"status": true,
"msg": "Detail transaksi berhasil didapatkan",
"data": {
"order_id": "SMM-001_7QH2N8VXD4M1KZ5B9R3T6W0YC",
"service": "Instagram - Followers Indonesia - Garansi 30 Hari",
"target": "https://instagram.com/username",
"quantity": 1000,
"status": "Proses",
"smm_status": "In progress",
"start_count": 5000,
"remains": 350,
"delivered_count": 650,
"refund_amount": null,
"note": "Pesanan Anda sedang diproses. Mohon tunggu!",
"price": 25000
}
}{
"status": false,
"msg": "order_id tidak ditemukan",
"data": {
"order_id": "",
"status": "error"
}
}API Aplikasi Premium
Untuk layanan Aplikasi Premium (akun / lisensi seperti Netflix, Spotify, Canva, dan sejenisnya). Dipisah dari API Utama karena hasil pesanan berupa data akun (sn) dan catatan penjual (catatan), bukan top up ke ID tujuan.
- Autentikasi, signature, dan saldo sama dengan API Utama. Cek saldo memakai endpoint /api/balance.
- Satu request = satu order dengan jumlah item sesuai parameter jumlah (bukan order terpisah per item seperti API Utama).
- Instan: akun langsung dikirim, sn dan catatan sudah terisi di response order. Manual: status Proses sampai admin mengirim pesanan, lalu sn dan catatan terisi (pantau lewat Callback atau Cek Status).
- Jika sebagian item gagal, status akhir tetap Sukses selama minimal 1 item berhasil. items_gagal menunjukkan jumlah item gagal dan saldo item tersebut otomatis dikembalikan. Jika semua item gagal, status Gagal dan saldo dikembalikan penuh.
- Stok dicek real-time sebelum order diterima. Jika stok tidak cukup, order ditolak dan saldo tidak terpotong.
curl -X POST "{BASE_URL}/api/premium/service" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "api_id={API_ID}" \
-d "api_key={API_KEY}" \
-d "signature={SIGNATURE}"- harga otomatis sesuai role akun Kamu (Basic, Gold, atau Platinum).
- Layanan dengan status "tidak aktif" berarti stok sedang kosong dan tidak dapat dipesan.
[
{
"status": true,
"msg": "berhasil mendapatkan data layanan aplikasi premium",
"data": {
"id": "8",
"aplikasi": "Spotify Premium",
"nama_layanan": "1 Tahun",
"harga": 52000,
"status": "aktif"
}
},
...
]curl -X POST "{BASE_URL}/api/premium/order" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "api_id={API_ID}" \
-d "api_key={API_KEY}" \
-d "signature={SIGNATURE}" \
-d "order_id=PRM-001" \
-d "service_id=8" \
-d "jumlah=1"- order_id final dibentuk sistem: order_id Kamu + "_" + 25 karakter acak.
- sn berisi satu akun per baris (dipisah \n). catatan berisi catatan penjual seperti cara pakai atau masa berlaku.
{
"status": true,
"msg": "Pesanan Anda telah berhasil diproses!",
"data": {
"order_id": "PRM-001_3MZ7X1KQ9B5HN2VD8R4T0WYAL",
"nama_layanan": "Spotify Premium - 1 Tahun",
"service_id": "8",
"jumlah": 1,
"total_harga": 50000,
"status": "Sukses",
"items_sukses": 1,
"items_gagal": 0,
"sn": "user@mail.com|pass123",
"catatan": "Login hanya di 1 perangkat. Jangan ubah password.",
"note": "Pesanan Anda telah berhasil diproses!"
}
}{
"status": true,
"msg": "Pesanan Anda sedang diproses. Mohon tunggu!",
"data": {
"order_id": "PRM-002_9WD4K2ZQ7X1MN5BH8R3T6VYCA",
"nama_layanan": "Canva Pro - 1 Bulan",
"service_id": "12",
"jumlah": 1,
"total_harga": 15000,
"status": "Proses",
"items_sukses": 0,
"items_gagal": 0,
"sn": null,
"catatan": null,
"note": "Pesanan Anda sedang diproses. Mohon tunggu!"
}
}{
"status": false,
"msg": "order_id wajib diisi"
}{
"status": false,
"msg": "order_id ini sudah pernah digunakan. Silakan cek statusnya melalui API status.",
"data": {
"order_id": "PRM-001_3MZ7X1KQ9B5HN2VD8R4T0WYAL",
"status": "Sukses"
}
}{
"status": false,
"msg": "service_id tidak ditemukan"
}{
"status": false,
"msg": "Layanan sedang tidak aktif"
}{
"status": false,
"msg": "Stok produk ini sedang habis di provider. Silakan coba lagi nanti."
}{
"status": false,
"msg": "Stok produk ini di provider tersisa 1 item. Silakan kurangi jumlah pembelian."
}{
"status": false,
"msg": "Saldo anda tidak mencukupi untuk 2 pembelian. Total yang diperlukan: Rp 100.000"
}{
"status": false,
"msg": "Maksimal jumlah order adalah 10"
}{
"status": false,
"msg": "Akun Anda telah disuspend sehingga tidak dapat melakukan transaksi via API. Alasan: -"
}curl -X POST "{BASE_URL}/api/premium/status" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "api_id={API_ID}" \
-d "api_key={API_KEY}" \
-d "signature={SIGNATURE}" \
-d "order_id=PRM-001_3MZ7X1KQ9B5HN2VD8R4T0WYAL"{
"status": true,
"msg": "Detail transaksi berhasil didapatkan",
"data": {
"order_id": "PRM-001_3MZ7X1KQ9B5HN2VD8R4T0WYAL",
"service": "Spotify Premium - 1 Tahun",
"jumlah": 2,
"status": "Sukses",
"items_sukses": 2,
"items_gagal": 0,
"sn": "user1@mail.com|pass123\nuser2@mail.com|pass456",
"catatan": "Login hanya di 1 perangkat. Jangan ubah password.",
"note": "Pesanan Anda telah berhasil diproses!",
"price": 100000
}
}{
"status": false,
"msg": "order_id tidak ditemukan",
"data": {
"order_id": "",
"status": "error"
}
}Callback / Webhook
Silakan pasang URL callback Kamu di kolom Callback URL pada menu Akun di dashboard (satu halaman dengan API ID, API KEY, dan Whitelist IP). Setelah URL disimpan, kolom Callback Secret akan muncul otomatis. Secret ini dipakai untuk memverifikasi callback dan terpisah dari API KEY. URL harus dapat diakses publik (disarankan HTTPS). Berlaku untuk API Utama, API SMM, dan API Aplikasi Premium.
- Callback dikirim otomatis lewat HTTP POST dengan body JSON (Content-Type: application/json) saat status order berubah menjadi final: Sukses atau Gagal.
- Status Proses tidak dikirim lewat callback. Untuk memantau progres, gunakan endpoint Cek Status.
- Endpoint Kamu harus membalas HTTP 200. Jika callback tidak sampai, Kamu tetap bisa mengambil hasil order lewat endpoint Cek Status.
- Callback bisa terkirim lebih dari sekali untuk order yang sama. Pastikan proses di sistem Kamu aman dijalankan berulang (idempoten).
- Untuk produk instan, callback bisa tiba sebelum response Order sampai ke sistem Kamu. Jangan bergantung pada urutan keduanya.
- Setiap callback membawa header X-Timestamp dan X-Signature. Tolak callback yang signature-nya tidak cocok atau timestamp-nya lebih dari 5 menit dari waktu sekarang.
- Jika secret bocor, klik Buat ulang secret saat menyimpan di menu Akun. Secret lama langsung tidak berlaku.
- Server kami tidak mengikuti redirect dan hanya mengirim ke URL publik. URL yang mengarah ke IP privat atau localhost akan ditolak.
Balas dengan HTTP 200. Body bebas, contoh:
{
"status": true
}{
"order_id": "TESTING-001_4KX9M2Q7WB1ZN5P6R0T8Y3U2A",
"reference_id": "TESTING-001",
"service_id": "1",
"service_name": "14 Diamonds ( 13 + 1 Bonus )",
"target_id": "12345678",
"target_server": "1234",
"status": "Sukses",
"note": "Pesanan Anda telah berhasil diproses!",
"sn": "SN123456789",
"price": 3310,
"updated_at": "2026-09-20 13:45:10"
}{
"order_id": "SMM-001_7QH2N8VXD4M1KZ5B9R3T6W0YC",
"reference_id": "SMM-001",
"service_id": "1725",
"service_name": "Instagram - Followers Indonesia - Garansi 30 Hari",
"target": "https://instagram.com/username",
"quantity": 1000,
"status": "Sukses",
"smm_status": "Completed",
"start_count": 5000,
"remains": 0,
"delivered_count": 1000,
"refund_amount": null,
"note": "Pesanan Anda telah berhasil diproses!",
"price": 25000,
"updated_at": "2026-09-20 14:10:22"
}{
"order_id": "PRM-001_3MZ7X1KQ9B5HN2VD8R4T0WYAL",
"reference_id": "PRM-001",
"service_id": "8",
"service_name": "Spotify Premium - 1 Tahun",
"jumlah": 2,
"status": "Sukses",
"items_sukses": 2,
"items_gagal": 0,
"sn": "user1@mail.com|pass123\nuser2@mail.com|pass456",
"catatan": "Login hanya di 1 perangkat. Jangan ubah password.",
"note": "Pesanan Anda telah berhasil diproses!",
"price": 100000,
"updated_at": "2026-09-20 14:32:05"
}Hitung signature dari body mentah persis seperti yang diterima (jangan di-decode lalu di-encode ulang), lalu bandingkan dengan hash_equals(). Pengecekan timestamp mencegah callback lama dikirim ulang oleh pihak lain.
<?php
$secret = 'CALLBACK_SECRET_KAMU';
$timestamp = $_SERVER['HTTP_X_TIMESTAMP'] ?? '';
$signature = $_SERVER['HTTP_X_SIGNATURE'] ?? '';
$body = file_get_contents('php://input');
$expected = hash_hmac('sha256', $timestamp . '.' . $body, $secret);
if (!hash_equals($expected, $signature) || abs(time() - (int) $timestamp) > 300) {
http_response_code(401);
exit;
}
$payload = json_decode($body, true);
http_response_code(200);
echo json_encode(['status' => true]);