Mall StoryDevelopers
Mall Story
관리자 API템플릿 관리소유자 토큰

방문수령

방문수령 템플릿 — 매장 · 영업시간 · 휴무일을 관리합니다.

업데이트됨 10.13 — 목록의 기본 순서를 관리자 목록에 맞췄습니다

무엇인가요

방문수령 템플릿입니다. 손님이 찾아갈 매장과 영업시간 · 휴무일을 정합니다. 배송비 필드는 쓰지 않습니다(무료).

항목내용
권한읽기 products:read · 쓰기 products:write (소유자 토큰)
상품에서 쓰는 곳상품의 delivery — [{"method": "…", "template_id": "…"}]
관리자 화면상품 > 템플릿 관리 — 같은 검증 · 같은 저장
요청경로바로가기
GEThttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/delivery?method=PICKUP목록
GEThttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/delivery/{template_unique}상세
POSThttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/delivery생성
PATCHhttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/delivery/{template_unique}수정
DELETEhttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/delivery/{template_unique}삭제

목록

GEThttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/delivery?method=PICKUP

이 쇼핑몰의 이 배송 방법의 템플릿 전부입니다(쪽 나눔 없음). 줄마다 이 템플릿을 쓰는 상품 수 used_count 가 붙습니다 — 관리자 목록의 "적용상품" 칸과 같습니다.

쿼리형식설명
method필수stringPICKUP — 빼면 배송 템플릿 넷이 모두 나옵니다
sortstring정렬 키. 빼면 등록일시 최신순(관리자 목록의 기본과 같음) 코드값
orderstring정렬 방향. 빼면 name 는 오름차순, 시각은 최신순. sort 와 함께 보냅니다 코드값
bash요청
curl 'https://api.mallstory.kr/v1/shop/{shop_unique}/templates/delivery?method=PICKUP' \
  -H 'Authorization: Bearer msat_8Hk2wQ7...'
json200 OK
{
  "items": [
    {
      "template_unique": "6acca48fc2ca90eedea620f9",
      "name": "본점 방문수령",
      "method": "PICKUP",
      "is_default": false,
      "fee_type": "FREE",
      "base_fee": 0,
      "free_condition_amount": 0,
      "pay_type": "PREPAID",
      "unit_quantity": 0,
      "range_count": 2,
      "range_tiers": [],
      "extra_fee": {
        "jeju": 0,
        "island": 0
      },
      "return_fee": 0,
      "exchange_fee": 0,
      "courier_id": null,
      "outbound_address": null,
      "return_address": null,
      "notice": "",
      "delivery_area": null,
      "install": null,
      "pickup": {
        "store_name": "본점",
        "phone": "0212345678",
        "address": {
          "zipcode": "04524",
          "address1": "서울 중구 세종대로 110",
          "address2": "1층",
          "bcode": "",
          "road_code": ""
        },
        "open": "10:00",
        "close": "19:00",
        "break_use": true,
        "break_start": "12:00",
        "break_end": "13:00",
        "holiday_use": true,
        "holidays": [
          "SUN",
          "HOLIDAY"
        ],
        "shipping_address": false
      },
      "quick": null,
      "used_count": 0,
      "created": "2026-10-12T09:12:47.333Z",
      "updated": "2026-10-12T09:12:47.333Z"
    }
  ]
}

상세

GEThttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/delivery/{template_unique}
bash요청
curl 'https://api.mallstory.kr/v1/shop/{shop_unique}/templates/delivery/6acca48fc2ca90eedea620f9' \
  -H 'Authorization: Bearer msat_8Hk2wQ7...'
json200 OK
{
  "template_unique": "6acca48fc2ca90eedea620f9",
  "name": "본점 방문수령",
  "method": "PICKUP",
  "is_default": false,
  "fee_type": "FREE",
  "base_fee": 0,
  "free_condition_amount": 0,
  "pay_type": "PREPAID",
  "unit_quantity": 0,
  "range_count": 2,
  "range_tiers": [],
  "extra_fee": {
    "jeju": 0,
    "island": 0
  },
  "return_fee": 0,
  "exchange_fee": 0,
  "courier_id": null,
  "outbound_address": null,
  "return_address": null,
  "notice": "",
  "delivery_area": null,
  "install": null,
  "pickup": {
    "store_name": "본점",
    "phone": "0212345678",
    "address": {
      "zipcode": "04524",
      "address1": "서울 중구 세종대로 110",
      "address2": "1층",
      "bcode": "",
      "road_code": ""
    },
    "open": "10:00",
    "close": "19:00",
    "break_use": true,
    "break_start": "12:00",
    "break_end": "13:00",
    "holiday_use": true,
    "holidays": [
      "SUN",
      "HOLIDAY"
    ],
    "shipping_address": false
  },
  "quick": null
}

응답 필드

필드형식설명
template_uniquestring키. 상세 · 수정 · 삭제 경로에 넣습니다
namestring템플릿명
methodstring배송 방법. 이 쪽은 아래 값으로 고정입니다 코드값
is_defaultboolean이 배송 방법의 기본 템플릿인가(상품 등록 때 먼저 고름)
pickupobject매장 — store_name · phone(숫자) · address({zipcode, address1, address2}) · open · close(HH:MM) · break_use · break_start · break_end · holiday_use · holidays(쉬는 요일) · shipping_address(주문 때 배송지를 받는가) 코드값
noticestring안내 문구
courier_idstring택배사 키 — 택배배송에서만, 다른 배송 방법은 null
outbound_addressobject | null출고지 — 택배배송에서만
return_addressobject | null반품 · 교환지 — 택배배송에서만
delivery_areaobject | null배송가능 지역 — 직접배송 · 퀵배송에서만
installobject | null상품 설치 — 직접배송에서만
pickupobject | null매장 · 영업시간 — 방문수령에서만
quickobject | null퀵 설정 — 퀵배송에서만
createdISO생성 시각
updatedISO마지막 수정 시각
used_countnumber이 템플릿을 쓰는 상품 수(목록에만)

생성

POSThttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/delivery

요청 본문

필드형식설명
name필수string템플릿명
method필수string배송 방법. 이 쪽은 아래 값으로 고정입니다 코드값
is_defaultboolean이 배송 방법의 기본 템플릿인가(상품 등록 때 먼저 고름)
pickup필수object매장 — store_name · phone(숫자) · address({zipcode, address1, address2}) · open · close(HH:MM) · break_use · break_start · break_end · holiday_use · holidays(쉬는 요일) · shipping_address(주문 때 배송지를 받는가) 코드값
noticestring안내 문구
bash요청
curl -X POST 'https://api.mallstory.kr/v1/shop/{shop_unique}/templates/delivery' \
  -H 'Authorization: Bearer msat_8Hk2wQ7...' \
  -H 'Content-Type: application/json' \
  -d '{"name":"본점 방문수령","method":"PICKUP","pickup":{"store_name":"본점","phone":"0212345678","address":{"zipcode":"04524","address1":"서울 중구 세종대로 110","address2":"1층"},"open":"10:00","close":"19:00","break_use":true,"break_start":"12:00","break_end":"13:00","holiday_use":true,"holidays":["SUN","HOLIDAY"],"shipping_address":false}}'
json201 Created
{
  "template_unique": "6acca48fc2ca90eedea620f9"
}

새 템플릿의 키를 돌려줍니다.

수정

PATCHhttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/delivery/{template_unique}

보낸 필드만 바뀝니다. 나머지는 지금 값 그대로입니다. 필드는 생성과 같습니다. pickup 은 객체를 통째로 보냅니다.

bash요청
curl -X PATCH 'https://api.mallstory.kr/v1/shop/{shop_unique}/templates/delivery/6acca48fc2ca90eedea620f9' \
  -H 'Authorization: Bearer msat_8Hk2wQ7...' \
  -H 'Content-Type: application/json' \
  -d '{"pickup":{"store_name":"본점","phone":"0212345678","address":{"zipcode":"04524","address1":"서울 중구 세종대로 110","address2":"1층"},"open":"10:00","close":"20:00","break_use":false,"break_start":"","break_end":"","holiday_use":true,"holidays":["SUN","HOLIDAY"],"shipping_address":false}}'
json200 OK
{
  "template_unique": "6acca48fc2ca90eedea620f9"
}
json수정 뒤 상세
{
  "template_unique": "6acca48fc2ca90eedea620f9",
  "name": "본점 방문수령",
  "method": "PICKUP",
  "is_default": false,
  "fee_type": "FREE",
  "base_fee": 0,
  "free_condition_amount": 0,
  "pay_type": "PREPAID",
  "unit_quantity": 0,
  "range_count": 2,
  "range_tiers": [],
  "extra_fee": {
    "jeju": 0,
    "island": 0
  },
  "return_fee": 0,
  "exchange_fee": 0,
  "courier_id": null,
  "outbound_address": null,
  "return_address": null,
  "notice": "",
  "delivery_area": null,
  "install": null,
  "pickup": {
    "store_name": "본점",
    "phone": "0212345678",
    "address": {
      "zipcode": "04524",
      "address1": "서울 중구 세종대로 110",
      "address2": "1층",
      "bcode": "",
      "road_code": ""
    },
    "open": "10:00",
    "close": "20:00",
    "break_use": false,
    "break_start": "",
    "break_end": "",
    "holiday_use": true,
    "holidays": [
      "SUN",
      "HOLIDAY"
    ],
    "shipping_address": false
  },
  "quick": null
}

삭제

DELETEhttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/delivery/{template_unique}
bash요청
curl -X DELETE 'https://api.mallstory.kr/v1/shop/{shop_unique}/templates/delivery/6acca48fc2ca90eedea620f9' \
  -H 'Authorization: Bearer msat_8Hk2wQ7...'
json200 OK
{
  "affected": 0
}

지운 템플릿을 쓰던 상품은 그 배송 방식이 정리됩니다. affected 는 바뀐 상품 수입니다.

오류

상태code언제
400InvalidParameterValue필수 값이 없거나 값이 올바르지 않음(예: 배송비 유형 값이 올바르지 않습니다)
404DeliveryTemplateNotExist없는 키이거나 지운 템플릿
401MissingLoginSessionAuthorization 헤더에 Bearer 토큰이 없음
401InvalidAccessToken토큰이 틀리거나 만료 · 폐기됨
403InsufficientScope토큰에 products:read · products:write 가 없음

오류 본문은 {code, message, request_id} 이고, message 는 관리자 화면과 같은 문구라 사용자에게 그대로 보여 줄 수 있습니다.