Lewati ke konten utama

Reward & Promo Management

Untuk meningkatkan loyalitas Customer dan mendukung strategi marketing, Frog Cloud menyediakan dua instrumen insentif finansial: Topup Coupons (Kupon Diskon Isi Ulang) dan Redeem Codes (Kode Voucher Penebusan Saldo/Diskon).

Admin (khususnya Admin Billing atau Sales) memiliki wewenang penuh untuk merancang program promo, membatasi kuota penggunaan, hingga membatalkan kode yang dianggap bermasalah.

Memahami Perbedaan Inti​

Sebelum membangun antarmuka Dashboard Promo, penting bagi tim Frontend untuk membedakan dua entitas ini:

  1. Topup Coupon: Digunakan oleh pelanggan pada saat proses pembayaran/topup saldo. Kupon ini memotong tagihan invoice atau memberikan saldo tambahan secara otomatis saat transaksi kas masuk terjadi.
  2. Redeem Code: Merupakan "voucher" mandiri yang bisa langsung ditukar/diklaim oleh pelanggan di dalam Dashboard mereka (tanpa perlu melakukan pembayaran). Biasanya digunakan untuk memberikan kompensasi (SLA Breach) atau Giveaway.

Diagram Perbandingan​

1. Manajemen Topup Coupons (Kupon Saldo)​

Admin dapat melihat, membuat, dan membatalkan kupon yang akan diedarkan ke publik.

1A. Melihat Daftar Kupon​

Digunakan untuk merender tabel manajemen kupon.

Request
GET /api/backoffice/reward/topup-coupon

Untuk melihat rincian spesifik sebuah kupon, panggil GET /api/backoffice/reward/topup-coupon/{id}/details.

1B. Membuat Kupon Baru​

Ketika peluncuran campaign baru (misal: "Diskon Kemerdekaan"), Admin mengisi formulir untuk menciptakan kupon massal.

Request
POST /api/backoffice/reward/topup-coupon/create
Content-Type: application/json
Request Body
{
  "code": "MERDEKA45",
  "discount_percentage": 15,
  "max_discount_amount": 100000,
  "quota": 500,
  "valid_until": "2026-08-31T23:59:59Z"
}

1C. Merubah atau Menghapus Kupon​

Jika ada kesalahan input atau promosi dihentikan lebih awal:

  • Update: PUT /api/backoffice/reward/topup-coupon/{id}/update
  • Delete: DELETE /api/backoffice/reward/topup-coupon/delete/{id}

2. Manajemen Redeem Codes (Kode Penebusan)​

Redeem codes sangat rentan terhadap penyalahgunaan karena dapat langsung disuntikkan menjadi saldo riil ke dalam dompet Customer. Oleh karena itu, pengelolaannya diawasi secara ketat lewat Logs penukaran.

2A. Melihat Daftar & Membuat Redeem Code Baru​

Request (Get All)
GET /api/backoffice/reward/redeem-code
Request (Create Baru)
POST /api/backoffice/reward/redeem-code/create
Content-Type: application/json
Request Body
{
  "code": "GIFT-100K-FROG",
  "reward_amount": 100000,
  "quota": 50,
  "valid_from": "2026-06-01T00:00:00Z",
  "valid_until": "2026-06-30T23:59:59Z"
}

2B. Mengubah dan Menghapus Redeem Code​

Jika terdapat kesalahan input kuota atau promo dibatalkan, Admin dapat mengubah atau menghapus Redeem Code induk:

  • Ubah Redeem Code: PUT /api/backoffice/reward/redeem-code/{id}/update
  • Hapus Redeem Code: DELETE /api/backoffice/reward/redeem-code/delete/{id}

2C. Melacak Riwayat Penggunaan (Log Penebusan)​

Admin berhak untuk melihat siapa saja Customer yang telah menukarkan sebuah Redeem Code. Fitur ini meminimalisir penipuan.

Data riwayat penukaran ini biasanya dirender menjadi sub-tabel di dalam halaman Detail Redeem Code (GET /.../redeem-code/{id}/details).

Apabila ditemukan penukaran yang mencurigakan (misalnya oleh bot atau akun fraud), Admin dapat memodifikasi atau mencabut riwayat penukaran tersebut melalui:

  • Ubah Status Penukaran: PUT /api/backoffice/reward/redeem-code/code/{log_id}/update
  • Cabut Riwayat Penukaran: DELETE /api/backoffice/reward/redeem-code/code/delete/{log_id}

3. Konfigurasi Sistem Reward Global​

Selain kupon dan kode voucher spesifik, sistem Frog Cloud memiliki pengaturan Reward bawaan sistem (seperti hadiah saldo otomatis saat pendaftaran pengguna baru atau insentif referral).

Admin tingkat tinggi dapat melihat dan mengatur limit parameter bawaan sistem ini.

Request (Lihat Pengaturan)
GET /api/backoffice/setting/reward/rewards
Request (Ubah Pengaturan)
PATCH /api/backoffice/setting/reward/{id}/update
Content-Type: application/json