API Tambah Stempel

API Tambah Stempel menambahkan satu stempel ke data stempel yang sudah ada.

Ketika pengguna menyelesaikan pembelian, kunjungan, atau aksi tertentu, API ini secara otomatis menambahkan satu stempel.
Jika jumlah maksimum pada kartu telah tercapai, stempel tidak akan ditambahkan lagi.

API ini tersedia mulai dari paket Personal ke atas.

PUT

/api/stamp/v1/add 

{
    "stampIdx": 394
}

Request Parameters

stampIdx integer required
Stamp IDX. 
{
    "code": 0,
    "message": "",
    "result": null
}

Response Parameters

code integer
Kode respons: 0 = Berhasil, nilai lainnya = Error
message string
Pesan respons. Jika kode bukan 0, pesan error akan dikembalikan.
result null

Mengapa API ini inti sistem

Jika API Create menerbitkan kartu, API Add mencatat aksi nyata pengguna.

Setiap pembelian atau kunjungan akan dicatat, memungkinkan sistem reward berbasis perilaku tanpa sistem poin tambahan.

Satu panggilan API dapat langsung menghubungkan aksi seperti pembayaran, pembelian, atau partisipasi ke akumulasi stempel.

Penanganan saat maksimum tercapai

Jika jumlah maksimum tercapai, stempel tidak akan ditambahkan lagi.
Alur yang disarankan:

  1. Periksa stamps dan maxStamps
  2. Jika sama, berarti sudah penuh
  3. Gunakan Update API dan set useYn ke Y
  4. Panggil Stamp Create API untuk memulai siklus baru
  5. Lanjutkan dengan proses akumulasi berikutnya

Syarat dan batasan akumulasi

Akumulasi stempel tidak selalu diterapkan secara otomatis.

Harus memenuhi kondisi berikut:

  • Stempel dalam status aktif (activeYn = Y)
  • Dalam periode berlaku (strtYmd ~ endYmd)
  • Belum mencapai jumlah maksimum (stamps < maxStamps)
  • Belum digunakan

Kondisi ini memastikan akumulasi sesuai dengan aturan kampanye.

Contoh penggunaan

  • Event kunjungan: Tambahkan satu stempel saat pengguna berkunjung
  • Reward pembelian: Tambahkan stempel otomatis setelah pembayaran
  • Event berbasis misi: Berikan stempel saat aksi tertentu selesai
  • Check-in harian: Tambahkan satu stempel setiap login harian

Poin penting dalam operasional

API akumulasi stempel adalah komponen penting yang memengaruhi kualitas event secara langsung.

  • Akumulasi yang tidak tepat dapat menurunkan kepercayaan pengguna
  • Pemanggilan API ganda dapat menyebabkan akumulasi berlebih
  • Berpengaruh langsung pada pengalaman pengguna

Gunakan selalu bersama validasi dan kontrol logika di sisi server.