# Kodenara API Base URL: `https://kodenara.biz.id` Semua endpoint memakai parameter `apikey` (API key akun kamu) lewat query string. ## Cek Saldo - Method: `GET` - URL: `https://kodenara.biz.id/api/balance` | Parameter | Tipe | Wajib | Keterangan | |---|---|---|---| | `apikey` | string | Ya | API Key akun kamu | - Mengembalikan saldo yang bisa dipakai untuk order. Contoh response: ```json { "success": true, "username": "budi", "balance": 25000 } ``` ## Daftar Negara - Method: `GET` - URL: `https://kodenara.biz.id/api/countries` | Parameter | Tipe | Wajib | Keterangan | |---|---|---|---| | `apikey` | string | Ya | API Key akun kamu | - Langkah pertama alur order. Daftar negara diambil langsung dari provider. Contoh response: ```json { "success": true, "countries": [ { "id": "6", "name": "Indonesia", "code": "ID" } ] } ``` ## Daftar Platform - Method: `GET` - URL: `https://kodenara.biz.id/api/services` | Parameter | Tipe | Wajib | Keterangan | |---|---|---|---| | `apikey` | string | Ya | API Key akun kamu | | `country` | string | Ya | ID negara dari endpoint Daftar Negara | - Menampilkan platform yang tersedia untuk negara yang dipilih. Contoh response: ```json { "success": true, "services": [ { "id": "3", "name": "WhatsApp", "code": "wa" }, { "id": "4", "name": "Telegram", "code": "tg" } ] } ``` ## Daftar Operator dan Harga - Method: `GET` - URL: `https://kodenara.biz.id/api/products` | Parameter | Tipe | Wajib | Keterangan | |---|---|---|---| | `apikey` | string | Ya | API Key akun kamu | | `country` | string | Ya | ID negara | | `service` | string | Ya | ID platform dari endpoint Daftar Platform | - Harga sudah final (sudah termasuk biaya layanan) dan bisa langsung dipakai untuk order. - Hasil diurutkan dari harga termurah. Contoh response: ```json { "success": true, "products": [ { "id": "142", "name": "Operator otomatis", "price": 4200, "stock": 36 } ] } ``` ## Membuat Order - Method: `POST` (GET juga didukung) - URL: `https://kodenara.biz.id/api/order` | Parameter | Tipe | Wajib | Keterangan | |---|---|---|---| | `apikey` | string | Ya | API Key akun kamu | | `country` | string | Ya | ID negara | | `service` | string | Ya | ID platform | | `product` | string | Ya | ID operator dari endpoint Daftar Operator dan Harga | | `idempotency_key` | string | Tidak | Kunci unik 8 sampai 64 karakter (huruf, angka, garis bawah). Bisa juga lewat header Idempotency-Key | - Saldo dipotong saat order dibuat dan otomatis dikembalikan bila SMS Code tidak masuk atau order dibatalkan. - Harga dihitung ulang saat order dibuat. Jika saldo kurang, API mengembalikan HTTP 402. - Kirim idempotency_key yang sama saat mengulang permintaan agar tidak terjadi order ganda. Contoh response: ```json { "success": true, "order": { "order_id": 1024, "service": "WhatsApp", "country": "Indonesia", "operator": "Telkomsel", "number": "+6281234567890", "price": 4200, "status": "waiting", "otp": "", "created_at": "2026-01-01 12:00:00" } } ``` ## Cek Status Order dan SMS Code - Method: `GET` - URL: `https://kodenara.biz.id/api/order/status` | Parameter | Tipe | Wajib | Keterangan | |---|---|---|---| | `apikey` | string | Ya | API Key akun kamu | | `order_id` | integer | Ya | ID order | - Nilai status: waiting, success, canceled, expired. - SMS Code muncul di kolom otp saat status success. Disarankan polling setiap 5 detik. Contoh response: ```json { "success": true, "order": { "order_id": 1024, "status": "success", "number": "+6281234567890", "otp": "482916", "price": 4200 } } ``` ## Batalkan Order - Method: `POST` (GET juga didukung) - URL: `https://kodenara.biz.id/api/order/cancel` | Parameter | Tipe | Wajib | Keterangan | |---|---|---|---| | `apikey` | string | Ya | API Key akun kamu | | `order_id` | integer | Ya | ID order | - Hanya order berstatus waiting yang bisa dibatalkan, saldo dikembalikan penuh. - Provider hanya mengizinkan pembatalan setelah 2 menit sejak order dibuat. Contoh response: ```json { "success": true, "order_id": 1024, "status": "canceled", "refunded": 4200, "balance": 25000 } ``` ## Riwayat Order - Method: `GET` - URL: `https://kodenara.biz.id/api/orders` | Parameter | Tipe | Wajib | Keterangan | |---|---|---|---| | `apikey` | string | Ya | API Key akun kamu | | `status` | string | Tidak | waiting, success, canceled, atau expired | | `limit` | integer | Tidak | Jumlah data, default 20, maksimal 100 | Contoh response: ```json { "success": true, "orders": [ { "order_id": 1024, "service": "WhatsApp", "status": "success", "price": 4200, "created_at": "2026-01-01 12:00:00" } ] } ``` ## Membuat Invoice Deposit - Method: `GET` - URL: `https://kodenara.biz.id/api/deposit` | Parameter | Tipe | Wajib | Keterangan | |---|---|---|---| | `apikey` | string | Ya | API Key akun kamu | | `amount` | integer | Ya | Nominal saldo yang masuk (minimal sesuai pengaturan, default 5000) | - Pembayaran lewat QRIS. Saldo masuk otomatis setelah pembayaran terdeteksi. - Bayar sesuai nilai total persis. Contoh response: ```json { "success": true, "deposit_id": "DEP9X2K41", "amount": 50000, "fee": 500, "total": 50500, "qris_image": "https://...", "payment_link": "https://...", "expired_at": "2026-01-01 12:10:00", "status": "pending" } ``` ## Cek Status Deposit - Method: `GET` - URL: `https://kodenara.biz.id/api/deposit/status` | Parameter | Tipe | Wajib | Keterangan | |---|---|---|---| | `apikey` | string | Ya | API Key akun kamu | | `deposit_id` | string | Ya | ID deposit | - Nilai status: pending, paid, expired, cancelled. Contoh response: ```json { "success": true, "deposit_id": "DEP9X2K41", "amount": 50000, "total": 50500, "status": "paid", "created_at": "2026-01-01 12:00:00", "paid_at": "2026-01-01 12:03:10" } ``` ## Batalkan Deposit - Method: `POST` (GET juga didukung) - URL: `https://kodenara.biz.id/api/deposit/cancel` | Parameter | Tipe | Wajib | Keterangan | |---|---|---|---| | `apikey` | string | Ya | API Key akun kamu | | `deposit_id` | string | Ya | ID deposit | - Hanya deposit berstatus pending yang bisa dibatalkan. Jangan bayar QR yang sudah dibatalkan. Contoh response: ```json { "success": true, "deposit_id": "DEP9X2K41", "status": "cancelled" } ```