스템프 삭제 API

스탬프 삭제 API는 생성된 스탬프를 영구적으로 삭제하는 기능을 제공합니다.

삭제된 스탬프는 복구할 수 없으며, 해당 스탬프에 적립된 도장 이력도 함께 제거됩니다.
여러 스탬프를 한 번에 삭제하려면 대시보드를 이용하세요.

이 API는 퍼스널 요금제 이상에서만 사용할 수 있습니다.

DELETE

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


DELETE /api/stamp/v1/delete
        ?stampIdx=394

Request Parameters

stampIdx integer required
스템프 IDX. 
{
    "code": 0,
    "message": "",
    "result": null
}

Response Parameters

code integer
응답 코드: 0 = 성공, 그 외 값 = 오류
message string
응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
result null

어떤 상황에서 삭제가 필요한가요?

스탬프 삭제는 단순한 데이터 정리가 아닙니다.
고객 입장에서는 그동안 적립한 도장이 사라지는 것을 의미합니다. 삭제 API를 호출하기 전에 다음을 먼저 판단하세요.

삭제가 적절한 경우

  • 테스트 목적으로 생성한 스탬프
  • 중복이나 잘못 발급되어 고객에게 노출되지 않은 스탬프
  • 이미 혜택 사용이 완료되어 더 이상 필요 없는 스탬프

삭제 대신 수정 API를 사용해야 하는 경우

  • 고객이 이미 도장을 적립한 스탬프 → activeYn을 N으로 변경해 비활성화
  • 유효기간만 조정하고 싶은 경우 → endYmd 수정
  • 일시적으로 사용을 막고 싶은 경우 → activeYn 비활성화 후 필요 시 재활성화

운영 환경에서는 신중하게 사용해야 하는 기능이며
삭제는 되돌릴 수 없으므로, 고객 데이터가 연결된 스탬프라면 비활성화를 먼저 검토하세요.

운영 관점에서의 주의 포인트

스템프 데이터는 사용자 행동 이력과 직접 연결됩니다. 따라서 삭제는 신중하게 처리해야 합니다.

  • 삭제 시 리워드 조건 계산에 영향을 줄 수 있습니다
  • 누적 적립 기반 이벤트에서 결과가 달라질 수 있습니다
  • 사용자 클레임 발생 가능성을 고려해야 합니다

가능한 삭제 대신 상태 변경 또는 수정 API(Update)를 우선 고려하는 것이 안전합니다.

stampIdx 확인 방법

stampIdx는 스탬프 생성 시 응답값으로 반환되는 고유 ID입니다.

생성 API 호출 시 반환된 stampIdx를 별도로 저장해 두지 않았다면, 대시보드에서 해당 스탬프를 조회해 확인할 수 있습니다.

삭제는 복구가 불가능하므로 호출 전에 stampIdx가 올바른 스탬프를 가리키고 있는지 반드시 확인하세요.

활용 예시

  • 잘못 적립된 데이터 제거: 오류로 인해 중복 적립된 스탬프 삭제
  • 테스트 데이터 정리: 개발 및 QA 과정에서 생성된 스탬프 제거
  • 이벤트 데이터 정리: 종료된 이벤트의 불필요한 스탬프 삭제