bootpay 1.1.0 → 1.2.0

data/lib/bootpay/commerce/commerce_resource.rb

@@ -0,0 +1,196 @@
+# frozen_string_literal: true
+
+require 'http'
+require 'base64'
+require 'json'
+
+module Bootpay
+  module Commerce
+    class CommerceResource
+      API_ENTRYPOINTS = {
+        'development' => 'https://dev-api.bootapi.com/v1',
+        'stage'       => 'https://stage-api.bootapi.com/v1',
+        'production'  => 'https://api.bootapi.com/v1'
+      }.freeze
+
+      API_VERSION = '1.0.0'
+      SDK_VERSION = '1.0.0'
+      SDK_TYPE    = '305' # Ruby
+
+      attr_reader :client_key, :secret_key, :mode
+
+      def initialize
+        @mode       = 'production'
+        @token      = nil
+        @role       = 'user'
+        @client_key = nil
+        @secret_key = nil
+        @timeout    = 60
+      end
+
+      def set_configuration(client_key:, secret_key:, mode: 'production')
+        @client_key = client_key
+        @secret_key = secret_key
+        @mode       = mode || 'production'
+        raise ArgumentError, "mode는 development, stage, production 중에서 선택이 가능합니다." unless API_ENTRYPOINTS.key?(@mode)
+      end
+
+      def set_token(token)
+        @token = token
+      end
+
+      def get_token
+        @token
+      end
+
+      def set_role(role)
+        @role = role
+      end
+
+      def get_role
+        @role || 'user'
+      end
+
+      # GET request
+      def get(url, params = nil)
+        full_url = entrypoint(url)
+        response = HTTP.headers(default_headers)
+                       .timeout(@timeout)
+                       .get(full_url, params: params)
+        parse_response(response)
+      rescue StandardError => e
+        error_response(e)
+      end
+
+      # POST request with JSON body
+      def post(url, data = nil)
+        full_url = entrypoint(url)
+        response = HTTP.headers(default_headers)
+                       .timeout(@timeout)
+                       .post(full_url, json: data || {})
+        parse_response(response)
+      rescue StandardError => e
+        error_response(e)
+      end
+
+      # POST with Basic Auth (for token endpoint)
+      def post_with_basic_auth(url, data = nil)
+        headers = default_headers(include_auth: false)
+        headers['Authorization'] = basic_auth_header
+        full_url = entrypoint(url)
+        response = HTTP.headers(headers)
+                       .timeout(@timeout)
+                       .post(full_url, json: data || {})
+        parse_response(response)
+      rescue StandardError => e
+        error_response(e)
+      end
+
+      # POST multipart/form-data (for product images)
+      def post_multipart(url, data = {}, image_paths = nil)
+        headers = multipart_headers
+        full_url = entrypoint(url)
+
+        form_data = {}
+        data.each do |key, value|
+          next if value.nil?
+          if value.is_a?(Hash) || value.is_a?(Array)
+            form_data[key.to_s] = JSON.generate(value)
+          else
+            form_data[key.to_s] = value.to_s
+          end
+        end
+
+        if image_paths && !image_paths.empty?
+          files = image_paths.map do |path|
+            HTTP::FormData::File.new(path)
+          end
+          form_data['images'] = files.length == 1 ? files.first : files
+        end
+
+        form = HTTP::FormData::Multipart.new(form_data)
+        response = HTTP.headers(headers)
+                       .timeout(@timeout)
+                       .post(full_url, form: form)
+        parse_response(response)
+      rescue StandardError => e
+        error_response(e)
+      end
+
+      # PUT request
+      def put(url, data = nil)
+        full_url = entrypoint(url)
+        response = HTTP.headers(default_headers)
+                       .timeout(@timeout)
+                       .put(full_url, json: data || {})
+        parse_response(response)
+      rescue StandardError => e
+        error_response(e)
+      end
+
+      # DELETE request
+      def delete(url, params = nil)
+        full_url = entrypoint(url)
+        response = HTTP.headers(default_headers)
+                       .timeout(@timeout)
+                       .delete(full_url, params: params)
+        parse_response(response)
+      rescue StandardError => e
+        error_response(e)
+      end
+
+      private
+
+      def entrypoint(url)
+        "#{API_ENTRYPOINTS[@mode]}/#{url}"
+      end
+
+      def basic_auth_header
+        return '' unless @client_key && @secret_key
+        credentials = Base64.strict_encode64("#{@client_key}:#{@secret_key}")
+        "Basic #{credentials}"
+      end
+
+      def default_headers(include_auth: true)
+        headers = {
+          'Content-Type'         => 'application/json',
+          'Accept'               => 'application/json',
+          'Accept-Charset'       => 'utf-8',
+          'BOOTPAY-SDK-VERSION'  => SDK_VERSION,
+          'BOOTPAY-API-VERSION'  => API_VERSION,
+          'BOOTPAY-SDK-TYPE'     => SDK_TYPE,
+          'BOOTPAY-ROLE'         => @role || 'user'
+        }
+        if include_auth
+          basic = basic_auth_header
+          headers['Authorization'] = basic unless basic.empty?
+        end
+        headers
+      end
+
+      def multipart_headers
+        headers = {
+          'Accept'               => 'application/json',
+          'Accept-Charset'       => 'utf-8',
+          'BOOTPAY-SDK-VERSION'  => SDK_VERSION,
+          'BOOTPAY-API-VERSION'  => API_VERSION,
+          'BOOTPAY-SDK-TYPE'     => SDK_TYPE,
+          'BOOTPAY-ROLE'         => @role || 'user'
+        }
+        basic = basic_auth_header
+        headers['Authorization'] = basic unless basic.empty?
+        headers
+      end
+
+      def parse_response(response)
+        JSON.parse(response.body.to_s, symbolize_names: true)
+      rescue JSON::ParserError
+        { success: false, message: 'Invalid JSON response' }
+      end
+
+      def error_response(error)
+        { success: false, message: "Commerce API 서버와의 통신이 실패하였습니다. 오류: #{error.message}" }
+      end
+    end
+  end
+end

data/lib/bootpay/commerce/coupon.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module Bootpay
+  module Commerce
+    class CouponModule
+      def initialize(bootpay)
+        @bootpay = bootpay
+      end
+
+      # 사용자 보유 쿠폰 목록
+      def list(params = {})
+        query_params = {}
+        query_params[:status] = params[:status] if params[:status]
+        query_params[:page]   = params[:page]   unless params[:page].nil?
+        query_params[:limit]  = params[:limit]  unless params[:limit].nil?
+
+        query = build_query(query_params)
+        @bootpay.get("coupon#{query}")
+      end
+
+      # 다운로드 가능한 쿠폰 목록
+      def available
+        @bootpay.get('coupon/available')
+      end
+
+      # 쿠폰 다운로드 (issue_from_template)
+      def download(params)
+        @bootpay.post('coupon/download', params)
+      end
+
+      private
+
+      def build_query(params)
+        return '' if params.empty?
+        "?#{URI.encode_www_form(params)}"
+      end
+    end
+  end
+end

data/lib/bootpay/commerce/invoice.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module Bootpay
+  module Commerce
+    class InvoiceModule
+      def initialize(bootpay)
+        @bootpay = bootpay
+      end
+
+      # 청구서 목록 조회
+      def list(params = {})
+        query_params = {}
+        query_params[:page]    = params[:page]    unless params[:page].nil?
+        query_params[:limit]   = params[:limit]   unless params[:limit].nil?
+        query_params[:keyword] = params[:keyword] if params[:keyword]
+
+        query = build_query(query_params)
+        @bootpay.get("invoices#{query}")
+      end
+
+      # 청구서 생성
+      def create(invoice)
+        @bootpay.post('invoices', invoice)
+      end
+
+      # 청구서 알림 발송
+      def notify(invoice_id, send_types)
+        @bootpay.post("invoices/#{invoice_id}/notify", { send_types: send_types })
+      end
+
+      # 청구서 상세 조회
+      def detail(invoice_id)
+        @bootpay.get("invoices/#{invoice_id}")
+      end
+
+      private
+
+      def build_query(params)
+        return '' if params.empty?
+        "?#{URI.encode_www_form(params)}"
+      end
+    end
+  end
+end

data/lib/bootpay/commerce/order.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module Bootpay
+  module Commerce
+    class OrderModule
+      def initialize(bootpay)
+        @bootpay = bootpay
+      end
+
+      # 주문 목록 조회
+      def list(params = {})
+        query_params = {}
+        query_params[:page]                     = params[:page]                     unless params[:page].nil?
+        query_params[:limit]                    = params[:limit]                    unless params[:limit].nil?
+        query_params[:keyword]                  = params[:keyword]                  if params[:keyword]
+        query_params[:user_id]                  = params[:user_id]                  if params[:user_id]
+        query_params[:user_group_id]            = params[:user_group_id]            if params[:user_group_id]
+        query_params[:cs_type]                  = params[:cs_type]                  if params[:cs_type]
+        query_params[:css_at]                   = params[:css_at]                   if params[:css_at]
+        query_params[:cse_at]                   = params[:cse_at]                   if params[:cse_at]
+        query_params[:subscription_billing_type] = params[:subscription_billing_type] unless params[:subscription_billing_type].nil?
+
+        if params[:status].is_a?(Array) && !params[:status].empty?
+          query_params[:status] = params[:status].map(&:to_s).join(',')
+        end
+        if params[:payment_status].is_a?(Array) && !params[:payment_status].empty?
+          query_params[:payment_status] = params[:payment_status].map(&:to_s).join(',')
+        end
+        if params[:order_subscription_ids].is_a?(Array) && !params[:order_subscription_ids].empty?
+          query_params[:order_subscription_ids] = params[:order_subscription_ids].join(',')
+        end
+
+        query = build_query(query_params)
+        @bootpay.get("orders#{query}")
+      end
+
+      # 주문 상세 조회
+      def detail(order_id)
+        @bootpay.get("orders/#{order_id}")
+      end
+
+      # 월별 주문 조회
+      def month(user_group_id, search_date)
+        query_params = {
+          user_group_id: user_group_id,
+          search_date:   search_date
+        }
+        @bootpay.get("orders/month?#{URI.encode_www_form(query_params)}")
+      end
+
+      private
+
+      def build_query(params)
+        return '' if params.empty?
+        "?#{URI.encode_www_form(params)}"
+      end
+    end
+  end
+end

data/lib/bootpay/commerce/order_cancel.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module Bootpay
+  module Commerce
+    class OrderCancelModule
+      def initialize(bootpay)
+        @bootpay = bootpay
+      end
+
+      # 취소 요청 목록 조회
+      def list(params = {})
+        query_params = {}
+        query_params[:order_id]     = params[:order_id]     if params[:order_id]
+        query_params[:order_number] = params[:order_number] if params[:order_number]
+
+        query = build_query(query_params)
+        @bootpay.get("order/cancel#{query}")
+      end
+
+      # 취소 요청
+      def request(params)
+        @bootpay.post('order/cancel', params)
+      end
+
+      # 취소 요청 철회
+      def withdraw(order_cancel_request_history_id)
+        @bootpay.put("order/cancel/#{order_cancel_request_history_id}/withdraw", {})
+      end
+
+      # 취소 승인
+      def approve(params)
+        raise ArgumentError, 'order_cancel_request_history_id is required' unless params[:order_cancel_request_history_id]
+        @bootpay.put("order/cancel/#{params[:order_cancel_request_history_id]}/approve", params)
+      end
+
+      # 취소 거절
+      def reject(params)
+        raise ArgumentError, 'order_cancel_request_history_id is required' unless params[:order_cancel_request_history_id]
+        @bootpay.put("order/cancel/#{params[:order_cancel_request_history_id]}/reject", params)
+      end
+
+      private
+
+      def build_query(params)
+        return '' if params.empty?
+        "?#{URI.encode_www_form(params)}"
+      end
+    end
+  end
+end

data/lib/bootpay/commerce/order_subscription.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module Bootpay
+  module Commerce
+    # 정기구독 진행 중 요청 모듈
+    class OrderSubscriptionRequestIngModule
+      def initialize(bootpay)
+        @bootpay = bootpay
+      end
+
+      # 정기구독 일시정지
+      def pause(params)
+        @bootpay.post('order_subscriptions/requests/ing/pause', params)
+      end
+
+      # 정기구독 재개
+      def resume(params)
+        @bootpay.put('order_subscriptions/requests/ing/resume', params)
+      end
+
+      # 해지 수수료 계산
+      def calculate_termination_fee(order_subscription_id: nil, order_number: nil)
+        raise ArgumentError, 'order_subscription_id or order_number is required' if order_subscription_id.nil? && order_number.nil?
+
+        query_params = {}
+        if order_subscription_id
+          query_params[:order_subscription_id] = order_subscription_id
+        elsif order_number
+          query_params[:order_number] = order_number
+        end
+
+        @bootpay.get("order_subscriptions/requests/ing/calculate_termination_fee?#{URI.encode_www_form(query_params)}")
+      end
+
+      # 주문번호로 해지 수수료 계산
+      def calculate_termination_fee_by_order_number(order_number)
+        calculate_termination_fee(order_number: order_number)
+      end
+
+      # 정기구독 해지
+      def termination(params)
+        @bootpay.post('order_subscriptions/requests/ing/termination', params)
+      end
+    end
+
+    # 정기구독 모듈
+    class OrderSubscriptionModule
+      attr_reader :request_ing
+
+      def initialize(bootpay)
+        @bootpay     = bootpay
+        @request_ing = OrderSubscriptionRequestIngModule.new(bootpay)
+      end
+
+      # 정기구독 목록 조회
+      def list(params = {})
+        query_params = {}
+        query_params[:page]          = params[:page]          unless params[:page].nil?
+        query_params[:limit]         = params[:limit]         unless params[:limit].nil?
+        query_params[:keyword]       = params[:keyword]       if params[:keyword]
+        query_params[:s_at]          = params[:s_at]          if params[:s_at]
+        query_params[:e_at]          = params[:e_at]          if params[:e_at]
+        query_params[:request_type]  = params[:request_type]  if params[:request_type]
+        query_params[:user_group_id] = params[:user_group_id] if params[:user_group_id]
+        query_params[:user_id]       = params[:user_id]       if params[:user_id]
+
+        query = build_query(query_params)
+        @bootpay.get("order_subscriptions#{query}")
+      end
+
+      # 정기구독 상세 조회
+      def detail(order_subscription_id)
+        @bootpay.get("order_subscriptions/#{order_subscription_id}")
+      end
+
+      # 정기구독 수정
+      def update(params)
+        raise ArgumentError, 'order_subscription_id is required' unless params[:order_subscription_id]
+        @bootpay.put("order_subscriptions/#{params[:order_subscription_id]}", params)
+      end
+
+      # Supervisor: 정기구독 승인
+      def supervisor_approve(order_subscription_id, params = {})
+        @bootpay.put("order_subscriptions/#{order_subscription_id}/approve", params)
+      end
+
+      # Supervisor: 정기구독 거절
+      def supervisor_reject(order_subscription_id, params = {})
+        @bootpay.put("order_subscriptions/#{order_subscription_id}/reject", params)
+      end
+
+      # Supervisor: 정기구독 해지
+      def supervisor_terminate(order_subscription_id, params = {})
+        @bootpay.put("order_subscriptions/#{order_subscription_id}/terminate", params)
+      end
+
+      # Supervisor: 정기구독 일시정지
+      def supervisor_pause(order_subscription_id, params)
+        @bootpay.put("order_subscriptions/#{order_subscription_id}/pause", params)
+      end
+
+      # Supervisor: 정기구독 재개
+      def supervisor_resume(order_subscription_id, params = {})
+        @bootpay.put("order_subscriptions/#{order_subscription_id}/resume", params)
+      end
+
+      private
+
+      def build_query(params)
+        return '' if params.empty?
+        "?#{URI.encode_www_form(params)}"
+      end
+    end
+  end
+end

data/lib/bootpay/commerce/order_subscription_adjustment.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Bootpay
+  module Commerce
+    class OrderSubscriptionAdjustmentModule
+      def initialize(bootpay)
+        @bootpay = bootpay
+      end
+
+      # 정기구독 조정 생성
+      def create(order_subscription_id, adjustment)
+        @bootpay.post("order_subscriptions/#{order_subscription_id}/adjustments", adjustment)
+      end
+
+      # 정기구독 조정 수정
+      def update(params)
+        raise ArgumentError, 'order_subscription_id is required' unless params[:order_subscription_id]
+        @bootpay.put("order_subscriptions/#{params[:order_subscription_id]}/adjustments", params)
+      end
+
+      # 정기구독 조정 삭제
+      def delete(order_subscription_id, order_subscription_adjustment_id)
+        @bootpay.delete(
+          "order_subscriptions/#{order_subscription_id}/adjustments?order_subscription_adjustment_id=#{order_subscription_adjustment_id}"
+        )
+      end
+    end
+  end
+end

data/lib/bootpay/commerce/order_subscription_bill.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module Bootpay
+  module Commerce
+    class OrderSubscriptionBillModule
+      def initialize(bootpay)
+        @bootpay = bootpay
+      end
+
+      # 정기구독 청구 목록 조회
+      def list(params = {})
+        query_params = {}
+        query_params[:page]                    = params[:page]                    unless params[:page].nil?
+        query_params[:limit]                   = params[:limit]                   unless params[:limit].nil?
+        query_params[:keyword]                 = params[:keyword]                 if params[:keyword]
+        query_params[:order_subscription_id]   = params[:order_subscription_id]   if params[:order_subscription_id]
+
+        if params[:status].is_a?(Array) && !params[:status].empty?
+          query_params[:status] = params[:status].map(&:to_s).join(',')
+        end
+
+        query = build_query(query_params)
+        @bootpay.get("order_subscription_bills#{query}")
+      end
+
+      # 정기구독 청구 상세 조회
+      def detail(order_subscription_bill_id)
+        @bootpay.get("order_subscription_bills/#{order_subscription_bill_id}")
+      end
+
+      # 정기구독 청구 수정
+      def update(order_subscription_bill)
+        raise ArgumentError, 'order_subscription_bill_id is required' unless order_subscription_bill[:order_subscription_bill_id]
+        @bootpay.put(
+          "order_subscription_bills/#{order_subscription_bill[:order_subscription_bill_id]}",
+          order_subscription_bill
+        )
+      end
+
+      private
+
+      def build_query(params)
+        return '' if params.empty?
+        "?#{URI.encode_www_form(params)}"
+      end
+    end
+  end
+end

data/lib/bootpay/commerce/order_subscription_request.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module Bootpay
+  module Commerce
+    # V1 OrderSubscription Request 조회/승인 모듈
+    #
+    # 본인 모드 (user role): project_id 없이 호출 → 본인 요청 목록/단건
+    # 슈퍼바이저 모드 (supervisor role): project_id 포함 → 프로젝트 전체 + update (승인/거절)
+    #
+    # 구매자측 요청 생성 (pause/resume/termination 등) 은
+    # `commerce.order_subscription.request_ing.*` 모듈을 사용한다.
+    class OrderSubscriptionRequestModule
+      def initialize(bootpay)
+        @bootpay = bootpay
+      end
+
+      # 요청 목록 조회 (user / supervisor 공용)
+      def list(params = {})
+        query_params = {}
+        query_params[:project_id]   = params[:project_id]   if params[:project_id]
+        query_params[:page]         = params[:page]         unless params[:page].nil?
+        query_params[:limit]        = params[:limit]        unless params[:limit].nil?
+        query_params[:request_type] = params[:request_type] unless params[:request_type].nil?
+        query_params[:status]       = params[:status]       unless params[:status].nil?
+        query_params[:s_at]         = params[:s_at]         if params[:s_at]
+        query_params[:e_at]         = params[:e_at]         if params[:e_at]
+        query_params[:keyword]      = params[:keyword]      if params[:keyword]
+
+        query = build_query(query_params)
+        @bootpay.get("order-subscription-requests#{query}")
+      end
+
+      # 요청 단건 조회 (user / supervisor 공용)
+      def detail(order_subscription_request_history_id, project_id: nil)
+        query_params = {}
+        query_params[:project_id] = project_id if project_id
+
+        query = build_query(query_params)
+        @bootpay.get("order-subscription-requests/#{order_subscription_request_history_id}#{query}")
+      end
+
+      # 요청 승인/거절 (supervisor 전용)
+      def update(params)
+        raise ArgumentError, 'order_subscription_request_history_id is required' unless params[:order_subscription_request_history_id]
+        history_id = params[:order_subscription_request_history_id]
+        body = params.reject { |k, _| k == :order_subscription_request_history_id }
+        @bootpay.put("order-subscription-requests/#{history_id}", body)
+      end
+
+      private
+
+      def build_query(params)
+        return '' if params.empty?
+        "?#{URI.encode_www_form(params)}"
+      end
+    end
+  end
+end

data/lib/bootpay/commerce/point.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module Bootpay
+  module Commerce
+    class PointModule
+      def initialize(bootpay)
+        @bootpay = bootpay
+      end
+
+      # 적립금 잔액 조회
+      def balance
+        @bootpay.get('point/balance')
+      end
+
+      # 적립금 내역 조회
+      def transactions(params = {})
+        query_params = {}
+        query_params[:page]             = params[:page]             unless params[:page].nil?
+        query_params[:limit]            = params[:limit]            unless params[:limit].nil?
+        query_params[:transaction_type] = params[:transaction_type] unless params[:transaction_type].nil?
+
+        query = build_query(query_params)
+        @bootpay.get("point/transactions#{query}")
+      end
+
+      private
+
+      def build_query(params)
+        return '' if params.empty?
+        "?#{URI.encode_www_form(params)}"
+      end
+    end
+  end
+end