관리자 API쿠폰 관리소유자 토큰

쿠폰 수정

보낸 필드만 고칩니다. 검사는 지금 값과 합친 한 벌로 합니다.

수정

PATCHhttps://api.mallstory.kr/v1/shop/{shop_unique}/coupons/{coupon_unique}

권한 promotions:write

보낸 필드만 바뀝니다. 필드는 생성과 같고, 검사는 지금 값과 합친 한 벌로 합니다 — 할인금액만 보내도 최소 주문금액과 견줍니다. code · 발급 수 같은 읽기 전용 칸은 보내도 버립니다.

bash요청

curl -X PATCH 'https://api.mallstory.kr/v1/shop/6a9515bdcb3ab5179ba767ad/coupons/6acdf4194555cab633c38c9c' \
  -H 'Authorization: Bearer msat_8Hk2wQ7...' \
  -H 'Content-Type: application/json' \
  -d '{"discount_value":5000,"status":"stop"}'

json200 OK

{
  "coupon_unique": "6acdf4194555cab633c38c9c",
  "code": "30e6ddb032cd139b",
  "name": "가을맞이 3,000원 할인",
  "status": "stop",
  "coupon_type": "ORDER",
  "discount_type": "AMOUNT",
  "discount_value": 5000,
  "max_discount": 0,
  "min_order_amount": 30000,
  "serial_mode": "OFF",
  "serial": "",
  "serial_count": 0,
  "serial_used_count": 0,
  "period_type": "DAYS",
  "period_days": 7,
  "start_at": "",
  "end_at": "",
  "issue_limit": 0,
  "per_person_limit": 1,
  "issued_count": 0,
  "used_count": 0,
  "created": "2026-10-13T09:04:25.599Z",
  "register_url": "https://testmall.xyz/coupon/register/30e6ddb032cd139b"
}

할인금액이 3,000원 → 5,000원, 상태가 중지로 바뀌고 나머지는 그대로입니다.

json400 — 할인금액이 최소 주문금액 이상

{
  "code": "InvalidParameterValue",
  "message": "할인금액은 최소 주문금액보다 작아야 합니다.",
  "request_id": "req_8c04f68641ae4e969447040c50157153"
}

이미 발급된 쿠폰은 발급될 때의 할인 값을 그대로 씁니다 — 쿠폰을 고쳐도 손님이 받은 장은 바뀌지 않습니다.
category_mode 를 OFF 로 보내면 category_ids 는 비워 저장됩니다. ON 으로 바꿀 때는 category_ids 를 함께 보냅니다.

오류

상태	code	언제
400	`InvalidParameterValue`	규칙 위반
404	`CouponNotExist`	없는 키이거나 지운 쿠폰
401	`MissingLoginSession`	Authorization 헤더에 Bearer 토큰이 없음
401	`InvalidAccessToken`	토큰이 틀리거나 만료 · 폐기됨
403	`InsufficientScope`	토큰에 promotions:write 가 없음

수정#

오류

수정