스템프 생성

이 API는 고객에게 새로운 스템프를 발급하는 기능을 제공합니다.

카드 IDX는 필수 입력 항목이며, 대시보드의 “스템프 카드” 페이지에서 확인할 수 있습니다.

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

POST

/api/stamp/v1/create 

{
    "cardIdx": 123,  // You can check the IDX value on the card management page of the dashboard.
    "domain": "https://vvd.bz",
    "strtYmd": "2025-01-01",
    "endYmd": "2025-12-31",
    "activeYn": "Y",
    "memo": "New Member Registration, IP: 211.111.222.33",
    "userId": "att78z",
    "userNm": "Brown Smith",
    "userPhnno": "+1 123-4567-8900",
    "userEml": "test@gmail.com",
    "userEtc1": "Gold rating",
    "userEtc2": ""
}

Request Parameters

cardIdxintegerrequired
카드 IDX. 카드 IDX는 대시보드의 “스템프 카드” 페이지에서 확인할 수 있습니다.
domainstring
Default:https://vvd.bz
스템프 도메인. 값이 비어있으면 기본 도메인으로 저장됩니다.
프리미엄 요금제 이상에서는, 링크 도메인 관리에서 등록한 커스텀 도메인을 지정할 수 있습니다.
strtYmddaterequired
스템프 유효 시작일. 예: 2025-01-01
endYmddaterequired
스템프 유효 만료일. 예: 2025-12-31
만료일은 오늘로 부터 최대 5년까지 설정할 수 있습니다.
activeYnstring
Default:Y
Enum:
YN
스템프 활성화 여부. 비활성화되면 고객이 스템프를 사용할 수 없습니다.
memostring
내부 참고용 메모.
userIdstring
사용자 ID. 스템프 발급 대상자를 관리하는데 사용됩니다.
일반적으로 웹사이트 회원의 로그인 ID를 입력합니다.
설정되지 않으면 시스템에 의해 자동으로 사용자 ID가 생성됩니다.
userNmstring
사용자 이름. 내부 관리용.
userPhnnostring
사용자 연락처. 내부 관리용.
userEmlstring
사용자 이메일. 내부 관리용.
userEtc1string
추가 내부 관리용 필드.
userEtc2string
추가 내부 관리용 필드. 
{
    "code": 0,
    "message": "",
    "result": "ZJLF0399WQBEQZJM"
}

Response Parameters

codeinteger
응답 코드: 0 = 성공, 그 외 값 = 오류
messagestring
응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
resultinteger
응답 값입니다. 생성된 스템프 IDX가 반환됩니다.
예: 1347