Dokumentasi API
Open API untuk order SMS Code dan deposit saldo
Base URLhttps://kodenara.biz.id
AutentikasiParameter
apikey atau header X-API-KeyFormatJSON (success true/false)
Rate limit90 request per menit
Masuk atau daftar untuk mendapatkan API key di halaman profil.
Kode status HTTP: 200 sukses, 400 parameter salah, 401 API key salah, 402 saldo kurang, 404 data tidak ditemukan, 409 konflik, 429 terlalu banyak request, 502 provider bermasalah, 503 layanan tidak tersedia.
ACek Saldo
- Method: GET
- URL:
https://kodenara.biz.id/api/balance
Parameter:
- apikey (string, wajib) : API Key akun kamu
Catatan:
- Mengembalikan saldo yang bisa dipakai untuk order.
Contoh Request:
const axios = require('axios');
const BASE_URL = 'https://kodenara.biz.id';
const API_KEY = 'YOUR_API_KEY';
axios
.get(`${BASE_URL}/api/balance`, {
params: {
apikey: API_KEY,
},
})
.then((res) => console.log(res.data))
.catch((err) => console.log(err.response ? err.response.data : err.message));
import requests
BASE_URL = "https://kodenara.biz.id"
API_KEY = "YOUR_API_KEY"
res = requests.get(
f"{BASE_URL}/api/balance",
params={
"apikey": API_KEY,
},
)
print(res.json())
curl -X GET -G "https://kodenara.biz.id/api/balance" \ --data-urlencode "apikey=YOUR_API_KEY"
<?php
$BASE_URL = 'https://kodenara.biz.id';
$API_KEY = 'YOUR_API_KEY';
$query = http_build_query([
'apikey' => $API_KEY,
]);
$ch = curl_init("$BASE_URL/api/balance?$query");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;
Contoh Response:
Response
{
"success": true,
"username": "budi",
"balance": 25000
}BDaftar Negara
- Method: GET
- URL:
https://kodenara.biz.id/api/countries
Parameter:
- apikey (string, wajib) : API Key akun kamu
Catatan:
- Langkah pertama alur order. Daftar negara diambil langsung dari provider.
Contoh Request:
const axios = require('axios');
const BASE_URL = 'https://kodenara.biz.id';
const API_KEY = 'YOUR_API_KEY';
axios
.get(`${BASE_URL}/api/countries`, {
params: {
apikey: API_KEY,
},
})
.then((res) => console.log(res.data))
.catch((err) => console.log(err.response ? err.response.data : err.message));
import requests
BASE_URL = "https://kodenara.biz.id"
API_KEY = "YOUR_API_KEY"
res = requests.get(
f"{BASE_URL}/api/countries",
params={
"apikey": API_KEY,
},
)
print(res.json())
curl -X GET -G "https://kodenara.biz.id/api/countries" \ --data-urlencode "apikey=YOUR_API_KEY"
<?php
$BASE_URL = 'https://kodenara.biz.id';
$API_KEY = 'YOUR_API_KEY';
$query = http_build_query([
'apikey' => $API_KEY,
]);
$ch = curl_init("$BASE_URL/api/countries?$query");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;
Contoh Response:
Response
{
"success": true,
"countries": [
{
"id": "6",
"name": "Indonesia",
"code": "ID"
}
]
}CDaftar Platform
- Method: GET
- URL:
https://kodenara.biz.id/api/services
Parameter:
- apikey (string, wajib) : API Key akun kamu
- country (string, wajib) : ID negara dari endpoint Daftar Negara
Catatan:
- Menampilkan platform yang tersedia untuk negara yang dipilih.
Contoh Request:
const axios = require('axios');
const BASE_URL = 'https://kodenara.biz.id';
const API_KEY = 'YOUR_API_KEY';
axios
.get(`${BASE_URL}/api/services`, {
params: {
apikey: API_KEY,
country: '6',
},
})
.then((res) => console.log(res.data))
.catch((err) => console.log(err.response ? err.response.data : err.message));
import requests
BASE_URL = "https://kodenara.biz.id"
API_KEY = "YOUR_API_KEY"
res = requests.get(
f"{BASE_URL}/api/services",
params={
"apikey": API_KEY,
"country": "6",
},
)
print(res.json())
curl -X GET -G "https://kodenara.biz.id/api/services" \ --data-urlencode "apikey=YOUR_API_KEY" \ --data-urlencode "country=6"
<?php
$BASE_URL = 'https://kodenara.biz.id';
$API_KEY = 'YOUR_API_KEY';
$query = http_build_query([
'apikey' => $API_KEY,
'country' => '6',
]);
$ch = curl_init("$BASE_URL/api/services?$query");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;
Contoh Response:
Response
{
"success": true,
"services": [
{
"id": "3",
"name": "WhatsApp",
"code": "wa"
},
{
"id": "4",
"name": "Telegram",
"code": "tg"
}
]
}DDaftar Operator dan Harga
- Method: GET
- URL:
https://kodenara.biz.id/api/products
Parameter:
- apikey (string, wajib) : API Key akun kamu
- country (string, wajib) : ID negara
- service (string, wajib) : ID platform dari endpoint Daftar Platform
Catatan:
- Harga sudah final (sudah termasuk biaya layanan) dan bisa langsung dipakai untuk order.
- Hasil diurutkan dari harga termurah.
Contoh Request:
const axios = require('axios');
const BASE_URL = 'https://kodenara.biz.id';
const API_KEY = 'YOUR_API_KEY';
axios
.get(`${BASE_URL}/api/products`, {
params: {
apikey: API_KEY,
country: '6',
service: '3',
},
})
.then((res) => console.log(res.data))
.catch((err) => console.log(err.response ? err.response.data : err.message));
import requests
BASE_URL = "https://kodenara.biz.id"
API_KEY = "YOUR_API_KEY"
res = requests.get(
f"{BASE_URL}/api/products",
params={
"apikey": API_KEY,
"country": "6",
"service": "3",
},
)
print(res.json())
curl -X GET -G "https://kodenara.biz.id/api/products" \ --data-urlencode "apikey=YOUR_API_KEY" \ --data-urlencode "country=6" \ --data-urlencode "service=3"
<?php
$BASE_URL = 'https://kodenara.biz.id';
$API_KEY = 'YOUR_API_KEY';
$query = http_build_query([
'apikey' => $API_KEY,
'country' => '6',
'service' => '3',
]);
$ch = curl_init("$BASE_URL/api/products?$query");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;
Contoh Response:
Response
{
"success": true,
"products": [
{
"id": "142",
"name": "Operator otomatis",
"price": 4200,
"stock": 36
}
]
}EMembuat Order
- Method: POST (GET juga didukung)
- URL:
https://kodenara.biz.id/api/order
Parameter:
- apikey (string, wajib) : API Key akun kamu
- country (string, wajib) : ID negara
- service (string, wajib) : ID platform
- product (string, wajib) : ID operator dari endpoint Daftar Operator dan Harga
- idempotency_key (string, opsional) : Kunci unik 8 sampai 64 karakter (huruf, angka, garis bawah). Bisa juga lewat header Idempotency-Key
Catatan:
- 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 Request:
const axios = require('axios');
const BASE_URL = 'https://kodenara.biz.id';
const API_KEY = 'YOUR_API_KEY';
axios
.post(`${BASE_URL}/api/order`, null, {
params: {
apikey: API_KEY,
country: '6',
service: '3',
product: '142',
},
})
.then((res) => console.log(res.data))
.catch((err) => console.log(err.response ? err.response.data : err.message));
import requests
BASE_URL = "https://kodenara.biz.id"
API_KEY = "YOUR_API_KEY"
res = requests.post(
f"{BASE_URL}/api/order",
params={
"apikey": API_KEY,
"country": "6",
"service": "3",
"product": "142",
},
)
print(res.json())
curl -X POST -G "https://kodenara.biz.id/api/order" \ --data-urlencode "apikey=YOUR_API_KEY" \ --data-urlencode "country=6" \ --data-urlencode "service=3" \ --data-urlencode "product=142"
<?php
$BASE_URL = 'https://kodenara.biz.id';
$API_KEY = 'YOUR_API_KEY';
$query = http_build_query([
'apikey' => $API_KEY,
'country' => '6',
'service' => '3',
'product' => '142',
]);
$ch = curl_init("$BASE_URL/api/order?$query");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;
Contoh Response:
Response
{
"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"
}
}FCek Status Order dan SMS Code
- Method: GET
- URL:
https://kodenara.biz.id/api/order/status
Parameter:
- apikey (string, wajib) : API Key akun kamu
- order_id (integer, wajib) : ID order
Catatan:
- Nilai status: waiting, success, canceled, expired.
- SMS Code muncul di kolom otp saat status success. Disarankan polling setiap 5 detik.
Contoh Request:
const axios = require('axios');
const BASE_URL = 'https://kodenara.biz.id';
const API_KEY = 'YOUR_API_KEY';
axios
.get(`${BASE_URL}/api/order/status`, {
params: {
apikey: API_KEY,
order_id: 'YOUR_ORDER_ID',
},
})
.then((res) => console.log(res.data))
.catch((err) => console.log(err.response ? err.response.data : err.message));
import requests
BASE_URL = "https://kodenara.biz.id"
API_KEY = "YOUR_API_KEY"
res = requests.get(
f"{BASE_URL}/api/order/status",
params={
"apikey": API_KEY,
"order_id": "YOUR_ORDER_ID",
},
)
print(res.json())
curl -X GET -G "https://kodenara.biz.id/api/order/status" \ --data-urlencode "apikey=YOUR_API_KEY" \ --data-urlencode "order_id=YOUR_ORDER_ID"
<?php
$BASE_URL = 'https://kodenara.biz.id';
$API_KEY = 'YOUR_API_KEY';
$query = http_build_query([
'apikey' => $API_KEY,
'order_id' => 'YOUR_ORDER_ID',
]);
$ch = curl_init("$BASE_URL/api/order/status?$query");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;
Contoh Response:
Response
{
"success": true,
"order": {
"order_id": 1024,
"status": "success",
"number": "+6281234567890",
"otp": "482916",
"price": 4200
}
}GBatalkan Order
- Method: POST (GET juga didukung)
- URL:
https://kodenara.biz.id/api/order/cancel
Parameter:
- apikey (string, wajib) : API Key akun kamu
- order_id (integer, wajib) : ID order
Catatan:
- Hanya order berstatus waiting yang bisa dibatalkan, saldo dikembalikan penuh.
- Provider hanya mengizinkan pembatalan setelah 2 menit sejak order dibuat.
Contoh Request:
const axios = require('axios');
const BASE_URL = 'https://kodenara.biz.id';
const API_KEY = 'YOUR_API_KEY';
axios
.post(`${BASE_URL}/api/order/cancel`, null, {
params: {
apikey: API_KEY,
order_id: 'YOUR_ORDER_ID',
},
})
.then((res) => console.log(res.data))
.catch((err) => console.log(err.response ? err.response.data : err.message));
import requests
BASE_URL = "https://kodenara.biz.id"
API_KEY = "YOUR_API_KEY"
res = requests.post(
f"{BASE_URL}/api/order/cancel",
params={
"apikey": API_KEY,
"order_id": "YOUR_ORDER_ID",
},
)
print(res.json())
curl -X POST -G "https://kodenara.biz.id/api/order/cancel" \ --data-urlencode "apikey=YOUR_API_KEY" \ --data-urlencode "order_id=YOUR_ORDER_ID"
<?php
$BASE_URL = 'https://kodenara.biz.id';
$API_KEY = 'YOUR_API_KEY';
$query = http_build_query([
'apikey' => $API_KEY,
'order_id' => 'YOUR_ORDER_ID',
]);
$ch = curl_init("$BASE_URL/api/order/cancel?$query");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;
Contoh Response:
Response
{
"success": true,
"order_id": 1024,
"status": "canceled",
"refunded": 4200,
"balance": 25000
}HRiwayat Order
- Method: GET
- URL:
https://kodenara.biz.id/api/orders
Parameter:
- apikey (string, wajib) : API Key akun kamu
- status (string, opsional) : waiting, success, canceled, atau expired
- limit (integer, opsional) : Jumlah data, default 20, maksimal 100
Contoh Request:
const axios = require('axios');
const BASE_URL = 'https://kodenara.biz.id';
const API_KEY = 'YOUR_API_KEY';
axios
.get(`${BASE_URL}/api/orders`, {
params: {
apikey: API_KEY,
},
})
.then((res) => console.log(res.data))
.catch((err) => console.log(err.response ? err.response.data : err.message));
import requests
BASE_URL = "https://kodenara.biz.id"
API_KEY = "YOUR_API_KEY"
res = requests.get(
f"{BASE_URL}/api/orders",
params={
"apikey": API_KEY,
},
)
print(res.json())
curl -X GET -G "https://kodenara.biz.id/api/orders" \ --data-urlencode "apikey=YOUR_API_KEY"
<?php
$BASE_URL = 'https://kodenara.biz.id';
$API_KEY = 'YOUR_API_KEY';
$query = http_build_query([
'apikey' => $API_KEY,
]);
$ch = curl_init("$BASE_URL/api/orders?$query");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;
Contoh Response:
Response
{
"success": true,
"orders": [
{
"order_id": 1024,
"service": "WhatsApp",
"status": "success",
"price": 4200,
"created_at": "2026-01-01 12:00:00"
}
]
}IMembuat Invoice Deposit
- Method: GET
- URL:
https://kodenara.biz.id/api/deposit
Parameter:
- apikey (string, wajib) : API Key akun kamu
- amount (integer, wajib) : Nominal saldo yang masuk (minimal sesuai pengaturan, default 5000)
Catatan:
- Pembayaran lewat QRIS. Saldo masuk otomatis setelah pembayaran terdeteksi.
- Bayar sesuai nilai total persis.
Contoh Request:
const axios = require('axios');
const BASE_URL = 'https://kodenara.biz.id';
const API_KEY = 'YOUR_API_KEY';
axios
.get(`${BASE_URL}/api/deposit`, {
params: {
apikey: API_KEY,
amount: 50000,
},
})
.then((res) => console.log(res.data))
.catch((err) => console.log(err.response ? err.response.data : err.message));
import requests
BASE_URL = "https://kodenara.biz.id"
API_KEY = "YOUR_API_KEY"
res = requests.get(
f"{BASE_URL}/api/deposit",
params={
"apikey": API_KEY,
"amount": 50000,
},
)
print(res.json())
curl -X GET -G "https://kodenara.biz.id/api/deposit" \ --data-urlencode "apikey=YOUR_API_KEY" \ --data-urlencode "amount=50000"
<?php
$BASE_URL = 'https://kodenara.biz.id';
$API_KEY = 'YOUR_API_KEY';
$query = http_build_query([
'apikey' => $API_KEY,
'amount' => 50000,
]);
$ch = curl_init("$BASE_URL/api/deposit?$query");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;
Contoh Response:
Response
{
"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"
}JCek Status Deposit
- Method: GET
- URL:
https://kodenara.biz.id/api/deposit/status
Parameter:
- apikey (string, wajib) : API Key akun kamu
- deposit_id (string, wajib) : ID deposit
Catatan:
- Nilai status: pending, paid, expired, cancelled.
Contoh Request:
const axios = require('axios');
const BASE_URL = 'https://kodenara.biz.id';
const API_KEY = 'YOUR_API_KEY';
axios
.get(`${BASE_URL}/api/deposit/status`, {
params: {
apikey: API_KEY,
deposit_id: 'YOUR_DEPOSIT_ID',
},
})
.then((res) => console.log(res.data))
.catch((err) => console.log(err.response ? err.response.data : err.message));
import requests
BASE_URL = "https://kodenara.biz.id"
API_KEY = "YOUR_API_KEY"
res = requests.get(
f"{BASE_URL}/api/deposit/status",
params={
"apikey": API_KEY,
"deposit_id": "YOUR_DEPOSIT_ID",
},
)
print(res.json())
curl -X GET -G "https://kodenara.biz.id/api/deposit/status" \ --data-urlencode "apikey=YOUR_API_KEY" \ --data-urlencode "deposit_id=YOUR_DEPOSIT_ID"
<?php
$BASE_URL = 'https://kodenara.biz.id';
$API_KEY = 'YOUR_API_KEY';
$query = http_build_query([
'apikey' => $API_KEY,
'deposit_id' => 'YOUR_DEPOSIT_ID',
]);
$ch = curl_init("$BASE_URL/api/deposit/status?$query");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;
Contoh Response:
Response
{
"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"
}KBatalkan Deposit
- Method: POST (GET juga didukung)
- URL:
https://kodenara.biz.id/api/deposit/cancel
Parameter:
- apikey (string, wajib) : API Key akun kamu
- deposit_id (string, wajib) : ID deposit
Catatan:
- Hanya deposit berstatus pending yang bisa dibatalkan. Jangan bayar QR yang sudah dibatalkan.
Contoh Request:
const axios = require('axios');
const BASE_URL = 'https://kodenara.biz.id';
const API_KEY = 'YOUR_API_KEY';
axios
.post(`${BASE_URL}/api/deposit/cancel`, null, {
params: {
apikey: API_KEY,
deposit_id: 'YOUR_DEPOSIT_ID',
},
})
.then((res) => console.log(res.data))
.catch((err) => console.log(err.response ? err.response.data : err.message));
import requests
BASE_URL = "https://kodenara.biz.id"
API_KEY = "YOUR_API_KEY"
res = requests.post(
f"{BASE_URL}/api/deposit/cancel",
params={
"apikey": API_KEY,
"deposit_id": "YOUR_DEPOSIT_ID",
},
)
print(res.json())
curl -X POST -G "https://kodenara.biz.id/api/deposit/cancel" \ --data-urlencode "apikey=YOUR_API_KEY" \ --data-urlencode "deposit_id=YOUR_DEPOSIT_ID"
<?php
$BASE_URL = 'https://kodenara.biz.id';
$API_KEY = 'YOUR_API_KEY';
$query = http_build_query([
'apikey' => $API_KEY,
'deposit_id' => 'YOUR_DEPOSIT_ID',
]);
$ch = curl_init("$BASE_URL/api/deposit/cancel?$query");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;
Contoh Response:
Response
{
"success": true,
"deposit_id": "DEP9X2K41",
"status": "cancelled"
}