Dokumentasi API v2

Pengenalan & Autentikasi

API DQ.ViP mengadopsi standar industri SMM Panel API v2. Anda dapat menghubungkan website, skrip bot WhatsApp, atau panel SMM pihak ketiga (seperti PerfectPanel, SMARTPANEL, dll.) secara langsung.

Dukungan Jalur Server:

• Server 1: Jalur Utama — Layanan WhatsApp Channel prioritas tinggi, proses stabil, dan status terupdate berkala.
• Server 2: Jalur Cadangan — Layanan WhatsApp Channel alternatif cepat dengan variasi paket lengkap.

1. Cek Saldo Koin (Balance)

Gunakan endpoint ini untuk mengecek sisa saldo koin akun Anda.

{
  "balance": 50000,
  "currency": "IDR",
  "username": "dquser123"
}

2. Daftar Layanan (Services)

Mengambil daftar seluruh layanan WhatsApp Channel aktif lengkap dengan tarif harga koin per 1.000 pesanan.

[
  {
    "service": "50581",
    "name": "🌎 Whatsapp Channel Members [ Global ] | HQ Profiles",
    "type": "Default",
    "category": "WhatsApp Channel",
    "rate": 141180,
    "min": 10,
    "max": 10000,
    "refill": false,
    "cancel": false,
    "server": "1",
    "description": "Members Real Global - Fast Start",
    "server_status": "ONLINE"
  },
  {
    "service": "5822",
    "name": "WhatsApp Channel Members ❏ Real ❏ Max 500K",
    "type": "Default",
    "category": "WhatsApp Channel",
    "rate": 86234,
    "min": 10,
    "max": 500000,
    "refill": false,
    "cancel": false,
    "server": "2",
    "description": "Members Alternatif Cepat",
    "server_status": "ONLINE"
  }
]

3. Buat Pesanan Baru (Add Order)

Membuat pesanan baru secara otomatis. Saldo koin akan dipotong secara aman dan atomik jika pemesanan sukses.

{
  "order": "6a85f030e84e5e5b6d06e1d2",
  "provider_order": "93825162",
  "charge": 863,
  "remains": 10
}

{
  "error": "Saldo koin tidak cukup. Dibutuhkan 1500 koin, saldo kamu saat ini 500 koin."
}

4. Status Pesanan (Order Status)

Memeriksa status pesanan yang telah dibuat, baik tunggal (single order) maupun massal (multiple orders).

A. Single Order:

{
  "charge": 863,
  "start_count": "100",
  "status": "In progress",
  "remains": "0",
  "currency": "IDR"
}

B. Multiple Orders (Maks 100 ID):

{
  "6a85f030e84e5e5b6d06e1d2": {
    "charge": 863,
    "start_count": "100",
    "status": "Completed",
    "remains": "0",
    "currency": "IDR"
  },
  "6a85f08fae061b48abc2357d": {
    "charge": 1412,
    "start_count": "50",
    "status": "In progress",
    "remains": "5",
    "currency": "IDR"
  }
}

5. Contoh Kode Integrasi

Pilih bahasa pemrograman favorit Anda untuk melihat contoh implementasi:

curl -X POST "https://YOUR_DOMAIN/api/v2" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": "50581",
    "server": "1",
    "link": "https://whatsapp.com/channel/0029VbCaDhn11ulT1qwodB2x",
    "quantity": 10
  }'

<?php
$apiUrl = "https://YOUR_DOMAIN/api/v2";
$apiKey = "YOUR_API_KEY";

$postData = [
    'key'      => $apiKey,
    'action'   => 'add',
    'service'  => '50581',
    'server'   => '1',
    'link'     => 'https://whatsapp.com/channel/0029VbCaDhn11ulT1qwodB2x',
    'quantity' => 10
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);
?>

import requests

api_url = "https://YOUR_DOMAIN/api/v2"
api_key = "YOUR_API_KEY"

payload = {
    "key": api_key,
    "action": "add",
    "service": "50581",
    "server": "1",
    "link": "https://whatsapp.com/channel/0029VbCaDhn11ulT1qwodB2x",
    "quantity": 10
}

response = requests.post(api_url, json=payload)
data = response.json()
print("Order Response:", data)

const apiUrl = "https://YOUR_DOMAIN/api/v2";
const apiKey = "YOUR_API_KEY";

async function createOrder() {
  const payload = {
    key: apiKey,
    action: "add",
    service: "50581",
    server: "1",
    link: "https://whatsapp.com/channel/0029VbCaDhn11ulT1qwodB2x",
    quantity: 10
  };

  const res = await fetch(apiUrl, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(payload)
  });

  const data = await res.json();
  console.log("Order Result:", data);
}

createOrder();

6. Status Pesanan & Pesan Error

Berikut daftar nilai status pesanan dan pesan kesalahan umum yang mungkin dikembalikan:

Status Pesanan:

• Pending: Pesanan sedang dalam antrean pemrosesan server.
• Processing: Pesanan sedang disiapkan.
• In progress: Pesanan sedang dikirim ke channel WhatsApp target.
• Completed: Pesanan telah selesai 100%.
• Partial: Pesanan selesai sebagian, sisa koin telah direfund otomatis ke akun.
• Canceled: Pesanan dibatalkan, saldo koin dikembalikan penuh.
• Refunded: Pesanan gagal dan koin telah dikembalikan ke saldo akun.

Pesan Error Umum: