NETLAYER REST API

Dokumentasi resmi REST API Netlayer.id. API ini memungkinkan Anda untuk mengintegrasikan layanan voucher hotspot Netlayer ke dalam aplikasi, website, atau sistem pihak ketiga yang Anda kembangkan sendiri tanpa perlu membangun infrastruktur RADIUS/hotspot dari nol.

Semua endpoint menggunakan metode komunikasi HTTP/HTTPS, mengembalikan data dalam format JSON, dan diakses melalui base URL yang sama. Untuk setiap request, sertakan header X-API-Key sebagai autentikasi. Request tanpa header tersebut akan ditolak dengan status 401 Unauthorized.

Ringkasan API

Cara Mendapatkan API Key

API Key bersifat unik untuk setiap NAS. Artinya, jika Anda memiliki beberapa NAS (server hotspot) yang terdaftar, masing-masing NAS memiliki API Key-nya sendiri. API Key digunakan untuk mengaitkan setiap request yang Anda kirim dengan NAS tertentu, sehingga order voucher yang dibuat akan masuk ke server yang benar. Berikut langkah-langkah untuk memperoleh API Key:

Nilai API Key inilah yang nantinya dikirim melalui header X-API-Key pada setiap request ke endpoint API. Anda juga dapat mengakses halaman daftar NAS melalui tombol Get API_KEY di bawah ini.

1. Endpoints

Berikut adalah daftar endpoint yang tersedia pada versi 1.0. Semua endpoint bersifat synchronous, artinya response dikembalikan langsung setelah server selesai memproses permintaan Anda. Gunakan metode HTTP sesuai tabel di bawah ini.

2. Get Info

Endpoint ini berfungsi untuk mengambil informasi akun yang terhubung dengan API Key Anda. Data yang dikembalikan meliputi nama pemilik akun, nama perusahaan, email, nomor telepon, dan nama server (NAS) yang terdaftar. Endpoint ini sangat berguna sebagai langkah awal untuk memverifikasi bahwa API Key Anda valid sebelum melakukan request pada endpoint lain, serta untuk menampilkan identitas akun pada dashboard aplikasi Anda.

curl -X GET "https://netlayer.id/api/info" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Accept: application/json"

<?php
$ch = curl_init('https://netlayer.id/api/info');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);

const res = await fetch('https://netlayer.id/api/info', {
    method: 'GET',
    headers: {
        'X-API-Key': 'YOUR_API_KEY',
        'Accept': 'application/json'
    }
});
const data = await res.json();
console.log(data);

{
	"name": "Demo User",
	"company": "NETLAYER.ID",
	"email": "demo@netlayer.id",
	"phone": "6285174199211",
	"server": "RB951Ui-2HND"
}

3. Get Profile List

Endpoint ini digunakan untuk mengambil daftar paket/profile hotspot yang aktif pada server NAS yang terhubung dengan API Key Anda. Setiap profile merepresentasikan satu paket voucher hotspot (misalnya "1 Jam", "3 Jam", "1 Hari", "Unlimited 30 Hari") beserta atribut harga, durasi masa aktif, rate limit bandwidth, dan jumlah pengguna yang boleh berbagi. Data yang dikembalikan dari endpoint ini wajib dipanggil sebelum membuat order, karena Anda membutuhkan id profile yang akan disertakan pada body request /api/orders.

curl -X GET "https://netlayer.id/api/profiles" \
  -H "X-API-Key: " \
  -H "Accept: application/json"

<?php
$ch = curl_init('https://netlayer.id/api/profiles');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: ',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

$profiles = json_decode($response, true);
print_r($profiles);

const res = await fetch('https://netlayer.id/api/profiles', {
    method: 'GET',
    headers: {
        'X-API-Key': '',
        'Accept': 'application/json'
    }
});
const profiles = await res.json();
console.log(profiles);

[
	{
		"id": 1360,
		"name": "3 Jam",
		"price": 1500,
		"validity": "3h",
		"rate_limit": "30M/30M",
		"shared_users": 1
	},
	{
		"id": 1361,
		"name": "12 Jam",
		"price": 2500,
		"validity": "12h",
		"rate_limit": "10M/10M",
		"shared_users": 1
	}
]

4. Create New Order

Endpoint ini berfungsi untuk membuat order voucher baru. Setelah order berhasil dibuat, sistem Netlayer akan mengembalikan order_id yang dapat Anda gunakan untuk melakukan pengecekan status pembayaran. Customer kemudian akan menerima QRIS untuk melakukan pembayaran; QR code tersebut dapat diakses melalui field qrcode_url pada endpoint /api/status/{order_id}.

Order yang dibuat akan berstatus pending sampai customer menyelesaikan pembayaran. Jika melewati batas waktu expire, order akan otomatis dianggap gagal. Pastikan Anda mengirim phone dalam format internasional tanpa tanda plus agar notifikasi WhatsApp/SMS dapat terkirim dengan benar.

curl -X POST "https://netlayer.id/api/orders" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "profile_id": 1360,
    "name": "Your Name",
    "phone": "6285174199211"
  }'

<?php
$payload = [
    'profile_id' => 1360,
    'name'       => 'Your Name',
    'phone'      => '6285174199211',
];

$ch = curl_init('https://netlayer.id/api/orders');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: YOUR_API_KEY',
        'Content-Type: application/json',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);

const res = await fetch('https://netlayer.id/api/orders', {
    method: 'POST',
    headers: {
        'X-API-Key': 'YOUR_API_KEY',
        'Content-Type': 'application/json',
        'Accept': 'application/json'
    },
    body: JSON.stringify({
        profile_id: 1360,
        name: 'Your Name',
        phone: '6285174199211'
    })
});
const data = await res.json();
console.log(data);

{
	"success": "order created successfully!",
	"order_id": 10
}

5. Check Order Status

Endpoint ini berfungsi untuk mengecek status pembayaran dan detail order yang sebelumnya telah dibuat melalui /api/orders. Gunakan endpoint ini untuk memantau apakah customer sudah membayar atau belum. Response menyertakan qrcode_url yang menunjuk ke gambar QRIS yang dapat ditampilkan ke customer untuk dipindai melalui aplikasi e-wallet/mobile banking.

Setelah pembayaran berhasil diverifikasi, field status akan berubah menjadi 1 dan field username dapat digunakan pada halaman login hotspot. Lakukan polling secara berkala (misalnya setiap 5–10 detik) untuk mendeteksi perubahan status.

curl -X GET "https://netlayer.id/api/status/19" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Accept: application/json"

<?php
$orderId = 19;
$ch = curl_init("https://netlayer.id/api/status/{$orderId}");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);

const orderId = 19;
const res = await fetch(`https://netlayer.id/api/status/${orderId}`, {
    method: 'GET',
    headers: {
        'X-API-Key': 'YOUR_API_KEY',
        'Accept': 'application/json'
    }
});
const data = await res.json();
console.log(data);

{
	"id": 19,
	"profile_id": 1360,
	"name": "Your Name",
	"phone": "6285174199211",
	"username": "V3CRF6B",
	"amount": 2000,
	"status": 0,
	"qrcode_url": "https://netlayer.id/qrcode/c3a633de.png",
	"expire": "2026-09-11 11:36",
	"created": "2026-09-11 11:21"
}

6. Catatan Umum

Bagian ini merangkum hal-hal penting yang perlu Anda perhatikan saat mengintegrasikan aplikasi dengan REST API Netlayer agar komunikasi berjalan lancar dan aman.