Logo Cutiezy
Cutiezy Portal / Dokumentasi
PT CUTIEZY ID NUSANTARA Production
PT CUTIEZY ID NUSANTARA Official API Docs

Dokumentasi API Resmi

Dokumentasi teknis endpoint checker, mutasi QRIS, dan integrasi resmi sistem PT CUTIEZY ID NUSANTARA.

Diagnostic Tool

๐Ÿ›ก๏ธ 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.

*Jika dikosongkan, sistem otomatis menguji IP yang saat ini digunakan untuk menembak API (koneksi browser/perangkat Anda).
Status Blokir Server
Menunggu Pengujian...
IP Penembak (Caller)
-
IP penembak request API
IP yang Dicek (Target)
-
Target verifikasi
Latency / Response
-
๐Ÿ” Cek Status Whitelist Slot IP (Opsional) Masukkan API key untuk cek apakah IP target sudah diizinkan di akun Anda
โš ๏ธ PENTING UNTUK INTEGRASI BOT / VPS / WEBSITE RESELLER:

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
โš ๏ธ
Mendapat Respon Error: 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.

IP Server / VPS Anda Terblokir? Kami Siap Bantu 24/7!

Cek IP VPS Anda via command curl -s ifconfig.me di terminal lalu kirimkan ke Admin WhatsApp untuk dibuka seketika.

๐Ÿ’ฌ Chat Admin WhatsApp Unblock
Payment Gateway & Mutasi

QRIS Dinamis, Cek Mutasi & Webhook Realtime

POST 1. Generate QRIS Dinamis

Buat QRIS nominal pas dengan timer & redirect (Min. Paket P3 • Potong 6 Hit Point).

POST /api/qris/create
GET / POST 2. Polling Cek Status Pembayaran

Cek apakah QRIS sudah dibayar via mutasi bank/e-wallet (0 Hit Point / GRATIS).

GET /qris/check-status/{token}
CALLBACK 3. Notifikasi Webhook Instan

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
https://api.cutiezy.id/api/check/ewallet/dana?user_id=08123456789&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);
});