Dokumentasi API Resmi
Dokumentasi teknis endpoint checker, mutasi QRIS, dan integrasi resmi sistem PT CUTIEZY ID NUSANTARA.
๐ก๏ธ Tes Koneksi & Cek IP Terblokir Server
Uji apakah IP perangkat atau server VPS Anda dapat mengakses API Cutiezy atau terblokir firewall server. Masukkan IP yang ingin dicek di bawah.
Pengecekan browser di atas mendeteksi IP perangkat internet/WiFi Anda. Apabila aplikasi/bot Anda berjalan di server VPS / cPanel hosting, maka IP yang mengakses server adalah IP publik VPS Anda. Jika script bot Anda di VPS mengalami error koneksi (timeout atau 403), kemungkinan IP server VPS Anda yang terblokir firewall server. Lakukan pengujian langsung dari VPS menggunakan perintah di bawah.
๐ก 1. Perintah Tes cURL dari Terminal SSH VPS:
curl -i -s "https://api.cutiezy.id/api/ping"
๐ป 2. Skrip PHP cURL (Jalankan di Server Bot/Hosting):
<?php
$ch = curl_init("https://api.cutiezy.id/api/ping");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 15,
CURLOPT_SSL_VERIFYPEER => true
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$curlErr = curl_error($ch);
curl_close($ch);
if ($curlErr) {
echo "โ KONEKSI GAGAL / TIMEOUT: " . $curlErr . "\n";
echo "Segera hubungi Admin WhatsApp Cutiezy untuk unblock IP VPS Anda.\n";
} elseif ($httpCode === 403 || $httpCode >= 400) {
echo "โ KONEKSI DITOLAK / TERBLOKIR FIREWALL SERVER (HTTP $httpCode):\n" . $response . "\n";
echo "๐ IP server Anda diblokir firewall. Kirimkan pesan error & Request ID ke Admin WhatsApp Cutiezy untuk unblock.\n";
} else {
echo "โ
KONEKSI BERHASIL (HTTP $httpCode):\n" . $response . "\n";
}
?>
๐ 3. Skrip Python:
import requests
try:
res = requests.get("https://api.cutiezy.id/api/ping", timeout=15)
print("Status HTTP:", res.status_code)
print(res.json())
except Exception as e:
print("โ KONEKSI GAGAL / IP TERBLOKIR:", e)
print("Hubungi Admin WhatsApp Cutiezy untuk unblock IP server Anda.")
โก 4. Skrip JavaScript / Node.js (Panel Pterodactyl, Bot WA Baileys, Discord, VPS):
// Skrip tes koneksi Node.js (Cocok untuk Panel Pterodactyl / Bot / VPS)
// Opsi A: Native fetch (Node.js 18+ tanpa install modul tambahan)
async function testPingCutiezy() {
try {
const res = await fetch("https://api.cutiezy.id/api/ping", {
headers: { "Accept": "application/json" },
signal: AbortSignal.timeout(15000)
});
const data = await res.json();
console.log("โ
KONEKSI BERHASIL (HTTP " + res.status + "):", data);
console.log("๐ IP Penembak Bot Anda :", data.ip_penembak || data.client_ip);
console.log("๐ Status Proteksi Server:", data.status_ip);
} catch (err) {
console.error("โ KONEKSI GAGAL / IP BOT DIBLOKIR FIREWALL:", err.message);
console.error("๐ Jika pakai Pterodactyl / VPS, kirim IP node Anda ke Admin WhatsApp untuk unblock.");
}
}
testPingCutiezy();
/* Opsi B: Menggunakan Axios (npm i axios)
const axios = require('axios');
axios.get("https://api.cutiezy.id/api/ping", { timeout: 15000 })
.then(res => console.log("โ
SUKSES:", res.data))
.catch(err => console.error("โ IP TERBLOKIR / TIMEOUT:", err.message));
*/
๐จ Ciri-Ciri IP Terblokir & Solusinya:
| Gejala Error | Penyebab | Solusi |
|---|---|---|
| cURL error 28: Operation timed out | IP terblokir firewall server (CSF/iptables) | Hubungi Admin untuk unblock IP |
| cURL error 7: Failed to connect | Koneksi ditolak firewall / proteksi port | Hubungi Admin untuk unblock IP |
| ETIMEDOUT / ECONNREFUSED / AxiosError | IP Node Pterodactyl / VPS diblokir firewall server | Hubungi Admin WA untuk unblock IP node |
| 403 IP_NOT_ALLOWED | IP belum didaftarkan di slot IP dashboard | Daftarkan IP di Dashboard atau hubungi Admin |
403 IP_NOT_ALLOWED?
Jika bot atau script Anda menerima respon JSON:
{"code": 403, "error": "IP_NOT_ALLOWED", "message": "IP tidak diizinkan", "meta": {"current_ip": "..."}}
Ini BUKAN diblokir oleh firewall server! Koneksi bot Anda sudah 100% sukses terhubung ke Cutiezy, tetapi IP bot Anda (lihat nilai meta.current_ip) belum didaftarkan di Slot IP Dashboard akun Anda.
๐ Solusi: Silakan login ke Dashboard Akun → Daftarkan IP yang tertera pada current_ip ke slot IP Anda. Setelah disimpan, bot langsung bisa transaksi normal tanpa perlu bantuan unblock.
Cek IP VPS Anda via command curl -s ifconfig.me di terminal lalu kirimkan ke Admin WhatsApp untuk dibuka seketika.
QRIS Dinamis, Cek Mutasi & Webhook Realtime
Buat QRIS nominal pas dengan timer & redirect (Min. Paket P3 • Potong 6 Hit Point).
POST /api/qris/create
Cek apakah QRIS sudah dibayar via mutasi bank/e-wallet (0 Hit Point / GRATIS).
GET /qris/check-status/{token}
Terima callback HTTP POST otomatis seketika saat pembeli selesai membayar.
event: qris.payment.success
Autentikasi API Checker
Semua request API mendukung header berikut:
X-API-Key: czw_xxxxxxxxxxxxxxxxx
Atau fallback query string:
apikey=czw_xxxxxxxxxxxxxxxxx
Format endpoint utama yang aktif saat ini:
https://api.cutiezy.id/api/check/{category}/{service}?param1=value&apikey=YOUR_API_KEY
Contoh Request URL
https://api.cutiezy.id/api/check/games/region-ml?user_id={$userId}&zone_id={$zoneId}&apikey=YOUR_API_KEY
Ganti {$userId} dan {$zoneId} dengan data yang ingin Anda cek.
Contoh Header
X-API-Key: YOUR_API_KEY
Accept: application/json
Cara Mengurai Response JSON
// contoh response
{
"ok": true,
"data": {
"nickname": "Nama Player",
"id": 861363893,
"zone": 12422,
"country": "Indonesia"
}
}
// cara ambil data
data.ok // status berhasil / tidak
data.message // pesan response
data.data.nickname // nama player
data.data.id // user id
data.data.zone // zone id
data.data.country // negara
Contoh PHP Code
<?php
$baseUrl = 'https://api.cutiezy.id/api/check/games/region-ml';
$apiKey = 'apikey-anda';
$userId = '861363893';
$zoneId = '12422';
$params = [
'service' => 'region-ml',
'user_id' => $userId,
'zone_id' => $zoneId,
];
$url = $baseUrl . '?' . http_build_query($params);
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Accept: application/json',
'X-API-Key: ' . $apiKey,
],
]);
$response = curl_exec($ch);
$error = curl_error($ch);
curl_close($ch);
if ($error) {
die("cURL Error: " . $error);
}
$data = json_decode($response, true);
if ($data['ok']) {
echo "Nickname : ".$data['data']['nickname']."\n";
echo "ID : ".$data['data']['id']."\n";
echo "Zone : ".$data['data']['zone']."\n";
echo "Country : ".$data['data']['country']."\n";
} else {
echo "Error: ".$data['message'];
}
Contoh JavaScript Code
const apiKey = "apikey-anda";
const userId = "861363893";
const zoneId = "12422";
const url = `https://api.cutiezy.id/api/check/games/region-ml?user_id=${userId}&zone_id=${zoneId}`;
fetch(url, {
method: "GET",
headers: {
"X-API-Key": apiKey,
"Accept": "application/json"
}
})
.then(response => response.json())
.then(data => {
if(data.ok){
console.log("Nickname:", data.data.nickname);
console.log("ID:", data.data.id);
console.log("Zone:", data.data.zone);
console.log("Country:", data.data.country);
}else{
console.log("Error:", data.message);
}
})
.catch(error => {
console.error("Request Error:", error);
});