Getting Started

Introduction

KIMYUZIN adalah platform OTP (One-Time Password) terpercaya yang menyediakan akses ke 50+ layanan digital melalui 2 server premium.

Satu API, 50+ Layanan

Akses semua layanan melalui satu endpoint. Auto-failover antar server untuk ketersediaan tinggi.

Getting Started

Quick Start

Dapatkan API Key dalam 1 menit dan buat order pertamamu.

Step 1: Dapatkan API Key

Kirim /api ke @kimyuzinbot di Telegram.

Step 2: Buat Order

curl -X POST https://kimyuzin.store/api/v1/order \
  -H "Authorization: Bearer kz_live_xxx" \
  -d '{"service": "shopee", "server": "auto"}'

Step 3: Terima OTP

{
  "success": true,
  "order_id": "KIM-20260901-XXXXX",
  "server": "server1",
  "phone": "62838XXXXXXX",
  "status": "waiting"
}
Getting Started

Authentication

Semua request API wajib menyertakan API Key di header Authorization.

Authorization: Bearer kz_live_xxxxxxxxx

Jangan bagikan API Key Anda. Rotasi secara berkala untuk keamanan.

Getting Started

API Keys

Generate dan kelola API Key langsung dari bot Telegram.

Generate via Telegram

# Kirim command ini ke @kimyuzinbot
/api

Bot akan membalas dengan API Key baru Anda.

API Reference

Create Order

POST /v1/order SERVER 1 & 2

Buat order OTP baru untuk layanan tertentu.

Request Body

{
  "api_key": "kim_xxxxx",
  "service": "shopee",
  "server": "auto" // auto, server1, server2
}

Response

{
  "success": true,
  "order_id": "KIM-20260901-XXXXX",
  "server": "server1",
  "phone": "62838XXXXXXX",
  "price": 1200,
  "status": "waiting"
}

Parameter Server

  • auto — Otomatis pilih server terbaik (recommended)
  • server1 — Server 1 - Premium
  • server2 — Server 2 - Ultra
API Reference

Order Status

GET /v1/status/{order_id}

Cek status order & dapatkan OTP jika sudah tersedia.

Response

{
  "success": true,
  "order_id": "KIM-20260901-XXXXX",
  "status": "completed",
  "otp": "123456",
  "phone": "62838XXXXXXX"
}
API Reference

Resend OTP

POST /v1/order/{order_id}/resend SERVER 1 & 2

Minta ulang OTP untuk order yang masih aktif. Gratis dan tidak memotong saldo.

Syarat & Ketentuan

  • Order harus dalam status waiting atau processing
  • Maksimal 5x resend per order
  • Tidak ada potongan saldo tambahan
  • Waktu berlaku otomatis diperpanjang +20 menit

Response

{
  "success": true,
  "order_id": "KIM-20260901-XXXXX",
  "server": "server1",
  "status": "waiting",
  "resend_count": 1,
  "expires_at": "2026-09-01T12:00:00"
}
API Reference

Balance

GET /v1/balance

Cek saldo akun Anda.

{
  "success": true,
  "balance": 50000
}
API Reference

Services

GET /v1/services

Daftar semua layanan OTP yang tersedia di KIMYUZIN.

{
  "success": true,
  "server1": [
    "shopee", "gopay", "facebook", "..."
  ],
  "server2": [
    "dana", "ovo", "grab", "..."
  ]
}
Resources

Error Codes

400 Bad Request

Parameter yang dikirim tidak lengkap atau format salah. Cek request body Anda.

401 Unauthorized

API Key tidak valid atau sudah expired. Generate API Key baru lewat @kimyuzinbot.

402 Insufficient Balance

Saldo tidak cukup untuk melakukan order. Silakan isi saldo melalui deposit QRIS.

403 Forbidden

Anda tidak memiliki akses ke resource ini. Cek role atau izin akun Anda.

404 Not Found

Endpoint atau order_id tidak ditemukan. Cek kembali URL atau ID order Anda.

409 Order Conflict

Order sudah aktif untuk user ini. Maksimal 5 order aktif (Bot) atau 20 order aktif (API). Tunggu order selesai/kadaluarsa.

410 Order Expired

Order sudah kadaluarsa. Silakan buat order baru.

422 Unprocessable Entity

Service tidak tersedia di server yang dipilih. Coba gunakan server: "auto".

429 Rate Limit Exceeded

Terlalu banyak order aktif. Maksimal 5 order (Bot) atau 20 order (API) per user. Tunggu order selesai/kadaluarsa.

500 Internal Server Error

Terjadi kesalahan pada server kami. Tim sedang menangani. Coba lagi nanti.

503 Server Maintenance

Server yang dipilih sedang dalam maintenance. Gunakan "server": "auto" untuk failover otomatis ke server yang tersedia.

503 All Servers Down

Kedua server sedang offline. Kami sedang melakukan perbaikan. Silakan coba lagi nanti. Pantau status di @kimyuzinbot.