Lewati ke konten utama

Rewards & Promos

Frog Cloud menyediakan fitur insentif berupa Kupon Diskon dan Kode Penebusan (Redeem Code). Dokumentasi ini berfokus pada bagaimana aplikasi pelanggan (melalui Frontend Dashboard atau Mobile App) memvalidasi kupon saat Topup saldo atau mengklaim hadiah dari Kode Penebusan.

1. Validasi Kupon Topup (Topup Coupon)​

Saat pelanggan berada di halaman pengisian saldo (Topup), sistem memungkinkan mereka memasukkan kode promo. Sebelum melanjutkan ke portal pembayaran (Payment Gateway), Frontend wajib memvalidasi kupon tersebut ke Backend untuk mendeteksi apakah kode sah dan mengetahui besaran diskon/bonus yang didapatkan.

Request
POST /api/customer/reward/topup-coupon/check
Content-Type: application/json
Request Body
{
  "code": "MERDEKA45",
  "topup_amount": 500000
}

Respons (200 OK): Akan mereturn informasi validitas kupon, tipe diskon (nominal atau persentase), dan kalkulasi jumlah potongan akhir jika syarat dan ketentuan terpenuhi.

2. Mengklaim Kode Penebusan (Redeem Code)​

Berbeda dengan kupon diskon, Kode Penebusan berfungsi layaknya voucer hadiah mandiri. Pelanggan memasukkan kode rahasia ini di menu Reward, dan apabila valid, saldo dompet mereka akan langsung bertambah seketika tanpa harus melakukan Checkout.

Request
POST /api/customer/reward/redeem-code/claim
Content-Type: application/json
Request Body
{
  "code": "GIFT-100K-FROG"
}

Kondisi dan Tanggapan:

  • Sukses (200 OK): Saldo berhasil ditambahkan secara otomatis ke akun pengguna berdasarkan konfigurasi nilai tukar voucer tersebut.
  • Error (400 / 404): Kode akan ditolak jika status kode sudah kedaluwarsa, kuota telah habis, atau Customer sudah pernah mengklaim kode yang sama sebelumnya (untuk mencegah eksploitasi ganda).

3. Cek Kelayakan Sistem Reward (Eligibility)​

Sistem Frog Cloud memiliki beberapa hadiah otomatis yang tertanam di backend (seperti Hadiah Pengguna Baru setelah Verifikasi KYC, atau Insentif Referral). Frontend dapat menggunakan API ini untuk mengecek apakah Customer layak (eligible) menerima hadiah tersebut sebelum menampilkan spanduk (banner) tawaran di layar utama.

Request
GET /api/customer/reward/eligible/{system_code}

(Catatan: Parameter jalur {system_code} merupakan konstanta Event ID yang disepakati oleh tim Go, misalnya REGISTRATION_BONUS atau FIRST_TOPUP).