---
title: Promosi
description: Terbitkan kode isi ulang: bonus dompet, kredit khusus layanan, dan diskon persentase dengan batasan serta pesanan minimum — buat, distribusikan, dan lacak.
url: https://nexcmp.com/id/docs/billing/promotions/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Promosi {#promotions}

> **Di mana letaknya di admin:** Finance › Billing › Vouchers (`/billing/vouchers`). **Di mana letaknya di portal:** Billing › Redeem code (juga di dalam laci Deposit).

## Fungsi {#what-it-does}

**Kode isi ulang** (voucher) adalah rahasia sekali pakai yang Anda berikan kepada pelanggan. Bergantung pada cara Anda membuatnya, kode ini dapat:

| Jenis | Yang didapat pelanggan | Kemana nilai tersebut masuk |
|---|---|---|
| **Bonus credit** untuk semua layanan | Uang ditambahkan ke dompet | Saldo dompet. Dapat digunakan untuk apa saja. |
| **Bonus credit** untuk layanan pilihan | Kredit layanan | Kantong terpisah yang hanya dapat membayar layanan tersebut. |
| **Discount %** | Potongan persentase dari pesanan pertama layanan pilihan | Tidak ada kredit yang dikreditkan; diskon diterapkan saat pembayaran. |

Gunakan untuk kampanye, kredit permohonan maaf, penawaran mitra, atau diskon pesanan pertama.

## Persyaratan {#requirements}

| Item | Persyaratan |
|---|---|
| Role | Seorang administrator. |
| Pelanggan | Pelanggan menukarkan kode saat masuk ke portal (bukan sebagai tamu). Secara default, pelanggan harus memiliki email yang terverifikasi. |
| Kode VND | Kode yang dibuat dalam VND dikonversi ke USD saat penukaran menggunakan nilai tukar yang disimpan (lihat [Currency and exchange rates](https://nexcmp.com/id/docs/catalog/currency-and-exchange-rates/)). |

## Membuat batch {#create-a-batch}

1. Buka **Finance › Billing › Vouchers** dan klik **Create vouchers**.
2. Isi formulir. Contoh nilai berada di dalam kurung siku.

   | Kolom | Catatan |
   |---|---|
   | Nama batch | 1–80 karakter (`Spring welcome`). |
   | Target | **Main site clients**, **Single reseller's customers** (memerlukan daftar pelanggan) atau **Reseller wallet**. |
   | Pengguna yang memenuhi syarat | **All in target audience** atau **Specified** — satu email atau ID pelanggan per baris, hingga 1,000. Untuk pelanggan reseller harus *Specified*. |
   | 1 kode per target | Dengan *Specified*, membuat satu kode per pelanggan yang terdaftar. |
   | Jenis kode | **Bonus credit** atau **Discount %**. |
   | Berlaku untuk | Pilih satu atau beberapa layanan; kosong = **All services**. |
   | Mata uang, Nilai nominal | USD mulai dari $1.00, atau VND mulai dari 10,000 dalam kelipatan 1,000 (hanya kredit bonus). |
   | Diskon (%) | 1 hingga 100 (khusus Diskon %). |
   | Batas diskon maksimum (USD) | Diperlukan untuk Diskon %, mulai dari $1.00. Ini juga merupakan jumlah maksimum yang dapat Anda kurangi per penukaran. |
   | Pesanan minimum (USD) | `0` = tidak ada. Pesanan pertama harus minimal sebesar jumlah ini. |
   | Jumlah kode | 1 hingga 1,000 kode acak. |
   | Penggunaan per kode | 1 hingga 100,000. `1` berarti satu orang per kode; tingkatkan untuk kode bersama. |
   | Maks. penggunaan per akun | Minimal 1. Untuk % Diskon harus `1`. |
   | Waktu mulai (opsional), Kedaluwarsa | Masa kedaluwarsa harus setelah hari ini dan setelah waktu mulai, maksimal 2 tahun ke depan. |
   | Prefiks kode (0–6 kar) | Hanya huruf; kosong berarti menggunakan prefiks situs. |
   | Kode kustom (hanya jika jumlah = 1) | 6 hingga 32 karakter A–Z dan 0–9. Mudah dibagikan tetapi mudah ditebak: batasi penggunaannya. |
   | Wajibkan email terverifikasi | Aktif secara default. |
   | Catatan internal, Alasan | Alasan wajib diisi dan dicatat dalam log audit. |

3. Formulir menampilkan **Maksimum eksposur** (nilai nominal x kode x penggunaan) sehingga Anda tahu risiko terburuknya. Klik **Generate codes**.
4. **Salin kode sekarang.** Kode hanya ditampilkan sekali: NexCMP hanya menyimpan hash dan 4 karakter terakhir. Gunakan **Copy all** atau **Download CSV**, centang konfirmasi, lalu tutup kotak.



## Cara kerja setiap jenis {#how-each-type-behaves}

### Bonus dompet (tidak ada layanan yang dipilih) {#wallet-bonus-no-service-selected}

Dompet akan dikreditkan dengan entri **penyesuaian** (referensi `vch:...`). Tidak dapat dikembalikan ke kartu, tidak menghasilkan komisi afiliasi, tidak membuat faktur, dan dihitung sebagai saldo dompet untuk kuota. Kode VND menggunakan kurs pada saat penukaran.

### Kredit layanan (layanan dipilih) {#service-credit-services-selected}

- Kredit tersimpan di **kantong terpisah**, hanya dapat membayar tagihan layanan yang dipilih (pesanan baru, perpanjangan, biaya per jam atau harian, peningkatan) dan digunakan **sebelum** dompet.
- Tidak dapat ditarik, ditransfer, atau diuangkan, serta kedaluwarsa bersama kodenya.
- Buku besar menunjukkan total tagihan ditambah baris kredit yang sesuai, sehingga pendapatan per layanan tetap akurat sementara dompet hanya berkurang sebesar yang benar-benar dibayar oleh pelanggan.
- Ini **tidak** menaikkan tingkat [quota](https://nexcmp.com/id/docs/billing/quotas/) dan diabaikan oleh [auto top-up](https://nexcmp.com/id/docs/billing/auto-top-up/).
- Jika tagihan yang dibayar dengan kredit atau diskon dikembalikan, bagian yang dibayar oleh kode akan diambil kembali dari pengembalian dana dompet dan dikembalikan ke kantong kredit.

### % Diskon {#discount}

1. Pelanggan memasukkan kode: kode tersebut menjadi **aktif**. Kode persentase hanya dapat digunakan sekali per akun.
2. **Tagihan pertama** dari layanan terpilih yang bukan merupakan biaya per jam, dan setidaknya mencapai **Minimum order**, didiskon berdasarkan persentase, tidak pernah melebihi **Maximum discount cap**.
3. Diskon dihitung ulang oleh server pada saat penagihan; jumlah di peramban diabaikan. Baris penukaran dicatat saat kode benar-benar digunakan, beserta diskon aktualnya.
4. Biaya penggunaan per jam tidak pernah menggunakan kode.

## Tindakan pelanggan {#what-the-customer-does}

1. Buka **Billing** di portal lalu klik **Redeem code**, atau gunakan **Have a top-up code?** di laci Deposit.
2. Ketik kode (tidak sensitif huruf besar-kecil; tanda hubung opsional) dan klik **Check**. Portal akan menampilkan informasi benefitnya, misalnya *Valid code: +$5.00*, *$5.00 credit for VPN* atau *20% off voucher for Virtual Machines (up to $5.00)*, dan *Valid for orders from $10.00*.
3. Klik **Redeem** dan konfirmasi. Setiap kode dapat digunakan sekali per akun.

Kode terikat pada situs: kode dari satu situs "tidak valid" di situs lain, tanpa petunjuk apa pun bahwa kode tersebut ada di tempat lain. Tebakan yang salah akan dibatasi dan, setelah beberapa kali percobaan, akun akan dikunci selama beberapa menit ("N attempts left before a temporary lock").

## Lacak dan hentikan {#track-and-stop}

- **Batches** mencantumkan setiap batch beserta statusnya (*active*, *disabled*, *expired*, *used up*), jumlah penukaran, dan eksposur. Buka batch untuk melihat tab **Codes** (disamarkan) dan **Redemptions**, serta **Export CSV**.
- **Redemptions** mencantumkan setiap penukaran di semua batch; **Reseller quotas** menunjukkan seberapa banyak batas penerbitan bulanan setiap reseller yang telah digunakan; **Settings** mengaktifkan atau menonaktifkan kode reseller dan menetapkan batas bulanan default.
- **Disable batch** menghentikan semua kode yang belum digunakan; penukaran yang sudah dilakukan tetap berlaku. Satu kode tunggal juga dapat dinonaktifkan.

## Verifikasi {#verify}

1. Buat batch berisi 1 kode: Discount % 20, batasan (cap) $5, pesanan minimum $10, layanan Virtual Machines.
2. Sebagai pelanggan uji coba, tukarkan kode tersebut. Portal menyatakan kode berhasil diaktifkan.
3. Pesan VM yang berharga setidaknya $10 (siklus bulanan): tagihan menunjukkan diskon (maksimal $5).
4. Di dalam batch, kode tersebut menunjukkan 1 kali penukaran dengan diskon riil.

## Batas & catatan {#limits-notes}

- Kode terikat pada **audience** dan **site** saat pembuatan; kode tidak dapat dipindahkan setelahnya.
- Reseller dapat menerbitkan kode untuk pelanggan mereka sendiri dalam batas eksposur bulanan; lihat [Resellers](https://nexcmp.com/id/docs/customers/resellers/).
- Slide promo sidebar untuk pelanggan (**Marketing › Promo slides**) adalah fitur terpisah dan tidak memberikan diskon apa pun.
- Karena kode dalam teks biasa tidak pernah disimpan, batch yang hilang tidak dapat dipulihkan: nonaktifkan dan buat yang baru.

## Pemecahan Masalah {#troubleshooting}

| Gejala | Penyebab | Solusi |
|---|---|---|
| "Kode persen: satu penggunaan per akun" (`percent_one_per_account`) | Batas penggunaan maksimum per akaun di atas 1 untuk Discount % | Atur ke `1`. |
| Formulir menyatakan bahwa batasan (cap) wajib diisi | Discount % tanpa Maximum discount cap | Masukkan setidaknya $1.00. |
| Pelanggan tidak ditemukan | Email atau ID dalam daftar tidak ada | Perbaiki daftar tersebut (pesan error menyebutkan entri yang tidak dikenal). |
| Pelanggan mengatakan "kode tidak valid" | Salah situs, kedaluwarsa, dinonaktifkan, habis, bukan pelanggan target, atau email belum diverifikasi | Periksa batch dan pelanggan tersebut. |
| Kredit tidak digunakan | Biaya tersebut milik layanan lain | Kredit hanya membayar layanan yang dipilih pada batch. |
| Diskon tidak diterapkan | Pesanan di bawah minimum, biaya per jam, atau kode diaktifkan untuk layanan lain | Buat pesanan pertama yang memenuhi syarat. |
| Pelanggan terkunci dari penukaran | Terlalu banyak percobaan yang salah | Tunggu hingga penguncian berakhir. |