API Dongtube

Mengembalikan saldo akun yang terkait dengan API Key.

{ "balance": 0 }

{
  "success": true,
  "type": "dynamic",
  "invoice_id": "{invoice_id}",
  "amount": 0,
  "fee": 0,
  "total": 0,
  "qris_image": "{qris_image_url}",
  "expired_at": "{expiration_time}"
}

Nilai qris_image berisi path gambar QRIS relatif terhadap origin situs (contoh /img-cache/qris-1234567890.png); gabungkan dengan origin situs untuk memperoleh URL lengkapnya. Pembuatan invoice dibatasi 30 kali per menit.

{
  "invoice_id": "{invoice_id}",
  "amount": 0,
  "fee": 0,
  "total": 0,
  "status": "{invoice_status}",
  "qris_image": "{qris_image_url}",
  "expired_at": "{expiration_time}",
  "created_at": "{created_at}"
}

Status memberi tahu apakah pembayaran masih menunggu, sudah dibayar, atau sudah kedaluwarsa. Polling endpoint ini aman diulang: pemeriksaan berulang tidak pernah menggandakan tagihan.

Atur URL webhook di halaman Profil. Apabila deposit lunas, sistem mengirim POST JSON ke URL tersebut. Verifikasi kebenaran melalui header X-Signature = sha256=HMAC-SHA256(body, API Key) terhadap body mentah, bukan hasil parse ulang JSON. Balas 2xx untuk konfirmasi penerimaan; gagal atau timeout dicoba ulang 1x.

// Body yang dikirim ke URL Anda
{
  "event": "invoice.paid",
  "invoice_id": "{invoice_id}",
  "amount": 0,
  "fee": 0,
  "total": 0,
  "status": "paid",
  "paid_at": "{payment_time}"
}

// Verifikasi (Node.js), hash body MENTAH, bukan hasil parse
const crypto = require('crypto');

const expected = 'sha256=' + crypto
  .createHmac('sha256', API_KEY)
  .update(rawBody)
  .digest('hex');

if (expected !== req.headers['x-signature']) return res.sendStatus(401);

Langkah pertama dan wajib dipanggil setiap kali membangun form pencairan. Tidak ada parameter. Mengembalikan daftar e-wallet beserta batas nominal per e-wallet, daftar kode bank, biaya admin yang berlaku, serta batas nominal bank.

{
  "success": true,
  "fee": 2500,
  "ewallet": [
    { "code": "DANA",      "name": "DANA",      "min": 20000, "max": 2000000 },
    { "code": "GOPAY",     "name": "GoPay",     "min": 10000, "max": 2000000 },
    { "code": "OVO",       "name": "OVO",       "min": 10000, "max": 2000000 },
    { "code": "LINKAJA",   "name": "LinkAja",   "min": 10000, "max": 2000000 },
    { "code": "SHOPEEPAY", "name": "ShopeePay", "min": 10000, "max": 2000000 }
  ],
  "bank": [
    { "code": "008", "name": "Mandiri" },
    { "code": "009", "name": "BNI" },
    { "code": "002", "name": "BRI" }
  ],
  "bank_min": 10000,
  "bank_max": 50000000
}

Nilai code inilah yang nanti dikirim sebagai code pada langkah inquiry dan topup. Daftar bank memuat kode virtual account dan katalog bank nasional, jadi ratusan kode tersedia, jangan di-hardcode, ambil dari endpoint ini.

Baca-saja dan tidak menggerakkan uang: pemanggilan ini tidak memotong saldo. Wajib dipanggil lebih dulu untuk memperoleh account_name, yang lalu dikirim apa adanya ke endpoint topup. Tampilkan hasilnya ke pengguna sebagai konfirmasi sebelum konfirmasi pencairan.

{
  "success": true,
  "type": "bank",
  "account_name": "NAMA PEMILIK REKENING",
  "provider": "Bank Mandiri"
}

{
  "success": true,
  "status": "pending",
  "amount": 50000,
  "fee": 2500,
  "account_name": "NAMA PEMILIK REKENING"
}

Langkah terakhir membuat permintaan pencairan: status mengembalikan pending (permintaan menunggu persetujuan admin), bukan dana yang langsung dikirim. Saldo amount + fee sudah dipotong saat permintaan dibuat dan akan kembali penuh bila admin menolak.

Perhatikan jumlah yang dipotong dari saldo. Saldo dipotong sebesar amount + fee, bukan amount. Jadi untuk mencairkan Rp50.000 ke tujuan dengan biaya Rp2.500, saldo harus tersedia Rp52.500.

{
  "success": true,
  "products": [
    {
      "id": "{product_id}",
      "name": "{product_name}",
      "description": "{product_description}",
      "price": 0,
      "status": "{availability_status}",
      "stock": 0,
      "image": "{image_url}"
    }
  ]
}

Field status dan stock menunjukkan ketersediaan produk.

{
  "success": true,
  "order": {
    "_id": "{order_id}",
    "productId": 0,
    "productName": "{product_name}",
    "qty": 1,
    "amount": 0,
    "status": "{status_pesanan}",
    "accounts": [],
    "providerInvoice": "{provider_invoice}",
    "createdAt": "{created_at}"
  }
}

{
  "success": true,
  "order": {
    "_id": "{order_id}",
    "productName": "{product_name}",
    "amount": 0,
    "status": "{status_pesanan}",
    "accounts": [],
    "providerInvoice": "{provider_invoice}",
    "createdAt": "{created_at}"
  }
}

Field accounts hanya terisi saat status success.

{
  "success": true,
  "product_id": 0,
  "product": "{product_name}",
  "stock": 0
}

Angka stok diambil segar dari sistem setiap permintaan (tidak memakai cache katalog 5 menit). Sistem tidak dapat dihubungi menghasilkan kode 502, bukan angka karangan.

{
  "success": true,
  "count": 2250,
  "services": [
    {
      "id": "1234",
      "name": "{nama_layanan}",
      "category": "{kategori}",
      "type": "default",
      "type_label": "Standar",
      "price_mode": "per_1000",
      "price_per_1000": 11512,
      "min_price": 117,
      "min": 10,
      "max": 300000,
      "refill": false,
      "fields": [
        { "key": "target", "required": true, "label": "Target layanan", "input": "text", "hint": "..." },
        { "key": "quantity", "required": true, "label": "Jumlah pesanan", "input": "number" }
      ],
      "target_format": { "kind": "url", "label": "link channel, grup, atau post", "contoh": "https://t.me/contoh" },
      "description": "{deskripsi}"
    }
  ]
}

Katalog berisi lebih dari 2.000 layanan, simpan cadangan di sisi Anda karena isinya jarang berubah. price_per_1000 adalah harga per 1.000 unit, atau harga total apabila price_mode bernilai total. min_price adalah biaya yang benar-benar dibebankan untuk memesan sesuai min. Keduanya adalah harga final. fields menyebutkan parameter beserta batas karakter yang diterima; kirim hanya field bertanda required.

{
  "success": true,
  "order": {
    "id": "{order_id}",
    "service_id": "1234",
    "service_name": "{nama_layanan}",
    "category": "{kategori}",
    "target": "{target}",
    "quantity": 1000,
    "amount": 11500,
    "status": "pending",
    "provider_order_id": "56789",
    "provider_status": "Pending",
    "refill": { "supported": false, "id": null, "status": null, "requested_at": null },
    "refund": { "refunded": false, "amount": 0, "partial": false, "partial_amount": 0 },
    "start_count": null,
    "remains": null,
    "created_at": "{tanggal}",
    "updated_at": "{tanggal}"
  },
  "duplicate": false
}

Parameter limit bernilai 1-100 (bawaan 20). Hingga 5 pesanan terbaru yang masih berjalan disegarkan statusnya sebelum dibalas.

{
  "success": true,
  "count": 20,
  "orders": [ { "id": "{order_id}", "status": "completed", "...": "..." } ]
}

Memakai ID internal pesanan. Apabila status masih pending atau processing, statusnya disegarkan langsung sehingga Anda tidak perlu menunggu pembaruan latar.

{
  "success": true,
  "order": {
    "id": "{order_id}",
    "status": "completed",
    "quantity": 1000,
    "amount": 11500,
    "provider_status": "Completed",
    "start_count": 0,
    "remains": 0,
    "refund": { "refunded": false, "amount": 0, "partial": false, "partial_amount": 0 }
  }
}

Tidak ada isi permintaan. Hanya layanan bertanda refill: true dan pesanan berstatus completed/partial yang diterima. Pengajuan kembar dibalas dengan "reused": true beserta refill yang sedang berjalan.

{
  "success": true,
  "reused": false,
  "refill_id": "555",
  "refill_status": "pending",
  "order_id": "66a1f0c2b3d4e5f6a7b8c9d0"
}

Selama refill_status masih pending/processing, setiap pemanggilan membaca status terbaru langsung dari sistem. Nilai: pending, processing, success, atau failed (terminal). Bila pengajuan ditolak, nilainya berisi catatan penolakan yang diawali ditolak:.

{
  "success": true,
  "refill_id": "555",
  "refill_status": "success",
  "refill_requested_at": "2026-09-27T08:33:37.056Z",
  "order_status": "completed"
}

Tidak ada isi permintaan. Respons memuat count, default, dan countries berisi { id, name, flag } untuk semua country_id yang diterima oleh /services dan /order. country_id tetap opsional (bawaan mengikuti pengaturan akun, mis. 7 = Indonesia).

Parameter opsional country_id (tanpa parameter memakai default akun). Katalog, harga, dan stok berbeda untuk tiap negara; daftar ID-nya ada di GET /api/otp/countries. Respons memuat success, country yang dipakai ({ id, name }), count, dan services: { service_code, service_name, product_id, price, stock, tiers } urut popularitas. service_code adalah ID platform layanan (contoh 1 = WhatsApp). Harga adalah harga final dalam Rupiah.

product_id menunjuk satu harga/tier pasti, dan tiers memuat SELURUH harga layanan itu di negara terpilih, { product_id, price, stock, operator, operator_id } urut harga menaik, termasuk yang stoknya sedang kosong (stock: 0). Kirim salah satu product_id itu ke /order untuk mengunci harganya. Tier price/stock/product_id di level layanan adalah harga termurah yang sedang berstok, sama dengan pemakaian tanpa product_id.

Respons memuat count dan operators: { operator_id, code, name, local_name }. Daftar kosong berarti kombinasi itu memang tanpa pilihan carrier, pesanan tetap jalan tanpa operator_id (carrier dipilih otomatis).

Respons memuat count, limit, offset, dan orders. Nilai status di luar daftar dijawab 400.

Selama pesanan berstatus active, endpoint ini membaca kode terbaru begitu SMS tiba: otp terisi dan status berubah menjadi received. Panggil berulang selama nomor masih menunggu.

Tidak ada isi permintaan. Hanya pesanan berstatus active yang dapat dibatalkan; status lain menjawab 409. Pembatalan terlalu dini ditolak dengan pesan kapan bisa dicoba lagi. Saldo dikembalikan penuh setelah pembatalan dikonfirmasi; SMS yang sudah diterima membuat pesanan tidak dapat dibatalkan.

Tidak ada isi permintaan. Hanya pesanan berstatus received yang bisa ditandai selesai; status lain menjawab 409. Setelah selesai, pesanan keluar dari daftar aktif, kode tetap terlihat di riwayat dan tidak ada pengembalian dana.

Tidak ada isi permintaan. Hanya berlaku selama pesanan masih berstatus active. Sistem dapat menahan pengiriman ulang sesaat setelah order dibuat, pesan penolakan berisi kapan bisa dicoba lagi. Respons memuat resent (bool): false berarti platform tersebut memang tidak mendukung pengiriman ulang.

Baca-saja dan tanpa biaya. Membalas available: true beserta cost (biaya dasar) dan price (harga yang dibebankan ke saldo Anda). Nomor yang tidak memenuhi syarat membalas available: false beserta alasannya.

Tidak ada isi permintaan. Mengaktifkan kembali nomor dari pesanan yang sudah selesai untuk verifikasi berikutnya, nomor sama, pesanan baru (saldo dipotong sesuai price dari pratinjau; bila biaya naik saat eksekusi, pesanan dibatalkan otomatis dan saldo kembali utuh). Hanya nomor yang memenuhi syarat; sisanya menjawab 409. Klik ganda dalam hitungan detik membalas duplicate: true.

{
  "plan": "{plan_name}",
  "planLabel": "{plan_label}",
  "storageLimit": 0,
  "storageUsed": 0,
  "storageAvailable": 0,
  "expiresAt": "{expiration_time}"
}

Parameter limit (bawaan 20, maksimal 100) dan offset.

{
  "success": true,
  "total": 0,
  "data": [{
    "id": "{file_id}",
    "originalName": "{file_name}",
    "mimeType": "{mime_type}",
    "size": 0,
    "isPublic": false,
    "downloads": 0,
    "uploadedAt": "{upload_time}",
    "cdnUrl": "{cdn_file_url}"
  }]
}

Kirim sebagai multipart/form-data. Field wajib file; field opsional public (1 = publik, 0 = privat, bawaan 0). Data melebihi batas ukuran dijawab 413.

{ "success": true, "fileId": "{file_id}", "name": "{file_name}", "size": 0, "cdnUrl": "{cdn_file_url}" }

{ "success": true }

File publik: langsung diakses tanpa header, cocok untuk gambar di website. File privat: wajib menyertakan header X-API-Key.

// SELECT
{ "success": true, "rows": [...], "count": 1 }

// INSERT / UPDATE / DELETE
{ "success": true, "changes": 1, "lastInsertRowid": 7 }

Semua pernyataan dijalankan dalam satu transaksi SQLite: perubahan diterapkan seluruhnya jika berhasil, atau dibatalkan bila terjadi kegagalan. Maksimal 100 pernyataan per batch.

Operasi CRUD melalui /db/api/v2/:table/rows. Filter diberikan sebagai parameter kueri memakai operator eq neq gt gte lt lte like in is. Nama tabel dan kolom adalah identifier yang harus sesuai skema, bukan nilai yang dapat diikat sebagai parameter.

GET    /db/api/v2/{table_name}/rows?{column_name}=eq.{value}&select={column_list}&order={column_name}.desc&limit={limit}&count=exact
POST   /db/api/v2/{table_name}/rows       body: {object_payload} | [{object_payload}, ...]  (maksimal 1.000)
POST   /db/api/v2/{table_name}/rows?on_conflict={column_name}   (upsert)
PATCH  /db/api/v2/{table_name}/rows?{column_name}=eq.{value}   body: {changes_payload}  (filter wajib)
DELETE /db/api/v2/{table_name}/rows?{column_name}=eq.{value}   (filter wajib)

{ "success": true, "tables": [{ "name": "{table_name}", "rows": 0, "columns": 0 }], "count": 1 }

Parameter limit (bawaan 100, maksimum 1.000) dan offset.

{
  "success": true,
  "table": "{table_name}",
  "schema": [{ "cid": 0, "name": "{column_name}", "type": "{data_type}", "pk": 0 }],
  "rows": [{ "{column_name}": "{value}" }],
  "total": 0,
  "limit": 100,
  "offset": 0
}

Nama tabel dibersihkan menjadi identifier (huruf, angka, garis bawah). Tabel yang tidak ada tetap dijawab sukses.

{ "success": true }

Tambahkan ?format=json untuk JSON. Secara default hasil diekspor sebagai file CSV. Maksimal 100.000 baris.

Tidak ada endpoint push, WebSocket dan SSE sudah dihapus. Klien mengikuti perubahan dengan menarik baris yang lebih baru dari kursor terakhir, lalu mengulanginya dengan interval yang menyesuaikan aktivitas.

// 1. Simpan updatedAt terakhir sebagai kursor
cursor = 0

// 2. Tarik baris yang berubah sejak kursor
GET /db/api/v2/{table_name}/rows?updatedAt=gt.{cursor}&select=key,value,updatedAt&order=updatedAt.asc&limit=1000
-> { "success": true, "rows": [ ... ], "count": 3 }

// 3. Naikkan kursor ke updatedAt maksimum hasil, ulangi
cursor = max(rows[].updatedAt)

Ekspor seluruh database (semua tabel dan data) ke satu file .db. File cadangan dapat dipulihkan ke akun yang sama atau akun lain dengan langganan aktif. Proses impor merupakan penggantian penuh: seluruh isi database tujuan akan diganti dengan isi file cadangan. Pencadangan juga tersedia melalui tab Impor/Ekspor di SQL Studio.

Ekspor database

File dongtubedb-backup-YYYY-MM-DD.db akan diunduh. Simpan file tersebut sebagai cadangan.

Impor / pulihkan database

Kirim file cadangan menggunakan multipart/form-data dengan field backup. File divalidasi (header SQLite dan pemeriksaan integritas) serta harus sesuai dengan kapasitas paket.

curl -X POST "https://{host}/db/api/backup/import" \
  -H "X-API-Key: {api_key}" \
  -F "backup=@{backup_file_path}"