bootpay 1.1.0 → 1.2.0

data/lib/bootpay/commerce/product.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module Bootpay
+  module Commerce
+    class ProductModule
+      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[:type]          = params[:type]          unless params[:type].nil?
+        query_params[:period_type]   = params[:period_type]   if params[:period_type]
+        query_params[:s_at]          = params[:s_at]          if params[:s_at]
+        query_params[:e_at]          = params[:e_at]          if params[:e_at]
+        query_params[:category_code] = params[:category_code] if params[:category_code]
+
+        query = build_query(query_params)
+        @bootpay.get("products#{query}")
+      end
+
+      # 상품 생성 (이미지 포함)
+      def create(product, image_paths = nil)
+        @bootpay.post_multipart('products', product, image_paths)
+      end
+
+      # 상품 상세 조회
+      def detail(product_id)
+        @bootpay.get("products/#{product_id}")
+      end
+
+      # 상품 수정
+      def update(product)
+        raise ArgumentError, 'product_id is required' unless product[:product_id]
+        @bootpay.put("products/#{product[:product_id]}", product)
+      end
+
+      # 상품 상태 변경
+      def status(params)
+        raise ArgumentError, 'product_id is required' unless params[:product_id]
+        @bootpay.put("products/#{params[:product_id]}/status", params)
+      end
+
+      # 상품 삭제
+      def delete(product_id)
+        @bootpay.delete("products/#{product_id}")
+      end
+
+      private
+
+      def build_query(params)
+        return '' if params.empty?
+        "?#{URI.encode_www_form(params)}"
+      end
+    end
+  end
+end

data/lib/bootpay/commerce/store.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Bootpay
+  module Commerce
+    class StoreModule
+      def initialize(bootpay)
+        @bootpay = bootpay
+      end
+
+      # 가맹점 기본 정보 조회
+      def info
+        @bootpay.get('store')
+      end
+
+      # 가맹점 상세 정보 조회
+      def detail
+        @bootpay.get('store/detail')
+      end
+    end
+  end
+end

data/lib/bootpay/commerce/user.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module Bootpay
+  module Commerce
+    class UserModule
+      def initialize(bootpay)
+        @bootpay = bootpay
+      end
+
+      # 사용자 토큰 발급
+      def token(user_id)
+        @bootpay.post('users/login/token', { user_id: user_id })
+      end
+
+      # 회원가입
+      def join(user)
+        @bootpay.post('users/join', user)
+      end
+
+      # 중복 체크
+      def check_exist(key, value)
+        encoded_value = URI.encode_www_form_component(value)
+        @bootpay.get("users/join/#{key}?pk=#{encoded_value}")
+      end
+
+      # 본인인증 데이터 조회
+      def authentication_data(stand_id)
+        @bootpay.get("users/authenticate/#{stand_id}")
+      end
+
+      # 로그인
+      def login(login_id, login_pw)
+        @bootpay.post('users/login', { login_id: login_id, login_pw: login_pw })
+      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[:member_type] = params[:member_type] unless params[:member_type].nil?
+        query_params[:type]        = params[:type]        if params[:type]
+
+        query = build_query(query_params)
+        @bootpay.get("users#{query}")
+      end
+
+      # 사용자 상세 조회
+      def detail(user_id)
+        @bootpay.get("users/#{user_id}")
+      end
+
+      # 사용자 정보 수정
+      def update(user)
+        raise ArgumentError, 'user_id is required' unless user[:user_id]
+        @bootpay.put("users/#{user[:user_id]}", user)
+      end
+
+      # 사용자 삭제
+      def delete(user_id)
+        @bootpay.delete("users/#{user_id}")
+      end
+
+      private
+
+      def build_query(params)
+        return '' if params.empty?
+        "?#{URI.encode_www_form(params)}"
+      end
+    end
+  end
+end

data/lib/bootpay/commerce/user_group.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module Bootpay
+  module Commerce
+    class UserGroupModule
+      def initialize(bootpay)
+        @bootpay = bootpay
+      end
+
+      # 사용자 그룹 생성
+      def create(user_group)
+        @bootpay.post('user-groups', user_group)
+      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[:corporate_type] = params[:corporate_type] unless params[:corporate_type].nil?
+
+        query = build_query(query_params)
+        @bootpay.get("user-groups#{query}")
+      end
+
+      # 사용자 그룹 상세 조회
+      def detail(user_group_id)
+        @bootpay.get("user-groups/#{user_group_id}")
+      end
+
+      # 사용자 그룹 수정
+      def update(user_group)
+        raise ArgumentError, 'user_group_id is required' unless user_group[:user_group_id]
+        @bootpay.put("user-groups/#{user_group[:user_group_id]}", user_group)
+      end
+
+      # 그룹에 사용자 추가
+      def user_create(user_group_id, user_id)
+        @bootpay.post("user-groups/#{user_group_id}/user", { user_id: user_id })
+      end
+
+      # 그룹에서 사용자 제거
+      def user_delete(user_group_id, user_id)
+        @bootpay.delete("user-groups/#{user_group_id}/user/#{user_id}")
+      end
+
+      # 그룹 제한 설정
+      def limit(params)
+        raise ArgumentError, 'user_group_id is required' unless params[:user_group_id]
+        @bootpay.put("user-groups/#{params[:user_group_id]}/limit", params)
+      end
+
+      # 그룹 거래 집계
+      def aggregate_transaction(params)
+        raise ArgumentError, 'user_group_id is required' unless params[:user_group_id]
+        @bootpay.put("user-groups/#{params[:user_group_id]}/aggregate-transaction", params)
+      end
+
+      private
+
+      def build_query(params)
+        return '' if params.empty?
+        "?#{URI.encode_www_form(params)}"
+      end
+    end
+  end
+end

data/lib/bootpay/escrow.rb

@@ -11,7 +11,7 @@ module Bootpay::Escrow
     def delivery_start(receipt_id, delivery_no, delivery_corp)
       raise 'receipt_id 값을 설정해주세요.' if receipt_id.blank?
       request(
-        mode: :put,
+        method: :put,
         uri: "delivery/start/#{receipt_id}",
         payload:
           {

data/lib/bootpay/rest.rb

@@ -7,21 +7,29 @@ module Bootpay::Rest
     # HTTP Request 기본 Method
     # Comment by Gosomi
     # Date: 2021-05-21
-    def request(method: :post, uri:, payload: {}, headers: {})
+    def authorization_header
+      if @client_key.present? && @secret_key.present?
+        "Basic #{Base64.strict_encode64("#{@client_key}:#{@secret_key}")}"
+      elsif @token.present?
+        "Bearer #{@token}"
+      end
+    end
+
+    def request(method: :post, uri:, payload: {}, headers: {}, params: nil)
 
-      print([Bootpay::Api::API[@mode.to_sym], uri].join('/'))
+      http_options = { json: payload }
+      http_options[:params] = params if params && !params.empty?
 
       response = HTTP.headers(
         {
-          # Authorization: "Bearer #{@token}",
-          Authorization: "#{@token}",
+          Authorization: authorization_header,
           content_type:  'application/json',
           accept:        'application/json'
         }.merge!(headers).compact
       ).send(
         method.to_sym,
         [Bootpay::Api::API[@mode.to_sym], uri].join('/'),
-        json: payload
+        **http_options
       )
       Bootpay::Response.new(
         response.status.success?,

data/lib/bootpay/token.rb

@@ -6,6 +6,13 @@ module Bootpay::Token
     # Comment by Gosomi
     # Date: 2021-05-21
     def request_access_token
+      # client_key/secret_key 인증은 매 요청에 Basic Auth 헤더가 자동 부착된다.
+      # request/token 호출이 불필요하므로 합성 응답을 즉시 반환한다.
+      if @client_key.present? && @secret_key.present?
+        @token = nil
+        return Bootpay::Response.new(true, { access_token: '', expire_in: 0 })
+      end
+
       response = request(
         uri:     'request/token',
         payload: {
@@ -13,8 +20,14 @@ module Bootpay::Token
           private_key:    @private_key
         }
       )
-      @token   = response.data[:data][:token] if response.success?
+      if response.success?
+        # 기존 Ruby PG 응답(data.token)을 우선 유지하되, 다른 SDK/신규 응답(access_token)도
+        # 받을 수 있게 확장한다. 기존 응답 구조와 token 값에는 영향을 주지 않는다.
+        @token = response.data.dig(:data, :token)
+        @token ||= response.data[:access_token]
+        @token ||= response.data.dig(:data, :access_token)
+      end
       response
-    end  
+    end
   end
-end
+end

data/lib/bootpay/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Bootpay
-  VERSION  = "1.1.0"
+  VERSION  = "1.2.0"
   BANKCODE = {
     "한국은행"    => "001",
     "기업은행"    => "003",

data/lib/bootpay/wallet.rb

@@ -0,0 +1,56 @@
+module Bootpay::Wallet
+  extend ActiveSupport::Concern
+
+  included do
+    # 사용자 월렛 목록 조회
+    # Reference: Go SDK GetUserWallets
+    #
+    # @deprecated 다음 메이저 버전에서 제거 예정. wallet 엔드포인트는 폐기 예정이며,
+    #   결제는 Request::PaymentController#create 의 wallet_id + user_token 으로 처리됩니다.
+    def get_user_wallets(user_id:, sandbox: false)
+      warn '[DEPRECATION] `get_user_wallets` is deprecated and will be removed in a future major version.'
+      raise 'user_id 값을 입력해주세요.' if user_id.blank?
+
+      request(
+        method: :get,
+        uri: "wallet?user_id=#{user_id}&sandbox=#{sandbox}"
+      )
+    end
+
+    # 월렛 결제 요청
+    # Reference: Go SDK RequestWalletPayment
+    #
+    # @deprecated 다음 메이저 버전에서 제거 예정. wallet 엔드포인트는 폐기 예정이며,
+    #   결제는 wallet_id + user_token 흐름으로 전환하세요.
+    def request_wallet_payment(user_id:, order_name:, price:, order_id:, tax_free: 0, sandbox: false,
+                               webhook_url: nil, content_type: nil,
+                               items: nil,
+                               user_info: nil,
+                               extra: nil,
+                               metadata: nil)
+      warn '[DEPRECATION] `request_wallet_payment` is deprecated and will be removed in a future major version.'
+      raise 'user_id 값을 입력해주세요.' if user_id.blank?
+      raise 'order_name 값을 입력해주세요.' if order_name.blank?
+      raise 'price 금액을 설정해주세요.' if price.blank?
+      raise 'order_id 주문번호를 설정해주세요.' if order_id.blank?
+
+      request(
+        uri: 'wallet/payment',
+        payload: {
+          user_id:      user_id,
+          order_name:   order_name,
+          price:        price,
+          tax_free:     tax_free,
+          order_id:     order_id,
+          sandbox:      sandbox,
+          webhook_url:  webhook_url,
+          content_type: content_type,
+          items:        items,
+          user:         user_info,
+          extra:        extra,
+          metadata:     metadata
+        }.compact
+      )
+    end
+  end
+end

data/lib/bootpay.rb

@@ -1,8 +1,12 @@
 require 'active_support/all'
+require 'base64'
 require 'http'
 require_relative 'response'
+require_relative 'bootpay/authentication'
+require_relative 'bootpay/automatic_transfer'
 require_relative 'bootpay/billing'
 require_relative 'bootpay/cancel'
+require_relative 'bootpay/cash_receipt'
 require_relative 'bootpay/easy'
 require_relative 'bootpay/escrow'
 require_relative 'bootpay/link'
@@ -14,11 +18,15 @@ require_relative 'bootpay/submit'
 require_relative 'bootpay/token'
 require_relative 'bootpay/verification'
 require_relative "bootpay/version"
+require_relative 'bootpay/wallet'
 
 module Bootpay
   class Api
+    include Authentication
+    include AutomaticTransfer
     include Billing
     include Cancel
+    include CashReceipt
     include Easy
     include Escrow
     include Link
@@ -29,22 +37,30 @@ module Bootpay
     include Submit
     include Token
     include Verification
+    include Wallet
 
     API =
       {
-        development: 'https://dev-api.bootpay.co.kr',
-        stage:       'https://stage-api.bootpay.co.kr',
-        production:  'https://api.bootpay.co.kr',
+        development: 'https://dev-api.bootpay.co.kr/v2',
+        stage:       'https://stage-api.bootpay.co.kr/v2',
+        production:  'https://api.bootpay.co.kr/v2',
         ehowlsla:    'https://ehowlsla.bootpay.co.kr/api/v2'
       }.freeze
 
-    def initialize(application_id:, private_key:, mode: 'production')
-    
+    def initialize(application_id: nil, private_key: nil, client_key: nil, secret_key: nil, mode: 'production')
       @application_id = application_id
       @private_key    = private_key
+      @client_key     = client_key
+      @secret_key     = secret_key
       @mode           = mode.presence || 'production'
       @token          = nil
+
       raise ArgumentError, "개발환경 mode는 development, stage, production 중에서 선택이 가능합니다." if API[@mode.to_sym].blank?
+      if @client_key.present?
+        raise ArgumentError, 'secret_key 값이 비어있습니다.' if @secret_key.blank?
+      elsif @application_id.blank? || @private_key.blank?
+        raise ArgumentError, 'application_id/private_key 또는 client_key/secret_key를 입력해주세요.'
+      end
     end 
   end
 end

data/lib/bootpay_commerce.rb

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+require_relative 'bootpay/commerce/commerce_resource'
+require_relative 'bootpay/commerce/user'
+require_relative 'bootpay/commerce/user_group'
+require_relative 'bootpay/commerce/product'
+require_relative 'bootpay/commerce/invoice'
+require_relative 'bootpay/commerce/order'
+require_relative 'bootpay/commerce/order_cancel'
+require_relative 'bootpay/commerce/order_subscription'
+require_relative 'bootpay/commerce/order_subscription_bill'
+require_relative 'bootpay/commerce/order_subscription_adjustment'
+require_relative 'bootpay/commerce/order_subscription_request'
+require_relative 'bootpay/commerce/store'
+require_relative 'bootpay/commerce/category'
+require_relative 'bootpay/commerce/coupon'
+require_relative 'bootpay/commerce/point'
+require_relative 'bootpay/commerce/cart'
+
+module Bootpay
+  module Commerce
+    # Bootpay Commerce API 클라이언트
+    #
+    # 사용 예시:
+    #   commerce = Bootpay::Commerce::Api.new(
+    #     client_key: 'your_client_key',
+    #     secret_key: 'your_secret_key',
+    #     mode: 'production'
+    #   )
+    #
+    #   # 액세스 토큰 발급
+    #   token_response = commerce.get_access_token
+    #
+    #   # Role 설정 (메서드 체이닝 지원)
+    #   commerce.as_manager
+    #
+    #   # 사용자 목록 조회
+    #   users = commerce.user.list(page: 1, limit: 10)
+    #
+    #   # 상품 생성 (이미지 포함)
+    #   product = commerce.product.create({ name: '상품명', price: 10000 }, ['/path/to/image.jpg'])
+    #
+    class Api < CommerceResource
+      attr_reader :user, :user_group, :product, :invoice, :order,
+                  :order_cancel, :order_subscription, :order_subscription_bill,
+                  :order_subscription_adjustment, :order_subscription_request,
+                  :store, :category, :coupon, :point, :cart
+
+      def initialize(client_key: nil, secret_key: nil, mode: 'production')
+        super()
+        if client_key && secret_key
+          set_configuration(client_key: client_key, secret_key: secret_key, mode: mode)
+        end
+        init_modules
+      end
+
+      # 액세스 토큰 발급
+      # client_key/secret_key로 Basic Auth 인증
+      def get_access_token
+        response = post_with_basic_auth('request/token', {
+          client_key: @client_key,
+          secret_key: @secret_key
+        })
+
+        if response.is_a?(Hash) && response[:access_token]
+          set_token(response[:access_token])
+        end
+
+        response
+      end
+
+      # 토큰을 발급받아 설정 (메서드 체이닝)
+      def with_token
+        get_access_token
+        self
+      end
+
+      # 현재 설정된 토큰 반환
+      def current_token
+        get_token
+      end
+
+      # 토큰이 설정되어 있는지 확인
+      def has_token?
+        token = get_token
+        !token.nil? && !token.empty?
+      end
+
+      # Role 설정 (메서드 체이닝)
+      def with_role(role)
+        set_role(role)
+        self
+      end
+
+      # 일반 사용자 role로 설정
+      def as_user
+        with_role('user')
+      end
+
+      # 매니저 role로 설정
+      def as_manager
+        with_role('manager')
+      end
+
+      # 파트너 role로 설정
+      def as_partner
+        with_role('partner')
+      end
+
+      # 벤더 role로 설정
+      def as_vendor
+        with_role('vendor')
+      end
+
+      # 슈퍼바이저 role로 설정
+      def as_supervisor
+        with_role('supervisor')
+      end
+
+      # 현재 role 반환
+      def current_role
+        get_role
+      end
+
+      # role을 기본값(user)으로 초기화
+      def clear_role
+        set_role('user')
+        self
+      end
+
+      private
+
+      def init_modules
+        @user                            = UserModule.new(self)
+        @user_group                      = UserGroupModule.new(self)
+        @product                         = ProductModule.new(self)
+        @invoice                         = InvoiceModule.new(self)
+        @order                           = OrderModule.new(self)
+        @order_cancel                    = OrderCancelModule.new(self)
+        @order_subscription              = OrderSubscriptionModule.new(self)
+        @order_subscription_bill         = OrderSubscriptionBillModule.new(self)
+        @order_subscription_adjustment   = OrderSubscriptionAdjustmentModule.new(self)
+        @order_subscription_request      = OrderSubscriptionRequestModule.new(self)
+        @store                           = StoreModule.new(self)
+        @category                        = CategoryModule.new(self)
+        @coupon                          = CouponModule.new(self)
+        @point                           = PointModule.new(self)
+        @cart                            = CartModule.new(self)
+      end
+    end
+  end
+end

metadata

@@ -1,29 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: bootpay
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - bootpay
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-02-28 00:00:00.000000000 Z
+date: 2026-05-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: http
   requirement: !ruby/object:Gem::Requirement
@@ -46,6 +46,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".DS_Store"
+- ".env.example"
 - ".gitignore"
 - ".rspec"
 - CHANGELOG.md
@@ -60,8 +61,27 @@ files:
 - lib/.DS_Store
 - lib/bootpay.rb
 - lib/bootpay/.DS_Store
+- lib/bootpay/authentication.rb
+- lib/bootpay/automatic_transfer.rb
 - lib/bootpay/billing.rb
 - lib/bootpay/cancel.rb
+- lib/bootpay/cash_receipt.rb
+- lib/bootpay/commerce/cart.rb
+- lib/bootpay/commerce/category.rb
+- lib/bootpay/commerce/commerce_resource.rb
+- lib/bootpay/commerce/coupon.rb
+- lib/bootpay/commerce/invoice.rb
+- lib/bootpay/commerce/order.rb
+- lib/bootpay/commerce/order_cancel.rb
+- lib/bootpay/commerce/order_subscription.rb
+- lib/bootpay/commerce/order_subscription_adjustment.rb
+- lib/bootpay/commerce/order_subscription_bill.rb
+- lib/bootpay/commerce/order_subscription_request.rb
+- lib/bootpay/commerce/point.rb
+- lib/bootpay/commerce/product.rb
+- lib/bootpay/commerce/store.rb
+- lib/bootpay/commerce/user.rb
+- lib/bootpay/commerce/user_group.rb
 - lib/bootpay/easy.rb
 - lib/bootpay/escrow.rb
 - lib/bootpay/link.rb
@@ -73,6 +93,8 @@ files:
 - lib/bootpay/token.rb
 - lib/bootpay/verification.rb
 - lib/bootpay/version.rb
+- lib/bootpay/wallet.rb
+- lib/bootpay_commerce.rb
 - lib/response.rb
 homepage: http://www.bootpay.co.kr
 licenses:
@@ -94,7 +116,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.19
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: Bootpay server side plugin for ruby