Validasi Stempel

API ini digunakan untuk memeriksa apakah stempel masih valid sebelum menambah, menghapus, atau memproses penggunaan hadiah.

Validasi dilakukan berdasarkan kriteria berikut:

  • Validitas Stamp IDX
  • Periode validitas stempel
  • Status aktivasi stempel
  • Apakah hadiah sudah digunakan

API ini tersedia untuk paket Personal ke atas.

GET

/api/stamp/v1/validate?stampIdx={stampIdx}

{
    "stampIdx": 274
}

Request Parameters

stampIdxintegerrequired
스템프 IDX. 
{
    "code": 0,
    "message": "",
    "result": {
        "stampIdx": 16,
        "domain": "https://vvd.bz",
        "cardIdx": 1,
        "cardNm": "아메리카노 10잔 적립",
        "cardTtl": "도장을 10개 모으면 아메리카노 1잔 무료",
        "stamps": 10,
        "maxStamps": 12,
        "stampUrl": "https://vvd.bz/stamp/274",
        "url": "https://myshopping.com",
        "strtYmd": "2025-01-01",
        "endYmd": "2026-12-31",
        "onsiteYn": "Y",
        "onsitePwd": "123456",
        "memo": null,
        "activeYn": "Y",
        "userId": "NKkDu9X4p4mQ",
        "userNm": null,
        "userPhnno": null,
        "userEml": null,
        "userEtc1": null,
        "userEtc2": null,
        "stampImgUrl": "https://cdn.vivoldi.com/www/image/icon/stamp/icon.stamp.1.webp",
        "regYmdt": "2025-10-30 05:11:35",
        "payloadVersion": "v1"
    }
}

Response Parameters

codeinteger
Kode respons: 0 = Berhasil, nilai lain = Error
messagestring
Pesan respons. Jika kode tidak sama dengan 0, pesan kesalahan akan dikembalikan.
resultobject
Jika verifikasi berhasil, respons akan berisi informasi stempel.
Jika gagal, nilai respons akan menjadi null dan pesan kesalahan akan menunjukkan penyebabnya.
stampIdxinteger
Stamp IDX.
domainstring
Domain cap.
cardIdxinteger
Card IDX.
cardNmstring
Nama kartu.
cardTtlstring
Judul kartu.
stampsinteger
Jumlah cap yang telah dikumpulkan sejauh ini.
maxStampsinteger
Jumlah maksimum cap pada kartu.
stampUrlstring
URL halaman cap.
urlstring
URL tujuan yang akan dibuka saat tombol di halaman cap diklik.
strtYmddate
Tanggal mulai masa berlaku cap.
endYmddate
Tanggal berakhirnya masa berlaku cap.
onsiteYnstring
Enum:
YN
Menunjukkan apakah penambahan cap di lokasi diaktifkan.
Jika nilainya Y, staf toko dapat menambahkan cap langsung di tempat.
onsitePwdstring
Kata sandi untuk penambahan cap di lokasi.
Diperlukan saat menggunakan API penggunaan manfaat jika opsi di lokasi diaktifkan (Y).
memostring
Catatan internal untuk referensi.
activeYnstring
Enum:
YN
Menunjukkan apakah cap aktif.
Jika dinonaktifkan, pelanggan tidak dapat menggunakan cap tersebut.
userIdstring
ID pengguna. Digunakan untuk mengelola penerima cap.
Biasanya ini adalah ID login anggota situs web.
Jika tidak diatur, sistem akan membuat ID pengguna secara otomatis.
userNmstring
Nama pengguna. Hanya untuk keperluan internal.
userPhnnostring
Nomor telepon pengguna. Hanya untuk keperluan internal.
userEmlstring
Alamat email pengguna. Hanya untuk keperluan internal.
userEtc1string
Kolom tambahan untuk manajemen internal.
userEtc2string
Kolom tambahan untuk manajemen internal.
stampImgUrlstring
URL gambar cap.
regYmdtdatetime
Tanggal pembuatan cap. Contoh: 2025-07-21 11:50:20