Dokumentasi

Keperluan

Perkara	Keperluan
PHP	8.4 atau lebih baharu (diuji pada 8.4 dan 8.5)
Pangkalan data	MySQL 8 atau MariaDB 10.11+
Sambungan PHP	pdo_mysql, mbstring, openssl, curl, json, fileinfo, zip, ctype, tokenizer, xml, dom, bcmath, sodium
Cron	Satu tugas setiap 5 minit, atau cron melalui HTTP
Redis, proses latar	Tidak diperlukan. Queue, cache dan sesi menggunakan pangkalan data
Hosting	Shared hosting (cPanel, DirectAdmin) atau VPS
HTTPS	Sangat disarankan. API admin hanya menjawab melalui HTTPS dalam produksi
Internet keluar	Diperlukan untuk gateway, registrar, panel hosting dan semakan lesen

BillingEvo tidak memerlukan sambungan intl atau fungsi proc_open. Ia menggunakan cara sandaran jika tiada.

Pemasangan

1. Beli pelan. Anda menerima pakej BillingEvo dan kunci lesen.
2. Di panel hosting anda, cipta pangkalan data dan subdomain, contohnya billing.syarikatanda.com, dengan HTTPS diaktifkan.
3. Muat naik fail, tetapkan alamat laman dan butiran pangkalan data, dan cipta akaun superadmin pertama. Pakej disertakan dengan arahan pemasangan langkah demi langkah.
4. Tetapkan cron (lihat di bawah).
5. Log masuk dan buka Sistem > Health untuk mengesahkan sambungan PHP, folder boleh tulis dan ruang cakera dalam keadaan baik.

Installer web berpandu yang menjalankan langkah ini dalam pelayar akan datang.

Cron

Automasi BillingEvo (invois, peringatan, penggantungan, sync domain, backup) dijalankan oleh satu tugas cron setiap 5 minit. Arahan tepat untuk pelayan anda ada dalam arahan pemasangan.

Jika hos anda tidak membenarkan crontab, anda boleh memanggil cron melalui HTTP. Cron HTTP mati secara lalai. Apabila dihidupkan, ia dilindungi dengan kunci rahsia dan senarai IP dibenarkan.

Sistem > Status automasi menunjukkan sama ada setiap tugas berjalan, dengan lencana OK, Amaran atau Ralat dan trend 7 hari. Emel ringkasan dihantar setiap hari.

Aktifkan lesen

Buka Sistem > Lesen dan masukkan kunci lesen anda. BillingEvo kemudian menyemak lesen sekali sehari. Setiap semakan hanya menghantar kunci lesen, domain, ID pemasangan dan versi.

• Jika pelayan tidak dapat mencapai internet, muat naik fail lesen.
• Selepas anda menaik taraf pelan, modul baharu dibuka pada semakan seterusnya.
• Jika pelayan lesen tidak dapat dihubungi buat sementara, BillingEvo terus berjalan dalam tempoh tangguh, dan superadmin melihat baki hari.

Sediakan perniagaan anda

Dalam Setup, lengkapkan tetapan sistem:

• butiran syarikat, logo dan warna aksen untuk mod cerah dan gelap;
• format nombor invois dan yuran lewat;
• peraturan cukai ikut negara dan negeri, dengan label cukai anda sendiri;
• mata wang dan kadar tukaran harian;
• emel: pelayan SMTP utama dan SMTP sandaran pilihan yang mengambil alih bila SMTP utama gagal. Hantar ujian sebelum menyimpan.

Templat emel (60 terbina) dan setiap teks yang dilihat pelanggan boleh diubah dalam editor templat dan Translation Editor.

Gateway pembayaran

BillingEvo menyokong Stripe, BayarCash dan CHIP, serta pindahan bank dengan muat naik bukti bayaran. Anda memerlukan akaun merchant sendiri dengan setiap penyedia.

• Stripe memaparkan kaedah bayaran yang Stripe aktifkan untuk akaun dan negara anda.
• BayarCash menggunakan FPX secara lalai, serta DuitNow, DuitNow QR dan kad jika diaktifkan pada akaun BayarCash anda.
• CHIP memaparkan FPX, kad dan e-dompet di halaman bayaran CHIP.
• Pindahan bank: pelanggan memuat naik bukti bayaran, dan staf menyemaknya sebelum invois ditanda dibayar.

Log gateway diredaksi dan disimpan 90 hari. Pelanggan juga boleh membayar satu invois tanpa log masuk, melalui pautan QuickPay dalam emel mereka.

Server hosting

Provisioning automatik berfungsi dengan DirectAdmin. Tambah setiap server dengan butiran log masuknya dan jalankan ujian sambungan. Anda kemudian boleh:

• mengumpulkan server supaya setiap akaun baharu masuk ke server yang paling sedikit akaun;
• memilih bagi setiap produk bila akaun dicipta: semasa order, selepas bayaran pertama, selepas kelulusan staf, atau tidak automatik;
• memantau port, beban dan uptime server.

Produk yang bukan hosting DirectAdmin, seperti VPS atau servis terurus, boleh ditetapkan untuk menunggu kelulusan staf, supaya pasukan anda menyediakannya secara manual sementara BillingEvo menguruskan invois dan pembaharuan.

Domain dan registrar

Aktifkan modul registrar yang anda gunakan: ResellBiz, Spaceship, Namecheap, NameSilo atau Cloudflare. Untuk TLD tanpa API, pemacu Manual menjejak tarikh luput dan menukar setiap tindakan kepada tugasan staf.

Tetapkan harga anda sendiri bagi setiap TLD, untuk pendaftaran, pemindahan dan pembaharuan 1 hingga 10 tahun, dengan harga khas bagi kumpulan klien jika perlu.

Notifikasi WhatsApp

Sambungkan MacroWA Pro atau WAHA dengan akaun anda sendiri. Anda kemudian boleh menghantar invois baharu, pengesahan bayaran, peringatan, notis hosting sedia, balasan tiket dan followup melalui WhatsApp. Kod log masuk dan pautan kata laluan tidak pernah dihantar melalui WhatsApp, dan pelanggan boleh berhenti menerimanya.

Backup dan storan fail

Tetapkan backup harian ke SFTP, FTP, Dropbox atau Google Drive (melalui aplikasi OAuth anda sendiri), dengan penyulitan AES-256 pilihan. Anda menerima emel jika backup gagal.

Lampiran tiket, fail klien dan muat turun produk boleh disimpan di pelayan itu sendiri, atau di FTP, SFTP atau Google Drive.

Pindah dari WHMCS atau ClientExec

Buka Sistem > Import data. Anda memerlukan sambungan ke pangkalan data lama atau dump SQL daripadanya. Untuk kata laluan servis dan server WHMCS, anda juga memerlukan kunci penyulitan WHMCS anda.

1. Sambung ke sumber, atau muat naik dump.
2. Semak hasil semakan: sistem sumber, versi, dan apa-apa yang menghalang import.
3. Jalankan larian percubaan dan betulkan isu yang dilaporkan.
4. Jalankan import sebenar. Baris bermasalah direkod dan dilangkau.
5. Bandingkan laporan semakan baki dengan sistem lama anda.
6. Hantar emel set semula kata laluan jika perlu, kemudian hidupkan semula automasi.

Pangkalan data lama hanya dibaca. Semasa import berjalan, automasi billing, domain dan hosting dihentikan, jadi tiada apa-apa dihantar untuk data yang diimport.

API

API admin berada di /api/v1 dan mati secara lalai. Hidupkannya dalam tetapan API, kemudian cipta kelayakan untuk seorang staf. Rahsia dipaparkan sekali sahaja dan disimpan sebagai hash. Anda boleh mewajibkan tandatangan HMAC, mengehadkan kelayakan kepada peranan API dan alamat IP, dan menggunakan kunci idempotensi.

API kedai baca sahaja di /api/v1/store memberi laman web anda katalog, harga, harga TLD dan ketersediaan domain. Ia juga mati secara lalai.

Dokumen OpenAPI dan panduan pembangun, dengan contoh curl, PHP, JavaScript dan Python, ada dalam admin.

Kemas kini

Versi baharu disediakan sebagai pakej keluaran dengan arahan naik taraf sepanjang tempoh sokongan dan kemas kini anda aktif. Nota keluaran ada dalam changelog. Kemas kini sekali klik dari dalam admin akan datang.

Mendapatkan bantuan

Sepanjang tempoh sokongan anda, hubungi kami dengan kunci lesen, versi BillingEvo dan penerangan masalah anda.