bootpay 3.0.0 → 3.2.0

data/lib/bootpay_store/concern/deposit.rb

@@ -0,0 +1,115 @@
+module BootpayStore::Concern::Deposit
+  extend ActiveSupport::Concern
+
+  # 뱅크알람 입금대기 웹훅 이벤트 (입금 웹훅 본문의 event)
+  BANK_DEPOSIT_WEBHOOK_EVENT_RECEIVED           = 400 # 입금 알림을 처음 저장했다 (주문 연결 전)
+  BANK_DEPOSIT_WEBHOOK_EVENT_MATCHED            = 401 # 입금대기 주문 한 건과 연결되어 입금 확인됐다
+  BANK_DEPOSIT_WEBHOOK_EVENT_AMBIGUOUS          = 402 # 같은 금액의 입금대기 주문이 여럿이라 판매자가 골라야 한다
+  BANK_DEPOSIT_WEBHOOK_EVENT_UNMATCHED          = 403 # 연결할 입금대기 주문이 없다
+  BANK_DEPOSIT_WEBHOOK_EVENT_CONFIRMED_MANUALLY = 404 # 판매자가 관리자에서 직접 입금을 확인했다
+  BANK_DEPOSIT_WEBHOOK_EVENT_EXPIRED            = 405 # 입금 기한이 지나 닫혔다
+  BANK_DEPOSIT_WEBHOOK_EVENT_CANCELLED          = 406 # 입금대기 중인 주문을 취소했다
+  BANK_DEPOSIT_WEBHOOK_EVENT_REVERTED           = 407 # 입금 확인을 되돌려 다시 입금대기로 바꿨다
+
+  included do
+    # 판매자 입금 계좌 목록 (GET /v1/sdk/deposits/accounts) — supervisor 전용
+    # @comment_by Claude
+    # @date: 26-11-12
+    # 첫 계좌가 대표 계좌(primary: true)다.
+    def deposit_accounts(idempotency_key: nil)
+      request(
+        uri:     'sdk/deposits/accounts',
+        method:  :get,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => 'supervisor'
+        }
+      )
+    end
+
+    # 입금 웹훅 서명 비밀값 발급 (POST /v1/sdk/deposits/webhook_secret) — supervisor 전용
+    # @comment_by Claude
+    # @date: 26-11-12
+    # ⚠️ 원문은 이 응답에서만 오고, 부를 때마다 바뀐다.
+    # 웹훅은 X-Bootpay-Signature: sha256=HMAC_SHA256(secret, "{X-Bootpay-Timestamp}.{raw_body}") 로 서명된다.
+    def deposit_webhook_secret(idempotency_key: nil)
+      request(
+        uri:     'sdk/deposits/webhook_secret',
+        method:  :post,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => 'supervisor'
+        }
+      )
+    end
+
+    # 입금대기 등록 (POST /v1/sdk/deposits) — supervisor 전용
+    # @comment_by Claude
+    # @date: 26-11-12
+    # 같은 merchant_order_id 로 금액·입금자명·계좌가 같은 재호출은 기존 주문을 돌려주고, 하나라도 다르면 18110.
+    # webhook_url 을 주려면 deposit_webhook_secret 으로 비밀값을 먼저 발급받아야 한다(18131).
+    # notify(구매자 알림톡, 유료): { deposit_guide:, deposit_paid:, link: } — buyer_phone 필수(18134), link 는 https(18135).
+    def deposit_create(merchant_order_id:, price:, depositor:, order_name: nil, memo: nil, buyer_name: nil,
+                       buyer_phone: nil, buyer_email: nil, account_id: nil, webhook_url: nil, notify: nil,
+                       idempotency_key: nil)
+      request(
+        uri:     'sdk/deposits',
+        method:  :post,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => 'supervisor'
+        },
+        payload: {
+                   merchant_order_id: merchant_order_id,
+                   price:             price,
+                   depositor:         depositor,
+                   order_name:        order_name,
+                   memo:              memo,
+                   buyer_name:        buyer_name,
+                   buyer_phone:       buyer_phone,
+                   buyer_email:       buyer_email,
+                   account_id:        account_id,
+                   webhook_url:       webhook_url,
+                   notify:            notify.is_a?(Hash) ? notify.compact : notify
+                 }.compact
+      )
+    end
+
+    # 입금대기 조회 (GET /v1/sdk/deposits/:id) — supervisor 전용
+    # @comment_by Claude
+    # @date: 26-11-12
+    # deposit_id 는 가맹점 주문번호(merchant_order_id) 또는 부트페이 주문번호. 자유 문자열이라 경로 인코딩한다.
+    def deposit_detail(deposit_id:, idempotency_key: nil)
+      request(
+        uri:     "sdk/deposits/#{deposit_path_segment(deposit_id)}",
+        method:  :get,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => 'supervisor'
+        }
+      )
+    end
+
+    # 입금대기 취소 (DELETE /v1/sdk/deposits/:id) — supervisor 전용
+    # @comment_by Claude
+    # @date: 26-11-12
+    # 이미 닫힌 주문은 그대로 돌려준다. 입금 확인된 주문은 18108.
+    def deposit_cancel(deposit_id:, idempotency_key: nil)
+      request(
+        uri:     "sdk/deposits/#{deposit_path_segment(deposit_id)}",
+        method:  :delete,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => 'supervisor'
+        }
+      )
+    end
+
+    private
+
+    # 경로 세그먼트 인코딩 — 공백은 %20, / 는 %2F (다른 SDK 와 같은 결과)
+    def deposit_path_segment(value)
+      URI.encode_www_form_component(value.to_s).gsub('+', '%20')
+    end
+  end
+end

data/lib/bootpay_store/concern/faq.rb

@@ -0,0 +1,97 @@
+module BootpayStore::Concern::Faq
+  extend ActiveSupport::Concern
+
+  included do
+    # FAQ 목록 (GET /v1/faqs)
+    # @comment_by Claude
+    # @date: 26-09-29
+    # supervisor: true 면 운영자 모드(Bootpay-Role: supervisor) — view: 'all' 로 비공개 FAQ 까지 조회할 수 있다.
+    # 고객 모드는 몰 FAQ 사용여부가 꺼져 있으면 BOARD_FEATURE_DISABLED 로 거절된다.
+    def faqs(page: 1, limit: 20, keyword: nil, view: nil, supervisor: false, idempotency_key: nil)
+      request(
+        uri:     'faqs',
+        method:  :get,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => supervisor ? 'supervisor' : 'user'
+        },
+        params:  {
+                   page:    page,
+                   limit:   limit,
+                   keyword: keyword,
+                   view:    view
+                 }.compact
+      )
+    end
+
+    # FAQ 단건 (GET /v1/faqs/:id)
+    # @comment_by Claude
+    # @date: 26-09-29
+    # 비공개 FAQ 는 supervisor: true 일 때만 보인다(아니면 404 POST_NOT_FOUND).
+    def faq_detail(faq_id:, supervisor: false, idempotency_key: nil)
+      request(
+        uri:     "faqs/#{faq_id}",
+        method:  :get,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => supervisor ? 'supervisor' : 'user'
+        }
+      )
+    end
+
+    # FAQ 등록 (POST /v1/faqs) — supervisor 전용
+    # @comment_by Claude
+    # @date: 26-09-29
+    def faq_create(title:, content:, images: nil, is_display: nil, idempotency_key: nil)
+      request(
+        uri:     'faqs',
+        method:  :post,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => 'supervisor'
+        },
+        payload: {
+                   title:      title,
+                   content:    content,
+                   images:     images,
+                   is_display: is_display
+                 }.compact
+      )
+    end
+
+    # FAQ 수정 (PUT /v1/faqs/:id) — supervisor 전용
+    # @comment_by Claude
+    # @date: 26-09-29
+    # 보낸 필드만 바뀐다. images 는 보내면 목록 전체를 교체한다([] 면 모두 삭제).
+    def faq_update(faq_id:, title: nil, content: nil, images: nil, is_display: nil, idempotency_key: nil)
+      request(
+        uri:     "faqs/#{faq_id}",
+        method:  :put,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => 'supervisor'
+        },
+        payload: {
+                   title:      title,
+                   content:    content,
+                   images:     images,
+                   is_display: is_display
+                 }.compact
+      )
+    end
+
+    # FAQ 삭제 (DELETE /v1/faqs/:id) — supervisor 전용
+    # @comment_by Claude
+    # @date: 26-09-29
+    def faq_delete(faq_id:, idempotency_key: nil)
+      request(
+        uri:     "faqs/#{faq_id}",
+        method:  :delete,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => 'supervisor'
+        }
+      )
+    end
+  end
+end

data/lib/bootpay_store/concern/inquiry.rb

@@ -0,0 +1,138 @@
+module BootpayStore::Concern::Inquiry
+  extend ActiveSupport::Concern
+
+  included do
+    # 1:1 문의 목록 (GET /v1/inquiries)
+    # @comment_by Claude
+    # @date: 26-09-29
+    # 회원 모드: user_id(Bootpay 회원 _id 또는 외부 회원 ID)·login_id·user_jwt 중 하나로 회원을 정하고 본인 문의만 본다.
+    # supervisor: true 면 몰 전체 문의 — 이때 user_id 는 작성 회원 필터(선택)다.
+    # answered: true 답변 완료만 / false 미답변만 / nil 전체
+    def inquiries(user_id: nil, login_id: nil, user_jwt: nil, answered: nil, page: 1, limit: 20,
+                  supervisor: false, idempotency_key: nil)
+      request(
+        uri:     'inquiries',
+        method:  :get,
+        headers: {
+          'Idempotency-Key'  => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'     => supervisor ? 'supervisor' : 'user',
+          'Bootpay-User-JWT' => user_jwt
+        }.compact,
+        params:  {
+                   user_id:  user_id,
+                   login_id: login_id,
+                   answered: answered.nil? ? nil : answered.to_s,
+                   page:     page,
+                   limit:    limit
+                 }.compact
+      )
+    end
+
+    # 1:1 문의 단건 (GET /v1/inquiries/:id)
+    # @comment_by Claude
+    # @date: 26-09-29
+    # 회원 모드는 작성 회원 본인 문의만(다른 회원 문의는 404). supervisor: true 면 몰의 모든 문의.
+    def inquiry_detail(inquiry_id:, user_id: nil, login_id: nil, user_jwt: nil, supervisor: false, idempotency_key: nil)
+      request(
+        uri:     "inquiries/#{inquiry_id}",
+        method:  :get,
+        headers: {
+          'Idempotency-Key'  => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'     => supervisor ? 'supervisor' : 'user',
+          'Bootpay-User-JWT' => user_jwt
+        }.compact,
+        params:  {
+                   user_id:  user_id,
+                   login_id: login_id
+                 }.compact
+      )
+    end
+
+    # 1:1 문의 작성 (POST /v1/inquiries) — 회원 전용
+    # @comment_by Claude
+    # @date: 26-09-29
+    # product_id 는 이 몰의 상품, order_id 는 작성 회원의 주문이어야 한다. option 은 상품 옵션 문구(product_id 필요).
+    def inquiry_create(content:, user_id: nil, login_id: nil, user_jwt: nil, title: nil, product_id: nil,
+                       option: nil, order_id: nil, idempotency_key: nil)
+      request(
+        uri:     'inquiries',
+        method:  :post,
+        headers: {
+          'Idempotency-Key'  => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'     => 'user',
+          'Bootpay-User-JWT' => user_jwt
+        }.compact,
+        payload: {
+                   user_id:    user_id,
+                   login_id:   login_id,
+                   title:      title,
+                   content:    content,
+                   product_id: product_id,
+                   option:     option,
+                   order_id:   order_id
+                 }.compact
+      )
+    end
+
+    # 1:1 문의 수정 (PUT /v1/inquiries/:id) — 작성 회원 본인, 답변 전만
+    # @comment_by Claude
+    # @date: 26-09-29
+    # 답변이 달린 문의는 409 INQUIRY_ALREADY_ANSWERED. title 에 '' 를 보내면 제목을 지운다.
+    def inquiry_update(inquiry_id:, user_id: nil, login_id: nil, user_jwt: nil, title: nil, content: nil,
+                       idempotency_key: nil)
+      request(
+        uri:     "inquiries/#{inquiry_id}",
+        method:  :put,
+        headers: {
+          'Idempotency-Key'  => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'     => 'user',
+          'Bootpay-User-JWT' => user_jwt
+        }.compact,
+        payload: {
+                   user_id:  user_id,
+                   login_id: login_id,
+                   title:    title,
+                   content:  content
+                 }.compact
+      )
+    end
+
+    # 1:1 문의 삭제 (DELETE /v1/inquiries/:id) — 작성 회원 본인 또는 supervisor
+    # @comment_by Claude
+    # @date: 26-09-29
+    # 달린 답변도 함께 삭제된다.
+    def inquiry_delete(inquiry_id:, user_id: nil, login_id: nil, user_jwt: nil, supervisor: false, idempotency_key: nil)
+      request(
+        uri:     "inquiries/#{inquiry_id}",
+        method:  :delete,
+        headers: {
+          'Idempotency-Key'  => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'     => supervisor ? 'supervisor' : 'user',
+          'Bootpay-User-JWT' => user_jwt
+        }.compact,
+        params:  {
+                   user_id:  user_id,
+                   login_id: login_id
+                 }.compact
+      )
+    end
+
+    # 1:1 문의 답변 등록·수정 (PUT /v1/inquiries/:id/answer) — supervisor 전용
+    # @comment_by Claude
+    # @date: 26-09-29
+    # 답변이 없으면 만들고, 있으면 내용을 바꾼다. 응답은 답변이 반영된 문의 객체다.
+    def inquiry_answer(inquiry_id:, content:, idempotency_key: nil)
+      request(
+        uri:     "inquiries/#{inquiry_id}/answer",
+        method:  :put,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => 'supervisor'
+        },
+        payload: {
+          content: content
+        }
+      )
+    end
+  end
+end

data/lib/bootpay_store/concern/notice.rb

@@ -0,0 +1,100 @@
+module BootpayStore::Concern::Notice
+  extend ActiveSupport::Concern
+
+  included do
+    # 공지사항 목록 (GET /v1/notices)
+    # @comment_by Claude
+    # @date: 26-09-29
+    # supervisor: true 면 운영자 모드(Bootpay-Role: supervisor) — view: 'all' 로 비공개 공지까지 조회할 수 있다.
+    # 고객 모드는 몰 공지사항 사용여부가 꺼져 있으면 BOARD_FEATURE_DISABLED 로 거절된다.
+    def notices(page: 1, limit: 20, keyword: nil, view: nil, supervisor: false, idempotency_key: nil)
+      request(
+        uri:     'notices',
+        method:  :get,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => supervisor ? 'supervisor' : 'user'
+        },
+        params:  {
+                   page:    page,
+                   limit:   limit,
+                   keyword: keyword,
+                   view:    view
+                 }.compact
+      )
+    end
+
+    # 공지사항 단건 (GET /v1/notices/:id)
+    # @comment_by Claude
+    # @date: 26-09-29
+    # 비공개 공지는 supervisor: true 일 때만 보인다(아니면 404 POST_NOT_FOUND).
+    def notice_detail(notice_id:, supervisor: false, idempotency_key: nil)
+      request(
+        uri:     "notices/#{notice_id}",
+        method:  :get,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => supervisor ? 'supervisor' : 'user'
+        }
+      )
+    end
+
+    # 공지사항 등록 (POST /v1/notices) — supervisor 전용
+    # @comment_by Claude
+    # @date: 26-09-29
+    def notice_create(title:, content:, images: nil, is_notice: nil, is_display: nil, idempotency_key: nil)
+      request(
+        uri:     'notices',
+        method:  :post,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => 'supervisor'
+        },
+        payload: {
+                   title:      title,
+                   content:    content,
+                   images:     images,
+                   is_notice:  is_notice,
+                   is_display: is_display
+                 }.compact
+      )
+    end
+
+    # 공지사항 수정 (PUT /v1/notices/:id) — supervisor 전용
+    # @comment_by Claude
+    # @date: 26-09-29
+    # 보낸 필드만 바뀐다. images 는 보내면 목록 전체를 교체한다([] 면 모두 삭제).
+    def notice_update(notice_id:, title: nil, content: nil, images: nil, is_notice: nil, is_display: nil,
+                      idempotency_key: nil)
+      request(
+        uri:     "notices/#{notice_id}",
+        method:  :put,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => 'supervisor'
+        },
+        payload: {
+                   title:      title,
+                   content:    content,
+                   images:     images,
+                   is_notice:  is_notice,
+                   is_display: is_display
+                 }.compact
+      )
+    end
+
+    # 공지사항 삭제 (DELETE /v1/notices/:id) — supervisor 전용
+    # @comment_by Claude
+    # @date: 26-09-29
+    def notice_delete(notice_id:, idempotency_key: nil)
+      request(
+        uri:     "notices/#{notice_id}",
+        method:  :delete,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => 'supervisor'
+        }
+      )
+    end
+  end
+end

data/lib/bootpay_store/concern/payout.rb

@@ -0,0 +1,69 @@
+module BootpayStore::Concern::Payout
+  extend ActiveSupport::Concern
+
+  included do
+    # 입점사 지급 요청 등록 (POST /v1/sdk/payouts) — supervisor 전용
+    # @comment_by Claude
+    # @date: 26-11-12
+    # 가맹점 지정 금액(manual) 정산 쇼핑몰이 입점사와 지급액을 정해 지급 원장에 등록한다. 실제 송금은 부트페이 배치가 한다.
+    # 같은 merchant_payout_id 재호출은 처음 만든 항목을 돌려준다(금액·입점사·지급일은 바꿀 수 없다).
+    # payout_date: 'YYYY-MM-DD' (미지정시 오늘). 정산 방식이 manual 이 아니면 18360, PG 미등록 입점사는 18378.
+    def payout_create(sub_seller_id:, amount:, merchant_payout_id:, order_number: nil, payout_date: nil,
+                      idempotency_key: nil)
+      request(
+        uri:     'sdk/payouts',
+        method:  :post,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => 'supervisor'
+        },
+        payload: {
+                   sub_seller_id:      sub_seller_id,
+                   amount:             amount,
+                   merchant_payout_id: merchant_payout_id,
+                   order_number:       order_number,
+                   payout_date:        payout_date
+                 }.compact
+      )
+    end
+
+    # 입점사 지급 항목 조회 (GET /v1/sdk/payouts/:id) — supervisor 전용
+    # @comment_by Claude
+    # @date: 26-11-12
+    # payout_id 는 merchant_payout_id 또는 지급 항목 id. 없으면 404 PAYOUT_RESULT_INVALID(18366).
+    def payout_detail(payout_id:, idempotency_key: nil)
+      request(
+        uri:     "sdk/payouts/#{URI.encode_www_form_component(payout_id.to_s).gsub('+', '%20')}",
+        method:  :get,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => 'supervisor'
+        }
+      )
+    end
+
+    # 입점사 지급 목록 (GET /v1/sdk/payouts) — supervisor 전용
+    # @comment_by Claude
+    # @date: 26-11-12
+    # 최근 생성 순. 응답 data 는 항목 배열이다(전체 개수 없음 — 받은 수가 limit 보다 적으면 마지막 페이지).
+    # status: ready · held · sending · requested · processing · succeeded · failed · cancelled · unknown · void
+    def payouts(status: nil, sub_seller_id: nil, from: nil, to: nil, page: nil, limit: nil, idempotency_key: nil)
+      request(
+        uri:     'sdk/payouts',
+        method:  :get,
+        headers: {
+          'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
+          'Bootpay-Role'    => 'supervisor'
+        },
+        params:  {
+                   status:        status,
+                   sub_seller_id: sub_seller_id,
+                   from:          from,
+                   to:            to,
+                   page:          page,
+                   limit:         limit
+                 }.compact
+      )
+    end
+  end
+end

data/lib/bootpay_store/concern/product.rb

@@ -67,6 +67,8 @@ module BootpayStore::Concern::Product
     # @date: 26-08-14
     # images 가 있으면 multipart, 없으면 JSON 으로 보낸다.
     # 컨트롤러가 읽는 필드는 _product_params 참조 — 여기 명시하지 않은 값도 attrs 로 그대로 전달된다.
+    # @date: 26-11-02 Bootpay-Role manager → user. 서버 스코프는 user:product_create/update/delete/status 뿐이라
+    #   manager 로 보내면 manager:product_* 를 찾다 401 API_ROLE_NOT_SUPPORT(-50) 로 막혔다 (수정·삭제·상태변경도 같다)
     def product_create(name:, display_price: nil, desc: nil, content: nil, category_id: nil,
                        type: nil, stock: nil, status_sale: nil, status_display: nil,
                        use_subscription: nil, subscription_setting_id: nil,
@@ -88,7 +90,7 @@ module BootpayStore::Concern::Product
 
       headers = {
         'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
-        'Bootpay-Role'    => 'manager'
+        'Bootpay-Role'    => 'user'
       }
 
       if images.present?
@@ -104,6 +106,7 @@ module BootpayStore::Concern::Product
     # @comment_by Claude (alfred)
     # @date: 26-08-14
     # 바뀐 값만 보내면 된다. category_id 는 키 존재 여부로 '해제 의사'를 판별하므로 주의.
+    # @date: 26-11-02 Bootpay-Role manager → user (product_create 주석 참고)
     def product_update(product_id:, name: nil, display_price: nil, desc: nil, content: nil,
                        category_id: nil, stock: nil, status_sale: nil, status_display: nil,
                        save_by: nil, idempotency_key: nil, **attrs)
@@ -112,7 +115,7 @@ module BootpayStore::Concern::Product
         method:  :put,
         headers: {
           'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
-          'Bootpay-Role'    => 'manager'
+          'Bootpay-Role'    => 'user'
         },
         payload: {
                    name:           name,
@@ -131,13 +134,14 @@ module BootpayStore::Concern::Product
     # 상품을 삭제한다 (DELETE /v1/products/:id)
     # @comment_by Claude (alfred)
     # @date: 26-08-14
+    # @date: 26-11-02 Bootpay-Role manager → user (product_create 주석 참고)
     def product_delete(product_id:, idempotency_key: nil)
       request(
         uri:     "products/#{product_id}",
         method:  :delete,
         headers: {
           'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
-          'Bootpay-Role'    => 'manager'
+          'Bootpay-Role'    => 'user'
         }
       )
     end
@@ -146,6 +150,7 @@ module BootpayStore::Concern::Product
     # @comment_by Claude (alfred)
     # @date: 26-08-14
     # 컨트롤러 _status_params 기준. 재고(stock)는 여기가 아니라 product_update 로 바꾼다.
+    # @date: 26-11-02 Bootpay-Role manager → user (product_create 주석 참고)
     def product_status(product_id:, status_sale: nil, status_display: nil, status_frozen: nil,
                        status_review: nil, use_display_period: nil, display_start_at: nil, display_end_at: nil,
                        use_sale_period: nil, sale_start_at: nil, sale_end_at: nil,
@@ -155,7 +160,7 @@ module BootpayStore::Concern::Product
         method:  :put,
         headers: {
           'Idempotency-Key' => idempotency_key.presence || SecureRandom.uuid,
-          'Bootpay-Role'    => 'manager'
+          'Bootpay-Role'    => 'user'
         },
         payload: {
                    status_sale:        status_sale,