💡 Contoh Penggunaan Fleksibel:

• /listkode
  → Menampilkan semua kategori dan isinya (JSON Map).
• /listkode?jenis=ewallet
  → Menampilkan daftar nama produk di kategori ewallet.
• /listkode?jenis=ewallet&type=DANA
  → Menampilkan detail kode & harga produk DANA.

{
    "code": 200,
    "status": "success",
    "data": [
        {
            "kode": "D1",
            "keterangan": "Dana 1.000",
            "produk": "Top Up Saldo DANA",
            "kategori": "DOMPET DIGITAL",
            "harga": "1250",
            "status": "1",
            "active": true
        },
        {
            "kode": "D2",
            "keterangan": "Dana 2.000",
            "produk": "Top Up Saldo DANA",
            "kategori": "DOMPET DIGITAL",
            "harga": "2250",
            "status": "1",
            "active": true
        },
        {
            "kode": "D3",
            "keterangan": "Dana 3.000",
            "produk": "Top Up Saldo DANA",
            "kategori": "DOMPET DIGITAL",
            "harga": "3250",
            "status": "1",
            "active": true
        }
    ]
}

{
  "code": 200,
  "status": "success",
  "total_stok": 1,
  "stok_kategori": {
    "8": 1
  },
  "data": [
    {
      "category": "8",
      "category_name": "ID 8",
      "phone_preview": "+6285****043",
      "price": 5000,
      "price_formatted": "Rp 5.000",
      "status": "available",
      "added_at": "2026-04-22T07:06:21.452Z"
    }
  ]
}

{
  "code": 200,
  "status": "success",
  "message": "Pembelian nomor berhasil.",
  "data": {
    "success": true,
    "invoice_id": "INV-1715400000000-USER_123",
    "account": {
      "id": "8642979616",
      "phone": "+6285802768043",
      "password_2fa": null,
      "price": 5000,
      "status": "sold",
      "added_at": "2026-04-22T07:06:21.452Z",
      "sold_at": "2026-09-14T01:00:00.000Z"
    },
    "current_balance": 45000
  }
}

{
  "code": 400,
  "status": "error",
  "message": "Saldo tidak cukup."
}

{
  "code": 200,
  "status": "success",
  "data": {
    "success": true,
    "otp": "Kode masuk Telegram: 48291. Jangan berikan kode ini kepada siapapun...",
    "login_detected": true,
    "new_device": {
      "device": "Telegram Desktop",
      "location": "Jakarta, Indonesia",
      "timestamp": "2026-09-14T01:05:00.000Z"
    }
  }
}

🔒 Proteksi Penguncian Invoice:

Begitu OTP berhasil terdeteksi dan diambil melalui endpoint ini, invoice akan otomatis dikunci (otp_received: true) dan tidak dapat dibatalkan/refund untuk mencegah kecurangan.

{
  "code": 200,
  "status": "success",
  "message": "Pembelian dibatalkan, saldo dikembalikan."
}

{
  "code": 400,
  "status": "error",
  "message": "Pembatalan ditolak. OTP sudah terkirim/terdeteksi masuk pada nomor ini."
}

{
  "code": 200,
  "status": "success",
  "data": [
    {
      "id": "INV-1715400000000-USER_123",
      "id_user": "USER_123",
      "account_id": "6281234567890",
      "phone": "+6281234567890",
      "price": 3500,
      "status": "sukses",
      "timestamp": "2026-09-14T01:00:00.000Z",
      "type": "NOKTEL",
      "otp_received": true
    }
  ]
}

Daftar Harga & Kategori Noktel (Live Rates)

{ "status": "Memuat data..." }

{
  "code": 200,
  "status": "success",
  "session_token": "7a9f82bc...",
  "phone": "+628518000000",
  "delivery_type": "app",
  "timeout": 300,
  "message": "Kode OTP Telegram telah terkirim via aplikasi/SMS."
}

{
  "code": 200,
  "status": "success",
  "message": "Nomor berhasil dijual dan diverifikasi 100% steril! Saldo Rp 3.000 telah ditambahkan ke akun Anda.",
  "data": {
    "invoice_id": "JUAL-1718880000000-A1B2C3",
    "category": "8",
    "category_name": "ID 8",
    "nominal_diterima": 3000,
    "nominal_formatted": "Rp 3.000",
    "saldo_akhir": 53000
  }
}

{
  "code": 200,
  "status": "success",
  "id_user": "USER_123",
  "data": {
    "id_transfer": "Mining-040169A4",
    "amount": 50,
    "timestamp": "2026-04-18T08:29:21.952Z",
    "type": "terima",
    "from": {
      "id_user": "SYSTEM",
      "va": "0000000000",
      "name": "SYSTEM MINING REWARD"
    },
    "to": {
      "id_user": "USER_123",
      "va": "8880000USER_123",
      "name": "Nama Pengguna"
    },
    "note": "Reward SHA256 (Diff: 4)",
    "BotNotif": "Sukses"
  }
}

{
  "code": 404,
  "status": "error",
  "message": "Data mining 'Mining-040169A4' tidak ditemukan."
}

{
  "code": 200,
  "status": "success",
  "total": 2,
  "data": [
    {
      "id_transfer": "Mining-2731E602",
      "amount": 50,
      "timestamp": "2026-04-20T19:29:42.169Z",
      "type": "terima",
      "from": {
        "id_user": "SYSTEM",
        "va": "0000000000",
        "name": "SYSTEM MINING REWARD"
      },
      "to": {
        "id_user": "USER_123",
        "va": "8880000USER_123",
        "name": "Nama Pengguna"
      },
      "note": "Reward SHA256 (Diff: 5)",
      "BotNotif": "Sukses"
    },
    {
      "id_transfer": "Mining-7E788FD9",
      "amount": 50,
      "timestamp": "2026-04-20T19:23:04.743Z",
      "type": "terima",
      "from": {
        "id_user": "SYSTEM",
        "va": "0000000000",
        "name": "SYSTEM MINING REWARD"
      },
      "to": {
        "id_user": "USER_123",
        "va": "8880000USER_123",
        "name": "Nama Pengguna"
      },
      "note": "Reward SHA256 (Diff: 4)",
      "BotNotif": "Sukses"
    }
  ]
}

{
  "code": 401,
  "status": "error",
  "message": "Token tidak valid."
}

{
  "code": 200,
  "status": "success",
  "message": "T#1160418384 R#zakki03 Top Up Saldo DANA 082137435046 akan diproses. Saldo 666.182 - 1.038 = 665.144 @21:24",
  "data": {
    "refID": "zakki03",
    "serverID": "1160418384",
    "produk": "Top Up Saldo DANA",
    "tujuan": "082137435046",
    "harga": 1038,
    "status": "PROCESS",
    "sn": "Cek Berkala",
    "waktu": "12/04/2026, 21.24.24",
    "sisa_saldo": 665144,
    "callback": "WAITING",
    "BotNotif": "WAITING"
  }
}

{
  "code": 200,
  "status": "success",
  "id_user": "USER_123",
  "data": {
    "refID": "zakki03",
    "serverID": "1160418384",
    "produk": "Top Up Saldo DANA",
    "tujuan": "082137435046",
    "harga": 1038,
    "status": "SUCCESS",
    "sn": "DNID AHMXX12345678",
    "waktu": "14/09/2026 00:35:10",
    "sisa_saldo": 665144,
    "callback": "Sukses",
    "BotNotif": "Sukses"
  }
}

{
  "code": 200,
  "status": "success",
  "total_h2h": 20,
  "data": [
    {
      "refID": "zakki03",
      "serverID": "1160418384",
      "produk": "Top Up Saldo DANA",
      "tujuan": "082137435046",
      "harga": 1038,
      "status": "SUCCESS",
      "sn": "DNID AHMXX12345678",
      "waktu": "14/09/2026 00:35:10",
      "sisa_saldo": 665144,
      "callback": "Sukses",
      "BotNotif": "Sukses"
    }
  ]
}

{
  "code": 200,
  "status": "success",
  "message": "IP 103.150.190.1 berhasil ditambahkan ke whitelist Anda.",
  "whitelisted_ips": [
    "103.150.190.1"
  ]
}

{
  "code": 200,
  "status": "success",
  "message": "IP 103.150.190.1 berhasil dihapus dari whitelist Anda.",
  "whitelisted_ips": []
}

{
  "code": 400,
  "status": "error",
  "message": "Maksimal 3 IP yang dapat di-whitelist."
}

{
    "code": 200,
    "status": "success",
    "data": {
        "bank_detail": {
            "bank_name": "BANK ZAKKI STORE",
            "account_holder": "Nama Pengguna",
            "virtual_account": "8880000USER_123",
            "balance": 150000,
            "currency": "IDR",
            "status": "ACTIVE"
        },
        "user_detail": {
            "telegram_id": "123456789",
            "nama": "Nama Pengguna",
            "email": "user@example.com",
            "poin": 1250,
            "total_h2h": 12,
            "callback": "https://yourserver.com/callback"
        },
        "referral": {
            "kode_referral": "USER_123",
            "referral_link": "https://t.me/MrLow_bot?start=ref_USER_123",
            "total_referrals": 15,
            "total_reward": 750
        },
        "prestasi": {
            "total_sertifikat": 2,
            "daftar_prestasi": [
                {
                    "title": "TOP 10 SULTAN DEPOSIT",
                    "badge": "GOLD",
                    "date": "14/09/2026"
                }
            ]
        },
        "security_audit": {
            "status_keamanan": "Terlindungi",
            "aktivitas_terakhir": "Top Up QRIS",
            "waktu_aktivitas": "Selasa, 21 Mei 2024 pukul 17:01:15 WIB",
            "pesan_sistem": "Sistem Audit AI kami mengonfirmasi bahwa seluruh saldo dan mutasi Anda sinkron 100%. Akun Anda aman."
        },
        "riwayat_transaksi": [
            {
                "id_transaksi": "topup-abcd-USER_123",
                "id_user": "USER_123",
                "tipe": "TOPUP",
                "nominal_asli": 50000,
                "kode_unik": 123,
                "nominal_total": 50123,
                "status": "SUCCESS",
                "created_at": "2024-05-21T10:00:00.000Z",
                "settlement_time": "2024-05-21T10:01:15.000Z",
                "rrn": "123456789012",
                "reward": {
                    "poin_didapat": 5,
                    "message": "Selamat kamu mendapat 5 point dari topup Rp 50.123"
                }
            }
        ]
    }
}

ℹ️ Mengenal Object security_audit:

Sistem kami melakukan audit real-time setiap kali Anda mengakses endpoint ini. Berikut adalah kemungkinan status yang muncul:

• 🟢 Terlindungi: Saldo dan Poin Anda sinkron 100% dengan seluruh riwayat transaksi.
• 🟡 Pengecekan Manual Diperlukan: Muncul jika sistem mendeteksi ketidaksinkronan data.
  • Jika saldo berkurang karena kesalahan sistem, Anda akan diminta menghubungi Admin.
  • Jika terdeteksi manipulasi saldo/poin secara ilegal (eksploitasi), akun berisiko Banned Permanen.

{
    "code": 404,
    "message": "Akun tidak ditemukan."
}

{
    "code": 403,
    "message": "Token salah / tidak valid."
}

Saat request berhasil, server akan mengembalikan QRIS yang bisa ditampilkan sebagai gambar.

Contoh Tampilan QRIS:

Nilai qris_image pada response berisi URL gambar ini.

{
    "code": 201,
    "status": "success",
    "message": "Silakan bayar sesuai TOTAL dalam 10 menit.",
    "data": {
        "id_transaksi": "topup-a1b2-USER_456",
        "rincian": {
            "nominal_request": 50000,
            "kode_unik": 231,
            "total_bayar": 50231
        },
        "expired_at": "2024-05-21T12:05:00.000Z",
        "qris_image": "https://pixhost.to/show/123/qris_zakki.png",
        "qris_content": "00020101021226...[string qris lengkap]...585E",
        "cancel_url": "https://zpr0.com/cancel?token=TOKEN_ANDA&id_transaksi=topup-a1b2-USER_456",
        "cektopup_url": "https://zpr0.com/cektopup?idtopup=topup-a1b2-USER_456",
        "petunjuk_cek": "Simpan ID 'topup-a1b2-USER_456' ATAU kode unik 'a1b2' for cek status nanti."
    }
}

{
    "code": 401,
    "message": "Token invalid."
}

Saat request berhasil, server akan mengembalikan QRIS GoPay yang bisa ditampilkan sebagai gambar.

{
    "code": 201,
    "status": "success",
    "message": "Silakan bayar sesuai TOTAL dalam 10 menit menggunakan QRIS GOPAY.",
    "data": {
        "id_transaksi": "topup-a1b2-USER_456",
        "provider": "gopay",
        "rincian": {
            "nominal_request": 50000,
            "kode_unik": 231,
            "total_bayar": 50231
        },
        "expired_at": "2026-07-29T12:05:00.000Z",
        "qris_image": "https://tmpfiles.org/dl/1785318208.59fb4bcaeda24af3/wVwYiwTxp0oW/qris_zakki.png",
        "qris_content": "GOPAY_QRIS_DYNAMIC",
        "cancel_url": "https://zpr0.com/cancel?token=TOKEN_ANDA&id_transaksi=topup-a1b2-USER_456",
        "cektopup_url": "https://zpr0.com/cektopup?idtopup=topup-a1b2-USER_456",
        "petunjuk_cek": "Simpan ID 'topup-a1b2-USER_456' ATAU kode unik 'a1b2' untuk cek status nanti."
    }
}

{
    "code": 401,
    "message": "Token invalid."
}

Saat request berhasil, server akan mengembalikan QRIS ShopeePay yang bisa ditampilkan sebagai gambar.

{
    "code": 201,
    "status": "success",
    "message": "Silakan bayar sesuai TOTAL dalam 10 menit menggunakan QRIS SHOPEEPAY.",
    "data": {
        "id_transaksi": "topup-a1b2-USER_456",
        "provider": "shopee",
        "rincian": {
            "nominal_request": 50000,
            "kode_unik": 231,
            "total_bayar": 50231
        },
        "expired_at": "2026-08-15T12:05:00.000Z",
        "qris_image": "https://tmpfiles.org/dl/1786731390.8505564d624eefa5/wtwiSoJ50GzB/qris_zakki.png",
        "qris_content": "00020101021226610016ID.CO.SHOPEE.WWW...",
        "cancel_url": "https://zpr0.com/cancel?token=TOKEN_ANDA&id_transaksi=topup-a1b2-USER_456",
        "cektopup_url": "https://zpr0.com/cektopup?idtopup=topup-a1b2-USER_456",
        "petunjuk_cek": "Simpan ID 'topup-a1b2-USER_456' ATAU kode unik 'a1b2' untuk cek status nanti."
    }
}

{
    "code": 401,
    "message": "Token invalid."
}

{
    "code": 200,
    "status": "success",
    "message": "Berhasil membatalkan transaksi pending."
}

Muncul jika Anda hanya mengirim parameter token saja.

{
    "code": 200,
    "status": "success",
    "message": "Berhasil memuat daftar transaksi pending aktif.",
    "pending_list": [
        {
            "id_transaksi": "topup-abcd-1234",
            "total_bayar": 50123,
            "expired_at": "2024-05-21T12:05:00.000Z",
            "qris_image": "https://pixhost.to/show/123/qris_zakki.png"
        }
    ]
}

{
    "code": 404,
    "message": "Transaksi tidak ditemukan atau sudah kadaluarsa/terhapus."
}

{
    "code": 200,
    "status": "found",
    "kategori_status": "SUCCESS",
    "message": "Transaksi ditemukan di Riwayat SUCCESS.",
    "file_id": "topup-84c7b0bb-OX4K",
    "data": {
        "id_transaksi": "topup-84c7b0bb-OX4K",
        "id_user": "OX4K",
        "tipe": "TOPUP",
        "nominal_asli": 50000,
        "nominal_total": 50123,
        "status": "SUCCESS",
        "callback": "Sukses",
        "settlement_time": "2024-05-21T10:05:00.000Z",
        "reward": {
            "poin_didapat": 5,
            "message": "Selamat kamu mendapat 5 point dari topup Rp 50.123"
        }
    }
}

{
    "code": 404,
    "status": "not_found",
    "message": "Transaksi dengan ID atau Kata Kunci \"84c7b0bb\" tidak ditemukan di Pending maupun Sukses."
}

{
    "code": 400,
    "status": "error",
    "message": "Parameter \"idtopup\" wajib diisi. Masukkan ID lengkap atau ID unik tengahnya saja."
}

Mengembalikan file gambar image/png struk digital dinamis berdasarkan status transaksi (Success = Hijau, Pending = Kuning, Failed/Error/Not Found = Merah).

{
    "code": 200,
    "status": "success",
    "message": "Berhasil memuat data topup untuk Nama Pengguna.",
    "data": {
        "user_summary": {
            "nama": "Nama Pengguna",
            "saldo_aktif": 150000,
            "virtual_account": "8880000USER_123"
        },
        "statistik_topup": {
            "total_transaksi": 5,
            "total_uang_masuk": 250000,
            "total_uang_masuk_fmt": "Rp 250.000",
            "transaksi_terbesar": "Rp 100.000",
            "rata_rata_topup": "Rp 50.000"
        },
        "riwayat": [
            {
                "id_transaksi": "topup-a1b2-USER_123",
                "waktu": {
                    "request": "2024-05-21T10:00:00.000Z",
                    "sukses": "2024-05-21T10:05:00.000Z"
                },
                "pembayaran": {
                    "nominal_request": 50000,
                    "kode_unik": 123,
                    "total_bayar": 50123
                },
                "bank_data": {
                    "rrn_mutasi": "123456789",
                    "raw_mutasi": "Tersedia",
                    "callback_status": "Sukses",
                    "bot_notif": "Sukses"
                }
            }
        ]
    }
}

{
    "code": 401,
    "message": "Token tidak valid atau sesi berakhir."
}

{
    "code": 200,
    "status": "success",
    "meta": {
        "type": "topup",
        "periode": "month",
        "total_participants": 48,
        "generated_at": "2026-09-01T03:30:00.000Z"
    },
    "leaderboard": [
        {
            "rank": 1,
            "user_info": {
                "nama": "Riki Market",
                "id_user": "XP5k",
                "virtual_account": "888000000XP5k"
            },
            "stats": {
                "total_topup": 9302772,
                "total_topup_formatted": "Rp 9.302.772",
                "jumlah_transaksi": 254,
                "terakhir_topup": "2026-08-31T20:30:00.000Z"
            },
            "certificate": {
                "cert_id": "CERT-ZAKKI-202608-1-XP5k",
                "title": "Juara 1 - Top Saldo Bulanan",
                "rank": 1,
                "period": "Agustus 2026",
                "cert_url": "https://zpr0.com/cert/CERT-ZAKKI-202608-1-XP5k",
                "verify_url": "https://zpr0.com/certificate.html?id=CERT-ZAKKI-202608-1-XP5k"
            }
        }
    ]
}

{
    "code": 200,
    "status": "success",
    "meta": {
        "type": "referral",
        "total_participants": 15,
        "total_global_claims": 84,
        "total_global_reward": 1680000,
        "generated_at": "2026-09-01T03:30:00.000Z"
    },
    "leaderboard": [
        {
            "rank": 1,
            "user_info": {
                "id_user": "XP5k",
                "nama": "Riki Market",
                "virtual_account": "888000000XP5k"
            },
            "stats": {
                "total_referrals": 28,
                "total_reward": 560000,
                "total_reward_formatted": "Rp 560.000"
            }
        }
    ]
}

{
    "code": 200,
    "status": "success",
    "message": "🚀 BANK ZAKKI STORE - SYSTEM STATUS ENGINE (PUBLIC)",
    "data": {
        "statistik_mesin": {
            "total_pengguna": 317,
            "koneksi_aktif": 1,
            "jumlah_core": 4,
            "penggunaan_cpu": [
                "core1: 95.6%",
                "core2: 95.1%",
                "core3: 96.1%",
                "core4: 95.4%"
            ],
            "beban_rata_rata": [0, 0, 0],
            "waktu_aktif": "27 hari, 13 jam, 55 menit, 10 detik"
        },
        "ringkasan_finansial": {
            "total_volume_transaksi": 17404304,
            "total_saldo_beredar": 344025,
            "total_volume_h2h": 6686992,
            "total_transaksi_h2h": 303,
            "total_poin_reward": 350,
            "total_gacha_reward": 157850,
            "total_mining": 30,
            "total_mining_reward": 4200
        },
        "integritas_keamanan": {
            "injeksi_ilegal": 0,
            "kehilangan_data_terdeteksi": 0,
            "kesehatan_sistem": "🟢 OPTIMAL",
            "status_audit": "100% VERIFIED BY SYSTEM ENGINEERING CHECKER",
            "callback_engine": "READY",
            "telegram_bot": "ONLINE"
        },
        "topup_sukses": 1465
    },
    "server_time": "Sabtu, 15 Agustus 2026 pukul 02.12.00 WIB"
}

💡 Informasi Fleksibilitas URL:

Sistem mendukung URL callback yang fleksibel. Anda bisa menggunakan root domain, sub-folder, maupun endpoint spesifik.

• Contoh: https://toko.com atau https://toko.com/api/zakki-callback
• Penting: Jika URL Anda mengandung parameter (seperti ?key=abc), pastikan Anda melakukan URL Encoding pada isian parameter site agar tidak terjadi kesalahan parsing.

{
    "code": 200,
    "status": "success",
    "message": "Konfigurasi Callback berhasil disimpan.",
    "data": {
        "user": "Nama Pengguna",
        "callback_url": "https://your-site.com/api/callback",
        "test_status": "200 OK"
    }
}

{
    "code": 200,
    "status": "success",
    "message": "Callback berhasil dihapus. Anda tidak akan lagi menerima notifikasi otomatis."
}

{
    "code": 200,
    "status": "success",
    "message": "ID Telegram untuk notifikasi berhasil disimpan.",
    "data": { "telegram_id": "123456789" }
}

{
    "code": 400,
    "status": "error",
    "message": "ID Telegram 123456789 telah digunakan oleh member lain (Nama Member). Silakan gunakan akun Telegram Anda sendiri."
}

{
    "code": 200,
    "status": "success",
    "message": "Notifikasi bot Telegram dinonaktifkan."
}

{
    "code": 200,
    "status": "success",
    "message": "Statistik Gacha untuk zakkiXD",
    "data": {
        "sisa_poin": 0,
        "total_poin_digunakan": 45,
        "total_keuntungan": 8250,
        "total_transaksi_gacha": 45,
        "riwayat": [
            {
                "id_transfer": "Gacha-7C03F4D9",
                "amount": 100,
                "timestamp": "2026-06-24T15:54:57.823Z",
                "type": "terima",
                "from": {
                    "id_user": "SYSTEM",
                    "va": "0000000000",
                    "name": "SYSTEM GACHA REWARD"
                },
                "to": {
                    "id_user": "IBO6",
                    "va": "888000000IBO6",
                    "name": "zakkiXD"
                },
                "note": "Bagus! Kamu menang Rp 100.",
                "BotNotif": "Sukses"
            },
            {
                "id_transfer": "Gacha-F815DABA",
                "amount": 0,
                "timestamp": "2026-06-24T15:54:49.345Z",
                "type": "terima",
                "from": {
                    "id_user": "SYSTEM",
                    "va": "0000000000",
                    "name": "SYSTEM GACHA REWARD"
                },
                "to": {
                    "id_user": "IBO6",
                    "va": "888000000IBO6",
                    "name": "zakkiXD"
                },
                "note": "Zonk! Aduh, kurang beruntung. Ayo coba lagi!"
            }
        ]
    }
}

{
    "code": 200,
    "status": "success",
    "message": "Berhasil menabung saldo dari Aplikasi ke Bank Zakki.",
    "data": {
        "id_transaksi_app": "12345678",
        "jumlah_ditabung": 25000,
        "saldo_bank_baru": 175000
    }
}

{
    "code": 400,
    "status": "error",
    "message": "Saldo di aplikasi Zakki Store tidak cukup untuk menabung.",
    "zakki_response": {
        "code": 403,
        "status": "gagal - 403 Forbidden, pengurangan lebih besar dari jumlah saldo"
    }
}

{
    "code": 200,
    "status": "success",
    "message": "Berhasil menarik saldo dari Bank ke Aplikasi.",
    "data": {
        "id_transaksi_app": "87654321",
        "jumlah_ditarik": 10000,
        "sisa_saldo_bank": 165000,
        "saldo_aplikasi_baru": 510000
    }
}

{
    "code": 400,
    "status": "error",
    "message": "PIN yang Anda masukkan salah.",
    "zakki_response": {
        "code": 403,
        "status": "gagal - PIN salah"
    }
}

{
    "code": 200,
    "status": "success",
    "message": "Mutasi transaksi (all) berhasil diambil.",
    "data": {
        "id_user": "USER_123",
        "total_transaksi": 2,
        "mutasi": [
            {
                "id_transaksi": "87654321",
                "id_user": "USER_123",
                "type": "tarik",
                "amount": 10000,
                "timestamp": "2024-05-21T14:30:00.000Z",
                "status": "SUCCESS",
                "from_bank": "8880000USER_123",
                "to_app_identifier": "USER_123",
                "note": "Penarikan Saldo dari Bank Zakki (...)"
            },
            {
                "id_transaksi": "12345678",
                "id_user": "USER_123",
                "type": "tabung",
                "amount": 25000,
                "timestamp": "2024-05-21T13:00:00.000Z",
                "status": "SUCCESS",
                "from_app_identifier": "USER_123",
                "to_bank": "8880000USER_123",
                "note": "Tabungan dari Aplikasi ke Bank Zakki (...)"
            }
        ]
    }
}

{
    "code": 200,
    "status": "success",
    "message": "Transfer berhasil.",
    "data": {
        "id_transfer": "BankTF-a1b2c3d4",
        "rincian": {
            "id_transfer": "BankTF-a1b2c3d4",
            "amount": 5000,
            "timestamp": "2024-05-21T15:00:00.000Z",
            "from": {
                "id_user": "PENGIRIM_01",
                "va": "8880000PENGIRIM_01",
                "name": "Nama Pengirim"
            },
            "to": {
                "id_user": "USER_PENERIMA",
                "va": "8880000ID_USER",
                "name": "Nama Penerima"
            }
        },
        "sisa_saldo_pengirim": 160000
    }
}

{
    "code": 400,
    "message": "Saldo tidak mencukupi.",
    "sisa_saldo": 4000
}

{
    "code": 404,
    "message": "Nomor VA penerima tidak ditemukan."
}

⌨️ Command Bot

Contoh: .transfer 8880000001|5000

{
    "code": 200,
    "status": "success",
    "data": {
        "id_transfer": "BankTF-a1b2c3d4",
        "amount": 5000,
        "timestamp": "2024-05-21T15:00:00.000Z",
        "from": {
            "id_user": "PENGIRIM_01",
            "va": "8880000PENGIRIM_01",
            "name": "Nama Pengirim"
        },
        "to": {
            "id_user": "USER_PENERIMA",
            "va": "8880000ID_USER",
            "name": "Nama Penerima"
        },
        "type": "kirim"
    }
}

{
    "code": 404,
    "message": "ID Transfer tidak ditemukan."
}

{
    "code": 200,
    "status": "success",
    "message": "Riwayat transfer (all) berhasil diambil.",
    "data": {
        "id_user": "USER_PENERIMA",
        "total_transaksi": 1,
        "riwayat": [
            {
                "id_transfer": "BankTF-a1b2c3d4",
                "amount": 5000,
                "timestamp": "2026-08-15T15:00:00.000Z",
                "from": { "id_user": "USER_PENGIRIM", "nama": "Pengirim" },
                "to": { "id_user": "USER_PENERIMA", "nama": "Penerima" },
                "type": "terima"
            }
        ]
    }
}

{
    "code": 200,
    "status": "success",
    "data": {
        "virtual_account": "8880000IBO6",
        "account_holder": "zakkiXD"
    }
}

{
    "code": 404,
    "status": "error",
    "message": "Nomor rekening tidak ditemukan."
}

🎯 Dashboard Web Interaktif: Pengguna dapat mengelola celengan langsung melalui antarmuka web di https://zpr0.com/goals.html atau via bot Telegram (.goals, .nabung, .tarikgoal).

{
    "code": 200,
    "status": "success",
    "data": {
        "user": {
            "id_user": "IBO6",
            "nama": "zakkiXD",
            "virtual_account": "888000000IBO6",
            "balance": 500000
        },
        "summary": {
            "total_goals": 2,
            "total_saved": 1500000,
            "total_target": 5000000,
            "overall_percentage": 30
        },
        "goals": [
            {
                "id": "GOAL-A1B2C3",
                "id_user": "IBO6",
                "title": "Tabungan Laptop Kerja",
                "target_amount": 20000000,
                "current_amount": 15000000,
                "status": "LOCKED",
                "percentage": 75,
                "progress_bar": "[███████░░░] 75%",
                "remaining_needed": 5000000,
                "created_at": "2026-11-01T00:00:00.000Z"
            }
        ]
    }
}

{
    "code": 401,
    "status": "error",
    "message": "Autentikasi gagal. Parameter token wajib disertakan (?token=...)"
}

{
    "code": 201,
    "status": "success",
    "message": "Celengan target berhasil dibuat.",
    "data": {
        "id": "GOAL-E8F90A",
        "id_user": "IBO6",
        "title": "Beli Motor Matic",
        "target_amount": 18000000,
        "current_amount": 500000,
        "status": "LOCKED",
        "created_at": "2026-11-01T01:00:00.000Z"
    }
}

{
    "code": 200,
    "status": "success",
    "message": "Setoran berhasil disimpan ke celengan \"Beli Motor Matic\".",
    "data": {
        "goal": {
            "id": "GOAL-E8F90A",
            "title": "Beli Motor Matic",
            "target_amount": 18000000,
            "current_amount": 600000,
            "status": "LOCKED"
        },
        "actual_deposit": 100000,
        "excess_refund": 0,
        "is_achieved": false,
        "remaining_needed": 17400000
    }
}

{
    "code": 200,
    "status": "success",
    "message": "Dana celengan berhasil dicairkan ke Saldo Utama Bank Zakki.",
    "data": {
        "amount_claimed": 18000000,
        "goal": {
            "id": "GOAL-E8F90A",
            "title": "Beli Motor Matic",
            "status": "COMPLETED",
            "current_amount": 0
        }
    }
}

{
    "code": 200,
    "status": "success",
    "message": "Permohonan penarikan darurat berhasil diajukan dan sedang menunggu tinjauan admin.",
    "data": {
        "id": "GOAL-E8F90A",
        "title": "Beli Motor Matic",
        "status": "EMERGENCY_PENDING",
        "emergency_request": {
            "reason": "Kebutuhan perbaikan kendaraan mendesak untuk bekerja.",
            "requested_at": "2026-11-01T02:00:00.000Z"
        }
    }
}

{
    "code": 200,
    "status": "success",
    "message": "Nama celengan target berhasil diubah.",
    "data": {
        "id": "GOAL-E8F90A",
        "title": "Beli Motor Matic Honda Vario",
        "target_amount": 18000000,
        "current_amount": 600000
    }
}

{
    "code": 200,
    "status": "success",
    "message": "Celengan target berhasil dihapus.",
    "data": {
        "id": "GOAL-E8F90A",
        "title": "Beli Motor Matic Honda Vario"
    }
}

{
    "code": 400,
    "status": "error",
    "message": "Celengan \"Beli Motor Matic Honda Vario\" masih memiliki saldo tersimpan (Rp 600.000). Sesuai aturan keamanan dana, celengan tidak dapat dihapus selama masih ada saldo terkunci."
}

{
    "code": 200,
    "status": "success",
    "ip": "114.124.x.x",
    "security_status": "AMAN (NETRAL)"
}

{
    "code": 200,
    "status": "success",
    "ip": "1.1.1.1",
    "security_status": "WHITELIST"
}

Tindakan Keamanan Sistem:

• 🔴 Permanent Firewall Ban: Alamat IP yang terindikasi melakukan aktivitas berbahaya akan diblokir langsung di edge firewall Cloudflare.
• 📍 Security Telemetry: Setiap anomali dicatat dalam log keamanan (ASN, subnet IP, user agent, dan timestamp) untuk analisis integritas data.
• 📲 Automated Incident Alert: Laporan insiden keamanan otomatis dikirimkan ke kanal siaga developer untuk penanganan cepat.
• 🛡️ Active Rate Limiting: Seluruh rute dilindungi oleh pembatasan laju dinamis guna mencegah gangguan ketersediaan layanan.