스템프 검증

이 API는 스템프 도장 추가, 도장 제거, 혜택 사용 처리 전에 스템프가 유효한지 확인하는데 사용됩니다.

다음 기준으로 스템프의 유효성을 검증합니다:

  • 스템프 IDX의 유효성
  • 스템프 유효기간
  • 스템프 활성화 여부
  • 이미 혜택이 사용된 스템프 여부

이 API는 퍼스널 요금제 이상에서만 제공됩니다.

GET

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

{
    "stampIdx": 274
}

Request Parameters

stampIdx integer required
스템프 IDX. 
{
    "code": 0,
    "message": "",
    "result": {
        "stampIdx": 16,
        "domain": "https://vvd.bz",
        "cardIdx": 1,
        "cardNm": "Accumulate 10 Americanos",
        "cardTtl": "Collect 10 stamps to get one free Americano.",
        "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

code integer
응답 코드: 0 = 성공, 그 외 값 = 오류
message string
응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
result object
검증에 성공하면 응답값에 스템프 정보가 포함되어 반환됩니다.
검증에 실패하면 응답값은 null이며, 오류 메시지를 통해 원인을 확인할 수 있습니다.
stampIdx integer
스템프 IDX.
domain string
스템프 도메인.
cardIdx integer
카드 IDX.
cardNm string
카드 이름.
cardTtl string
카드 제목.
stamps integer
현재까지 적립된 도장 수.
maxStamps integer
카드의 최대 도장 수.
stampUrl string
스템프 페이지의 URL.
url string
스템프 페이지에서 버튼 클릭 시 이동될 URL.
strtYmd date
스템프 유효 시작일.
endYmd date
스템프 유효 만료일.
onsiteYn string
Enum:
YN
현장 적립 여부로 값이 Y이면, 매장에서 직원이 도장 적립이 가능합니다.
onsitePwd string
현장적립 비밀번호. 현장적립 여부(Y)일 경우, 스템프 혜택 사용 API 호출 시 반드시 필요합니다.
memo string
내부 참고용 메모.
activeYn string
Enum:
YN
스템프 활성화 여부. 비활성화되면 고객이 스템프를 사용할 수 없습니다.
userId string
사용자 ID. 스템프 발급 대상자를 관리하는데 사용됩니다.
일반적으로 웹사이트 회원의 로그인 ID를 입력합니다.
설정되지 않으면 시스템에 의해 자동으로 사용자 ID가 생성됩니다.
userNm string
사용자 이름. 내부 관리용.
userPhnno string
사용자 연락처. 내부 관리용.
userEml string
사용자 이메일. 내부 관리용.
userEtc1 string
추가 내부 관리용 필드.
userEtc2 string
추가 내부 관리용 필드.
stampImgUrl string
스템프 도장의 이미지 URL.
regYmdt datetime
스템프 생성 날짜. 예: 2025-07-21 11:50:20