쿠폰 관리
프로모션 > 쿠폰 — 쿠폰을 만들고 고치고 지우고, 이용 내역과 카카오톡 채널용 쿠폰번호를 다룹니다. 쇼핑몰 관리자 > 프로모션 > 쿠폰과 같은 검사입니다.
업데이트됨 10.16 — 쿠폰에 적용 카테고리가 생겼습니다무엇인가요
쇼핑몰 관리자 > 프로모션 > 쿠폰 만들기 · 쿠폰 이용 내역과 같은 작업 · 같은 검사입니다. 쿠폰은 손님에게 바로 할인이 나가는 일이라 상품 · 회원과 따로 promotions:read · promotions:write 권한을 씁니다.
| 요청 | 경로 | 내용 | 권한 |
|---|---|---|---|
| GET | /coupons · /coupons/{coupon_unique} | 쿠폰 목록 · 상세 | promotions:read |
| POST | /coupons | 쿠폰 생성 | promotions:write |
| PATCH | /coupons/{coupon_unique} | 쿠폰 수정 | promotions:write |
| DELETE | /coupons/{coupon_unique} | 쿠폰 삭제 | promotions:write |
| GET | /coupons/issues · /coupons/{coupon_unique}/issues | 쿠폰 이용 내역 | promotions:read |
| POST | /coupons/{coupon_unique}/serials 외 조회 | 쿠폰번호 발급 | promotions:read · write |
같이 쓰는 규칙
- 손님은 쿠폰마다 붙는 등록 주소(
register_url)에서 쿠폰을 받습니다. 연결 도메인이 열려 있으면 그 주소입니다 — 관리자 목록에 보이는 주소와 같습니다. - 카카오톡 채널 온라인 쿠폰은
serial_mode: UNIQUE로 만들고, 쿠폰번호를 만들어 받은 번호 목록을 카카오에 올립니다. 등록 주소 뒤에 카카오가?serial=번호를 붙여 손님을 보냅니다. - 적용 카테고리(
category_mode: ON)는 고른 카테고리부터 그 하위 전체의 상품에만 씁니다. 카테고리 키는 상품 카테고리에서 얻습니다. - 고르는 값(status · coupon_type · discount_type · category_mode · serial_mode · period_type)이 목록에 없으면 400 입니다 — 기본값으로 바꿔 저장하지 않습니다.
- 수정은 보낸 필드만 바뀝니다. 이미 발급된 쿠폰은 발급될 때의 조건을 그대로 씁니다 — 쿠폰을 고쳐도 손님이 받은 장은 바뀌지 않습니다.