bootpay 1.1.0 → 3.0.0

data/lib/bootpay/concern/subscription.rb

@@ -0,0 +1,211 @@
+module Bootpay::Concern::Subscription
+  extend ActiveSupport::Concern
+
+  included do
+    # 헤당 결제건의 빌링키 가져오기
+    # Comment by Gosomi
+    # Date: 2021-11-01
+    def lookup_subscribe_billing_key(receipt_id)
+      request(
+        method: :get,
+        uri:    "subscribe/billing_key/#{receipt_id}"
+      )
+    end
+
+    # 빌링키로 결제 요청하기
+    # Comment by ehowlsla
+    # Date: 2024-05-29
+    def request_subscribe_payment(wallet_key: nil, billing_key: nil, order_name:, price:, tax_free: 0, card_quota: '00', feedback_url: nil, content_type: nil,
+                                  card_interest: nil, order_id:, items: [], user: {}, extra: {}, metadata: {})
+      request(
+        uri:     'subscribe/payment',
+        payload: {
+          wallet_key:    wallet_key,
+          billing_key:   billing_key,
+          metadata:      metadata,
+          order_name:    order_name,
+          price:         price,
+          tax_free:      tax_free,
+          card_quota:    card_quota,
+          card_interest: card_interest,
+          order_id:      order_id,
+          items:         items,
+          user:          user,
+          extra:         extra,
+          feedback_url:  feedback_url,
+          content_type:  content_type
+        }
+      )
+    end
+
+    # 자동결제 예약
+    # Comment by Gosomi
+    # Date: 2022-04-21
+    def subscribe_payment_reserve(billing_key:, reserve_execute_at:, order_name:, price:, tax_free: 0, items: nil, order_id:,
+                                  metadata: {}, user: nil, feedback_url: nil, content_type: nil)
+      request(
+        uri:     'subscribe/payment/reserve',
+        payload: {
+          billing_key:        billing_key,
+          reserve_execute_at: reserve_execute_at,
+          order_name:         order_name,
+          order_id:           order_id,
+          metadata:           metadata,
+          price:              price,
+          tax_free:           tax_free,
+          items:              items,
+          user:               user,
+          feedback_url:       feedback_url,
+          content_type:       content_type
+        }
+      )
+    end
+
+    # 예약결제 조회 기능
+    # Comment by Gosomi
+    # Date: 2023-03-08
+    def subscribe_payment_reserve_lookup(reserve_id)
+      request(
+        method: :get,
+        uri:    "subscribe/payment/reserve/#{reserve_id}"
+      )
+    end
+
+    # 자동결제 조회하기
+    # Comment by Gosomi
+    # Date: 2023-02-24
+    def subscribe_lookup(reserve_id)
+      request(
+        method: :get,
+        uri:    "subscribe/payment/reserve/#{reserve_id}"
+      )
+    end
+
+    # 자동결제 예약 취소
+    # Comment by Gosomi
+    # Date: 2022-04-21
+    def cancel_subscribe_reserve(reserve_id)
+      request(
+        method: :delete,
+        uri:    "subscribe/payment/reserve/#{reserve_id}"
+      )
+    end
+
+    # 빌링키를 강제로 만료한다
+    # Comment by Gosomi
+    # Date: 2021-11-04
+    def destroy_billing_key(billing_key)
+      request(
+        method: :delete,
+        uri:    "subscribe/billing_key/#{billing_key}"
+      )
+    end
+
+    # 빌링키 발급받기
+    # Comment by Gosomi
+    # Date: 2021-11-04
+    def request_subscribe_billing_key(pg:, order_name:, price: nil, tax_free: nil, subscription_id:, card_no:, card_pw:,
+                                      card_identity_no:, card_expire_year:, card_expire_month:, extra: {}, user: {}, metadata: {})
+      request(
+        uri:     'request/subscribe',
+        payload: {
+          pg:                pg,
+          order_name:        order_name,
+          subscription_id:   subscription_id,
+          price:             price,
+          tax_free:          tax_free,
+          card_no:           card_no,
+          card_pw:           card_pw,
+          card_identity_no:  card_identity_no,
+          card_expire_year:  card_expire_year,
+          card_expire_month: card_expire_month,
+          extra:             extra,
+          user:              user,
+          metadata:          metadata
+        }
+      )
+    end
+
+    # 빌링키 발급 요청하기
+    # Comment by GOSOMI
+    # @date: 2024-01-26
+    def request_subscribe_automatic_transfer_billing_key(pg:, order_name:, price: nil, tax_free: nil, subscription_id:,
+                                                         extra: {}, user: {}, metadata: {}, auth_type: 'ARS', username:,
+                                                         bank_name:, bank_account:, identity_no:, cash_receipt_type: 1,
+                                                         cash_receipt_identity_no: nil, phone:)
+      request(
+        uri:     'request/subscribe/automatic-transfer',
+        payload: {
+          pg:                       pg,
+          order_name:               order_name,
+          subscription_id:          subscription_id,
+          price:                    price,
+          tax_free:                 tax_free,
+          extra:                    extra,
+          user:                     user,
+          metadata:                 metadata,
+          auth_type:                auth_type,
+          username:                 username,
+          bank_name:                bank_name,
+          bank_account:             bank_account,
+          identity_no:              identity_no,
+          cash_receipt_type:        cash_receipt_type,
+          cash_receipt_identity_no: cash_receipt_identity_no,
+          phone:                    phone
+        }
+      )
+    end
+
+    alias_method :request_subscribe_card_payment, :request_subscribe_payment
+
+    # ARS나 본인인증 이후 빌링키 발급
+    # Comment by GOSOMI
+    # @date: 2024-01-26
+    def publish_automatic_transfer_billing_key(receipt_id:)
+      request(
+        method:  :post,
+        uri:     "request/subscribe/automatic-transfer/publish",
+        payload: {
+          receipt_id: receipt_id
+        }
+      )
+    end
+
+    # 정기결제를 계속해서 진행한다
+    # Comment by Gosomi
+    # Date: 2022-01-18
+    def request_subscribe_on_continue(receipt_id)
+      request(
+        method: :put,
+        uri:    "request/subscribe/#{receipt_id}"
+      )
+    end
+
+    def request_subscribe_automatic_transfer_on_continue(receipt_id)
+      request(
+        method: :put,
+        uri:    "request/subscribe/automatic-transfer/#{receipt_id}"
+      )
+    end
+
+    # 빌링키로 조회하는 기능을 만든다
+    # Comment by GOSOMI
+    # @date: 2023-09-14
+    def lookup_billing_key(billing_key)
+      request(
+        method: :get,
+        uri:    "billing_key/#{billing_key}"
+      )
+    end
+
+    # 우선순위 빌링키 조회기능 추가
+    # Comment by GOSOMI
+    # @date: 2026-07-03
+    def lookup_sequential_billing_key(widget_key:, billing_key:, user_id:)
+      request(
+        method: :get,
+        uri:    "subscribe/sequential_billing_key/#{billing_key}?widget_key=#{widget_key}&user_id=#{user_id}"
+      )
+    end
+  end
+end

data/lib/bootpay/concern/token.rb

@@ -0,0 +1,33 @@
+module Bootpay::Concern::Token
+  extend ActiveSupport::Concern
+
+  included do
+    # Access Token을 요청한다
+    # Comment by Gosomi
+    # Date: 2021-05-21
+    def request_access_token
+      response = request(
+        uri:     'request/token',
+        payload: {
+          application_id: @application_id,
+          private_key:    @private_key
+        }
+      )
+      @token   = response.data[:access_token] if response.success?
+      response
+    end
+
+    # 둘다 겸하는 경우 우회함수
+    # Comment by GOSOMI
+    # @date: 2026-03-11
+    def basic_or_request_access_token
+      if @use_client_key
+        Object.new.tap do |o|
+          o.define_singleton_method(:success?) { true }
+        end
+      else
+        request_access_token
+      end
+    end
+  end
+end

data/lib/bootpay/concern/user_token.rb

@@ -0,0 +1,23 @@
+module Bootpay::Concern::UserToken
+  extend ActiveSupport::Concern
+
+  included do
+    # User Token 정보를 가져온다
+    # Comment by Gosomi
+    # Date: 2022-02-03
+    def request_user_token(user_id:, email: nil, username: nil, gender: -1, birth: nil, phone: nil)
+      request(
+        method:  :post,
+        uri:     'request/user/token',
+        payload: {
+          user_id:  user_id,
+          email:    email,
+          username: username,
+          gender:   gender,
+          birth:    birth,
+          phone:    phone
+        }
+      )
+    end
+  end
+end

data/lib/bootpay/concern/wallet.rb

@@ -0,0 +1,20 @@
+module Bootpay::Concern::Wallet
+  extend ActiveSupport::Concern
+
+  included do
+    # 등록된 회원의 지갑 정보를 가져온다
+    # Comment by GOSOMI
+    # @date: 2025-02-13
+    def user_wallets(user_id:, widget_key: nil, sandbox: false)
+      request(
+        uri:    'wallet',
+        method: :get,
+        params: {
+          user_id:    user_id,
+          widget_key: widget_key,
+          sandbox:    sandbox
+        }
+      )
+    end
+  end
+end

data/lib/bootpay/concern/webhook.rb

@@ -0,0 +1,18 @@
+module Bootpay::Concern::Webhook
+  extend ActiveSupport::Concern
+
+  included do
+    # Access Token을 요청한다
+    # Comment by Gosomi
+    # Date: 2021-05-21
+    def request_webhook(receipt_id:, webhook_url:)
+      request(
+        uri:     'request/webhook',
+        payload: {
+          receipt_id:  receipt_id,
+          webhook_url: webhook_url
+        }
+      )
+    end
+  end
+end

data/lib/bootpay/concern.rb

@@ -0,0 +1,35 @@
+module Bootpay
+  module Concern
+    require_relative 'concern/authenticate'
+    require_relative 'concern/cash_receipt'
+    require_relative 'concern/easy'
+    require_relative 'concern/escrow'
+    require_relative 'concern/payment'
+    require_relative 'concern/reseller'
+    require_relative 'concern/rest'
+    require_relative 'concern/sdk'
+    require_relative 'concern/seller'
+    require_relative 'concern/service'
+    require_relative 'concern/subscription'
+    require_relative 'concern/token'
+    require_relative 'concern/user_token'
+    require_relative 'concern/wallet'
+    require_relative 'concern/webhook'
+
+    include Authenticate
+    include CashReceipt
+    include Easy
+    include Escrow
+    include Payment
+    include Reseller
+    include Rest
+    include Sdk
+    include Seller
+    include Service
+    include Subscription
+    include Token
+    include UserToken
+    include Wallet
+    include Webhook
+  end
+end

data/lib/bootpay-backend-ruby.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+# 구 gem 이름(`bootpay-backend-ruby`) 호환 진입점.
+# 정본 gem 은 `bootpay` 이고 진입점은 lib/bootpay.rb 다.
+# 이미 `require 'bootpay-backend-ruby'` 로 쓰던 코드가 깨지지 않도록 남겨 둔다.
+require_relative "bootpay"

data/lib/bootpay.rb

@@ -1,50 +1,10 @@
-require 'active_support/all'
-require 'http'
-require_relative 'response'
-require_relative 'bootpay/billing'
-require_relative 'bootpay/cancel'
-require_relative 'bootpay/easy'
-require_relative 'bootpay/escrow'
-require_relative 'bootpay/link'
-require_relative 'bootpay/naverpay'
-require_relative 'bootpay/payment_resource'
-require_relative 'bootpay/reseller'
-require_relative 'bootpay/rest'
-require_relative 'bootpay/submit'
-require_relative 'bootpay/token'
-require_relative 'bootpay/verification'
-require_relative "bootpay/version"
+# frozen_string_literal: true
 
-module Bootpay
-  class Api
-    include Billing
-    include Cancel
-    include Easy
-    include Escrow
-    include Link
-    include Naverpay
-    include PaymentResource
-    include Reseller
-    include Rest
-    include Submit
-    include Token
-    include Verification
-
-    API =
-      {
-        development: 'https://dev-api.bootpay.co.kr',
-        stage:       'https://stage-api.bootpay.co.kr',
-        production:  'https://api.bootpay.co.kr',
-        ehowlsla:    'https://ehowlsla.bootpay.co.kr/api/v2'
-      }.freeze
-
-    def initialize(application_id:, private_key:, mode: 'production')
-    
-      @application_id = application_id
-      @private_key    = private_key
-      @mode           = mode.presence || 'production'
-      @token          = nil
-      raise ArgumentError, "개발환경 mode는 development, stage, production 중에서 선택이 가능합니다." if API[@mode.to_sym].blank?
-    end 
-  end
-end
+# `gem 'bootpay'` 의 기본 진입점.
+# Bundler 는 gem 이름과 같은 파일을 자동으로 require 하므로 이 파일이 없으면 부팅에서 LoadError 가 난다.
+#
+# 구 이름 `bootpay-backend-ruby` 로 require 하던 코드도 그대로 동작한다
+# (lib/bootpay-backend-ruby.rb 가 이 파일과 같은 내용을 로드한다).
+require_relative "bootpay/bootpay-rest-client"
+require_relative "bootpay_storage/bootpay-storage-rest-client"
+require_relative "bootpay_store/bootpay-store-rest-client"

data/lib/bootpay_storage/bootpay-storage-rest-client.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require 'active_support/all'
+require 'http'
+require_relative 'response'
+require_relative '../version'
+require_relative 'concern'
+
+module BootpayStorage
+  class RestClient
+    include Concern
+
+    API =
+      {
+        development: 'https://dev-s.bootapi.com/api/v1',
+        stage:       'https://stage-s.bootapi.com/api/v1',
+        production:  'https://s.bootapi.com/api/v1',
+      }
+
+    SDK_VERSION = '5.0.0'
+
+    def initialize(server_key:, private_key:, mode: 'production')
+      @server_key     = server_key
+      @private_key    = private_key
+      @mode           = mode.presence || 'production'
+      @token          = nil
+      @api_version    = SDK_VERSION
+      raise ArgumentError, "개발환경 mode는 development, stage, production 중에서 선택이 가능합니다." if API[@mode.to_sym].blank?
+    end
+
+    # API URL을 변경
+    # Comment by GOSOMI
+    # @date: 2023-05-26
+    def set_api_url(url)
+      API[@mode.to_sym] = url
+    end
+
+    # API 버전을 설정한다
+    # Comment by Gosomi
+    # Date: 2022-07-29
+    def set_api_version(version)
+      raise ArgumentError, 'API Version은 4.0.0 이상만 설정이 가능합니다.' if version < '4.0.0'
+      @api_version = version
+    end
+  end
+end

data/lib/bootpay_storage/concern/csv.rb

@@ -0,0 +1,18 @@
+module BootpayStorage::Concern::Csv
+  extend ActiveSupport::Concern
+
+  included do
+
+
+    # csv 파일 업로드 - 마이그레이션 할 때 사용
+    # Comment by ehowlsla
+    # Date: 2025-07-17
+    def csv_file_upload(files:)
+      csv_upload(
+        uri:   'csvs',
+        files: files
+      )
+    end
+
+  end
+end

data/lib/bootpay_storage/concern/image.rb

@@ -0,0 +1,30 @@
+module BootpayStorage::Concern::Image
+  extend ActiveSupport::Concern
+
+  included do
+
+
+    # REST API로 본인인증 요청하기
+    # Comment by Gosomi
+    # Date: 2022-11-02
+    def image_upload(images:)
+      upload(
+        uri:     'images',
+        images: images
+      )
+    end
+
+    # 업로드한 이미지를 URL 로 삭제한다.
+    # 업로드 응답이 URL 만 돌려주므로(내부 식별자 미노출) 삭제도 URL 을 키로 받는다.
+    # Comment by Claude (alfred)
+    # @date: 2026-07-28
+    def image_destroy(url:)
+      request(
+        method:  :delete,
+        uri:     'images/by_url',
+        payload: { url: url }
+      )
+    end
+
+  end
+end

data/lib/bootpay_storage/concern/rest.rb

@@ -0,0 +1,176 @@
+module BootpayStorage::Concern::Rest
+  extend ActiveSupport::Concern
+
+  included do
+    private
+
+    # HTTP Request 기본 Method
+    # Comment by Gosomi
+    # Date: 2021-05-21
+    def request(method: :post, uri:, payload: {}, headers: {}, params: nil)
+      response = HTTP.headers(
+        {
+          Authorization:       "Bearer #{@token}",
+          content_type:        'application/json',
+          accept:              'application/json',
+          bootpay_api_version: @api_version,
+          bootpay_sdk_version: Bootpay::V2_VERSION,
+          bootpay_sdk_type:    '300'
+        }.merge!(headers).compact
+      ).send(
+        method.to_sym,
+        [BootpayStorage::RestClient::API[@mode.to_sym], uri].join('/'),
+        json:   payload,
+        params: params
+      )
+      BootpayStorage::Response.new(
+        response.status.to_i == 200,
+        JSON.parse(response.body.to_s, symbolize_names: true)
+      )
+    rescue Exception => e
+      BootpayStorage::Response.new(
+        false,
+        message:   "부트페이 API 서버와의 통신이 실패하였습니다. 오류 메세지: #{e.message}",
+        backtrace: e.backtrace.join("\n")
+      )
+    end
+
+    # Multipart 파일 전송 Method
+    # Comment by Gosomi
+    # Date: 2025-03-25
+    def upload(uri:, images:, headers: {}, params: nil)
+      # 이미지 데이터를 배열로 받음
+      files = images.each_with_index.map do |data, index|
+        filename = "image_#{Time.now.to_i}_#{index}.jpg"
+        HTTP::FormData::File.new(data, filename: filename)
+      end
+
+      # HTTP 요청
+      response = HTTP.headers(
+        {
+          Authorization:       "Bearer #{@token}",
+          accept:              'application/json',
+          bootpay_api_version: @api_version,
+          bootpay_sdk_version: Bootpay::V2_VERSION,
+          bootpay_sdk_type:    '300'
+        }.merge!(headers).compact
+      ).post(
+        [BootpayStorage::RestClient::API[@mode.to_sym], uri].join('/'),
+        form: { images: files },
+        params: params
+      )
+
+      # JSON 파싱 시도
+      parsed_response = begin
+                          JSON.parse(response.body.to_s, symbolize_names: true)
+                        rescue JSON::ParserError => e
+                          { error: "응답 파싱 실패: #{e.message}", body: response.body.to_s }
+                        end
+
+      # 응답 처리
+      BootpayStorage::Response.new(
+        response.status.to_i == 200,
+        parsed_response
+      )
+    rescue Exception => e
+      BootpayStorage::Response.new(
+        false,
+        message:   "파일 업로드 실패: #{e.message}",
+        backtrace: e.backtrace.join("\n")
+      )
+    end
+
+    # csv Multipart 파일 전송 Method
+    # Comment by ehowlsla
+    # Date: 2025-07-17
+    def csv_upload(uri:, files:, headers: {}, params: nil)
+      # 이미지 데이터를 배열로 받음
+      files = files.each_with_index.map do |data, index|
+        filename = "csv_#{Time.now.to_i}_#{index}.csv"
+        HTTP::FormData::File.new(data, filename: filename)
+      end
+
+      # HTTP 요청
+      response = HTTP.headers(
+        {
+          Authorization:       "Bearer #{@token}",
+          accept:              'application/json',
+          bootpay_api_version: @api_version,
+          bootpay_sdk_version: Bootpay::V2_VERSION,
+          bootpay_sdk_type:    '300'
+        }.merge!(headers).compact
+      ).post(
+        [BootpayStorage::RestClient::API[@mode.to_sym], uri].join('/'),
+        form: { images: files },
+        params: params
+      )
+
+      # JSON 파싱 시도
+      parsed_response = begin
+                          JSON.parse(response.body.to_s, symbolize_names: true)
+                        rescue JSON::ParserError => e
+                          { error: "응답 파싱 실패: #{e.message}", body: response.body.to_s }
+                        end
+
+      # 응답 처리
+      BootpayStorage::Response.new(
+        response.status.to_i == 200,
+        parsed_response
+      )
+    rescue Exception => e
+      BootpayStorage::Response.new(
+        false,
+        message:   "파일 업로드 실패: #{e.message}",
+        backtrace: e.backtrace.join("\n")
+      )
+    end
+
+
+    # def upload(uri:, image_data:, image_name:, headers: {}, params: nil)
+    #
+    #   # puts [BootpayStorage::RestClient::API[@mode.to_sym], uri].join('/')
+    #
+    #   # 파일 객체 생성
+    #   file = HTTP::FormData::File.new(image_data, filename: image_name)
+    #
+    #   # HTTP 요청
+    #   response = HTTP.headers(
+    #     {
+    #       Authorization:       "Bearer #{@token}",
+    #       accept:              'application/json',
+    #       bootpay_api_version: @api_version,
+    #       bootpay_sdk_version: Bootpay::V2_VERSION,
+    #       bootpay_sdk_type:    '300'
+    #     }.merge!(headers).compact
+    #   ).post(
+    #     [BootpayStorage::RestClient::API[@mode.to_sym], uri].join('/'),
+    #     form: { images: [file] },
+    #     params: params
+    #   )
+    #
+    #   # 응답 상태와 바디 출력
+    #   puts "Response Status: #{response.status}"
+    #   puts "Response Body: #{response.body.to_s}"
+    #
+    #   # JSON 파싱 시도
+    #   parsed_response = begin
+    #                       JSON.parse(response.body.to_s, symbolize_names: true)
+    #                     rescue JSON::ParserError => e
+    #                       { error: "응답 파싱 실패: #{e.message}", body: response.body.to_s }
+    #                     end
+    #
+    #   # 응답 처리
+    #   BootpayStorage::Response.new(
+    #     response.status.to_i == 200,
+    #     parsed_response
+    #   )
+    # rescue Exception => e
+    #   BootpayStorage::Response.new(
+    #     false,
+    #     message:   "파일 업로드 실패: #{e.message}",
+    #     backtrace: e.backtrace.join("\n")
+    #   )
+    # end
+
+  end
+end

data/lib/bootpay_storage/concern/token.rb

@@ -0,0 +1,9 @@
+module BootpayStorage::Concern::Token
+  extend ActiveSupport::Concern
+
+  included do
+    def set_token(token)
+      @token = token
+    end
+  end
+end