🛍️ KAMIL MARKET/Docs
v1.0← Kembali ke Website

📖 Pengenalan

Referensi API lengkap untuk platform KAMIL MARKET

🌐

Base URL

https://kamilshop.my.id

📦

Format

JSON (application/json)

🔐

Auth

NextAuth.js Session / JWT

ℹ️ Konvensi Response

// Sukses
{ "ok": true, "data": { ... } }

// Error
{ "error": "Pesan error", "code": 400 }

🏷️ Format Order ID

Semua order ID menggunakan prefix KM- diikuti timestamp dan random string.

KM-{timestamp}-{random4char}
// Contoh: KM-1780992398025-7YQ1

🔐 Autentikasi

KAMIL MARKET menggunakan NextAuth.js dengan provider Google dan GitHub.

⚠️ Endpoint Terproteksi

Endpoint dengan label 🔒 Auth membutuhkan sesi aktif. Request tanpa sesi akan mendapat response 401 Unauthorized.

🛍️ Orders

Endpoint untuk membuat, melihat, dan mengelola pesanan.

🔔 Webhook Pakasir

Endpoint ini dipanggil otomatis oleh Pakasir saat pembayaran berhasil.

📌 Konfigurasi di Pakasir

Webhook URL:
https://kamilshop.my.id/api/webhook/pakasir?secret=WEBHOOK_SECRET_KAMU

Isi WEBHOOK_SECRET di env dengan string acak yang sama dengan yang didaftarkan di Pakasir.

🧪 Test Webhook via cURL / Termux

curl -X POST "https://kamilshop.my.id/api/webhook/pakasir?secret=ISI_SECRET_KAMU" \
  -H "Content-Type: application/json" \
  -d '{"order_id":"KM-1780992398025-7YQ1","status":"paid"}'

💰 Affiliate

Program affiliate dengan komisi 10% per transaksi menggunakan ref code.

🔗 Cara Kerja Ref Link

// User share link:
https://kamilshop.my.id?ref=KAMIL10

// Sistem menyimpan refCode di cookie selama 30 hari
// Saat checkout, refCode otomatis ikut di order
// Setelah order paid → komisi 10% masuk ke saldo affiliate

🤖 Telegram Bot

Bot Telegram KAMIL MARKET untuk notifikasi & manajemen via chat.

👤 Commands User

/startHubungkan akun & lihat menu
/menuMenu utama
/katalogBrowse produk
/pesanan5 pesanan terakhir
/saldoSaldo & info affiliate
/statusStatus koneksi akun
/helpDaftar semua perintah
/stopPutus koneksi Telegram

🔑 Commands Admin

/adminPanel admin
/orders7 order terbaru
/withdrawalsDaftar WD pending
/statsStatistik platform

📢 Notifikasi Otomatis ke Grup

• 🛍️ Ada transaksi baru (order paid)

• 🚧 Maintenance aktif

• ✅ Maintenance selesai

⚙️ Cara Daftarkan Webhook ke Telegram

curl "https://api.telegram.org/bot{BOT_TOKEN}/setWebhook" \
  -d "url=https://kamilshop.my.id/api/telegram/webhook" \
  -d "secret_token=TELEGRAM_WEBHOOK_SECRET_KAMU"

⚙️ Admin API

Semua endpoint admin membutuhkan role admin.

🚨 Endpoint ini hanya bisa diakses jika user memiliki role: "admin" di Firestore.

🔔 Notifikasi

In-app notification system untuk user.

📋 Tipe Notifikasi

order_paid— Pembayaran berhasil dikonfirmasi
order_pending— Menunggu pembayaran
order_failed— Pembayaran gagal
order_refunded— Refund diproses
chat_reply— Balasan chat dari admin
dm_message— Pesan DM baru
broadcast— Pengumuman dari admin
system— Notifikasi sistem (maintenance, dll)

🔧 Environment Variables

Semua variabel yang dibutuhkan di file .env.local

🔑 NextAuth

NEXTAUTH_URLURL produksihttps://kamilshop.my.id
NEXTAUTH_SECRETSecret key — generate: openssl rand -base64 32
GOOGLE_CLIENT_IDGoogle OAuth Client ID
GOOGLE_CLIENT_SECRETGoogle OAuth Client Secret
GITHUB_IDGitHub OAuth App ID
GITHUB_SECRETGitHub OAuth App Secret

🔥 Firebase

NEXT_PUBLIC_FIREBASE_API_KEYFirebase Web API Key
NEXT_PUBLIC_FIREBASE_AUTH_DOMAINFirebase Auth Domain
NEXT_PUBLIC_FIREBASE_PROJECT_IDFirebase Project ID
FIREBASE_ADMIN_PROJECT_IDFirebase Admin Project ID
FIREBASE_ADMIN_CLIENT_EMAILFirebase Admin Client Email
FIREBASE_ADMIN_PRIVATE_KEYFirebase Admin Private Key (dengan \n)

💳 Pakasir Payment

PAKASIR_SLUGSlug toko di Pakasir
PAKASIR_API_KEYAPI Key Pakasir
WEBHOOK_SECRETSecret untuk validasi webhook Pakasir

🤖 Telegram

TELEGRAM_BOT_TOKENToken bot dari @BotFather
TELEGRAM_ADMIN_CHAT_IDChat ID pribadi admin
TELEGRAM_GROUP_CHAT_IDChat ID grup informasi-1003918831181
TELEGRAM_WEBHOOK_SECRETSecret untuk validasi webhook Telegram

📧 Email

GMAIL_USERAlamat Gmail pengirim
GMAIL_APP_PASSGoogle App Password (bukan password akun)

🌐 App

NEXT_PUBLIC_APP_URLURL produksi websitehttps://kamilshop.my.id
NEXT_PUBLIC_APP_NAMENama aplikasiKAMIL MARKET
ADMIN_UIDUID Firestore dokumen user admin