스템프 혜택 사용

이 API는 고객이 모든 도장을 모은 후 제공된 혜택(예: 무료 음료, 할인 등)을 사용 완료 상태로 변경합니다.

혜택 사용 완료 시 해당 스탬프는 더 이상 사용할 수 없으므로, 고객은 새로운 스탬프를 발급받아야 합니다.
고객의 방문·구매 이력에 따라 스탬프를 적립하고 혜택을 처리하는 시스템에 적용됩니다.

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

PUT

/api/stamp/v1/redeem

{
    "stampIdx": 394,
    "onsitePwd": "12345"
}

Request Parameters

stampIdxintegerrequired
스템프 IDX.
onsitePwdstring
현장 적립용 스탬프에서 사용되는 직원 인증 비밀번호입니다.
스탬프가 onsiteYn = Y로 설정된 경우에만 필수 입력 항목이며, 매장 직원이 고객의 혜택 사용(예: 무료 음료 교환 등)을 승인할 때 이 값을 입력해야 합니다.
비밀번호는 Validate API 호출 시 반환되는 onsitePwd 값을 참고하여 입력하세요.
{
    "code": 0,
    "message": "",
    "result": null
}

Response Parameters

codeinteger
응답 코드: 0 = 성공, 그 외 값 = 오류
messagestring
응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
resultnull