Faktur dan buku besar

Lokasi di admin: Finance › Billing (/billing) dengan tab Overview, Transactions (/billing/ledger), Invoices (/billing/invoices), Top-ups (/billing/deposits), Payouts (/billing/payouts), Vouchers (/billing/vouchers), dan Reports (/billing/reports). Lokasi di portal: Billing (/billing).

Fungsi

Setiap nominal di NexCMP disimpan sebagai sen USD dan dicatat satu kali. Konsep utamanya: wallet ledger adalah acuan utama untuk saldo; invoice, pembayaran top-up, dan laporan merupakan tampilan yang dibangun darinya. Ledger ini bersifat append-only — kesalahan diperbaiki dengan menambahkan entri pembalik, bukan dengan mengedit riwayat.

Persyaratan

Item	Persyaratan
Role	Seorang administrator.
Detail penjual	Atur nama resmi, ID pajak, alamat, email kontak, dan prefiks nomor invoice di System › Settings › General, tab Seller & invoicing (/settings?tab=seller), kartu Seller details (printed on invoices).
Dependensi	Payment channels untuk dana masuk.

Komponen

Tab admin	Yang dicantumkan	Penggunaan tipikal
Overview	Pendapatan hari ini dan bulan ini, total buku besar berdasarkan jenis (deposit, biaya, pengembalian dana, penyesuaian, voucher), faktur berdasarkan status, pengembalian dana tertunda, pintasan, pengeluaran per layanan dalam 30 hari terakhir	Pemeriksaan harian
Transactions	Buku besar dompet, satu baris per mutasi	Menjelaskan saldo pelanggan
Invoices	Faktur, dan tampilan kedua Orders yang memuat setiap pembelian dari setiap layanan	Mencari dokumen, mengirim ulang, menandai lunas
Top-ups	Pembayaran yang diterima melalui gateway	Memeriksa pembayaran, mengembalikan dana
Payouts	Pengembalian dana kartu, pembayaran afiliasi, penarikan reseller	Menyetujui pengeluaran uang
Vouchers	Kode top-up	Lihat Promotions
Reports	Pendapatan, berdasarkan layanan, berdasarkan reseller	Akuntansi

Transactions (buku besar)

Kolom: waktu, pelanggan, jenis, layanan, jumlah (bertanda), VM, referensi, aktor, catatan. Filter: jenis, layanan, ID pelanggan, situs (jika Anda memiliki reseller), rentang tanggal, dan tautan VM.

Jenis	Arti
deposit	Top-up dari gateway
charge	Uang yang diambil untuk layanan (pesanan, pembaruan, penggunaan per jam ...)
refund	Uang yang dikembalikan ke dompet
adjust	Kredit atau debit administrator, serta kode top-up (referensi dimulai dengan vch:) — ikhtisar menampilkan voucher sebagai baris tersendiri

Setiap baris memiliki referensi seperti dep:stripe:<payment-id>; referensi yang sama tidak pernah dapat ditulis dua kali, itulah sebabnya webhook yang berulang tidak dapat memberikan kredit dua kali. Gunakan Customers › List › customer › Credit / debit untuk menambahkan penyesuaian manual: alasan wajib diisi, jumlah positif juga berupaya membuka kunci VM yang dikunci karena kurangnya dana, dan tindakan dikonfirmasi dalam dua langkah.

Invoices

Faktur dibuat secara otomatis saat pelanggan membeli atau memperbarui sesuatu yang dibayar dari dompet, atau untuk top-up. Format nomor tampak seperti <prefix><YYYYMM>-<000001> (misalnya NX202610-000042); situs reseller menggunakan awalan dan urutannya sendiri. Nomor yang ada tidak pernah berubah saat Anda mengubah awalan.

Kolom	Nilai
Jenis	Receipt, Renewal, Top-up, Manual, Refund
Status	Unpaid, Paid, Overdue, Cancelled, Refunded

Tindakan pada baris:

Action	Efek
View / Print	Membuka faktur; portal juga dapat mencetak atau menyimpan sebagai PDF.
Mark paid (hanya untuk belum dibayar atau lewat waktu)	Menandainya sebagai lunas tanpa memindahkan uang dompet — gunakan saat pelanggan membayar Anda di luar NexCMP. Alasan wajib diisi. Untuk faktur pembaruan, ini juga memperpanjang dan membuka kunci VM yang dikunci.
Cancel (hanya untuk belum dibayar atau lewat waktu)	Membatalkan faktur. Alasan wajib diisi.
Resend	Mengirim ulang faktur melalui email.

Create manual invoice (tombol di bagian atas tab): ID pelanggan, 1 hingga 50 baris (deskripsi, jumlah, harga satuan), ID VM opsional, tenggat hari opsional (0 hingga 365, default 7), catatan opsional. Dibuat dengan status unpaid; pelanggan dapat melihatnya di Billing › Invoice History.

Invoice layanan yang belum dibayar akan dilunasi secara otomatis dari wallet begitu dana tersedia, sehingga tindakan pelanggan cukup melakukan top-up.

Top-up (pembayaran)

Satu baris per percobaan: waktu, pelanggan, gateway dan metode, jenis (top-up atau auto top-up), status (pending, completed, failed, refunded, disputed, canceled), jumlah yang dibayar pelanggan, fee, jumlah yang masuk ke wallet, referensi gateway, dan waktu penyelesaian. Pembayaran Stripe dan PayPal yang berstatus completed memiliki tindakan Refund. Gunakan halaman Gateway events untuk melihat webhook (Payment channels).

Payouts

Tiga sub-tab: Card refunds (setujui atau tolak permintaan refund; permintaan dibuat dari pembayaran yang telah selesai), Affiliate payouts (penarikan komisi), dan Reseller withdrawals. Setiap keputusan diaudit.

Reports

Revenue (tren 30 hari, bulan ke bulan, pelanggan teratas), By service, dan By reseller.

Tampilan pelanggan

Di Billing pelanggan memiliki Balance, Deposit, Redeem code, Settings (auto top-up), dan riwayat dengan tab Invoice History, Payment Order, Ledger, serta Orders (semua layanan dalam satu daftar dengan filter berdasarkan layanan dan tipe). Setiap invoice memiliki View, Print, dan Save as PDF; nominal dalam USD, secara opsional ditampilkan dalam mata uang tampilan.

Verifikasi

1. Lakukan top-up kecil sebagai pelanggan uji coba.
2. Transactions menampilkan baris deposit, Top-ups menampilkan pembayaran sebagai Completed, dan revenue Overview bertambah.
3. Beli sesuatu: baris charge muncul, dan Invoices menampilkan invoice Receipt atau Renewal dengan detail penjual yang telah Anda konfigurasikan.

Batas & catatan

• Append-only. Tidak ada cara untuk mengedit atau menghapus baris ledger; tambahkan penyesuaian beserta alasannya.
• Mata uang. Nominal dalam USD; mata uang tampilan bersifat kosmetik (lihat Mata uang dan nilai tukar).
• Refund to card memerlukan dua langkah (permintaan, lalu persetujuan di bawah Payouts); USDT dan transfer bank tidak dikembalikan ke sumber asal.
• Semua hal diaudit di bawah System › Logs › Admin actions beserta alasan yang Anda masukkan.
• Orders vs invoices. Penggunaan per jam tidak ditagih per jam; tampilan Orders mengelompokkannya per hari agar Anda tetap dapat melihatnya.

Pemecahan Masalah

Gejala	Penyebab	Solusi
Saldo pelanggan tampak keliru	Biaya, adjustment, atau voucher yang tidak Anda duga	Filter Transactions berdasarkan ID pelanggan lalu periksa referensi dan catatannya.
"Tagihan sudah dibayar" (409)	Tandai dibayar pada tagihan yang sudah dibayar	Tidak ada yang perlu dilakukan.
Tidak dapat membatalkan tagihan	Hanya tagihan yang belum dibayar atau sudah jatuh tempo yang dapat dibatalkan	Untuk tagihan yang sudah dibayar, gunakan pengembalian dana atau penyesuaian.
Detail penjual tidak ada pada tagihan	Belum diisi	Lengkapi Seller details di System › Settings › General › Seller & invoicing.
Kartu kredit / debit ditolak	Jumlah bernilai nol atau lebih dari $100,000	Gunakan jumlah antara 1 sen dan $100,000.
Pembayaran menampilkan status Pending untuk waktu yang lama	Webhook tidak ada	Lihat Gateway events dan lakukan pemutaran ulang (replay).