bootpay-backend-ruby 2.0.5 → 3.0.0.pre.alpha.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34d3516ce74a87e2e2f06a2ea4302ad5bd205a8f2d16d71341cb6dbb9f5ad529
-  data.tar.gz: 677167c71eb134d5e8ab400104993788994cce77b53bd341026d4ffe10d35076
+  metadata.gz: 2f99b7d09d3da36d7350f6e11ec9e3992e5518b1e4cf9280577f537b952471ff
+  data.tar.gz: a139b2429b80827e4865b5bb1b6d970bb9cb9051b28577a4340a0f88b2e258e1
 SHA512:
-  metadata.gz: fb2929d5d6a82d87825ea8af03bb5446653ca90c931648d21e0c33b1f03ddb6ff6454577f299f3245c3fc42dba9b07140b9417471a5f16eb86fd84898b78b7a7
-  data.tar.gz: 170ab349d9a9e8e374afe4b2cb64eb664748be654f3fe1567c837e152be4e04834a6280871568de481b5cb0632fdca2455ceccadd422302b62734965da51e7c1
+  metadata.gz: 4151964b4afe765e3a2dbdd2b36f531ee02e0f21e28a4d2f674917b310018f891c657462a73b3132853529a1ab80e249da1aca01acddf954ab3aa2f60ffa1cdc
+  data.tar.gz: 94d3d4875dce4fbf501c10263cff3d221bf2c7ae78b60f4210709ef3811271d77ba47de346dd834e6df108492c496e001293ef2c8b372d3ec803f3e3168981f7

data/.gitignore

@@ -13,7 +13,7 @@
 *.iml
 *.gem
 Gemfile.lock
-/spec/bootpay/request_rest_billing_key_spec.rb
+/spec/bootpay/card_billing/request_rest_billing_key_spec.rb
 /spec/bootpay/__stage_test_unit_spec.rb
 /spec/bootpay/__development_test_unit_spec.rb
 .DS_Store

data/README.md

@@ -8,28 +8,33 @@ Ruby 언어로 작성된 어플리케이션, 프레임워크 등에서 사용가
 * 결제 검증 및 취소, 빌링키 발급, 본인인증 등의 수행은 서버사이드에서 진행됩니다. (Java, PHP, Python, Ruby, Node.js, Go, ASP.NET 등)
 
 
-## 기능
-1. (부트페이 통신을 위한) 토큰 발급
-2. 결제 단건 조회 
-3. 결제 취소 (전액 취소 / 부분 취소)
-4. 신용카드 자동결제 (빌링결제)
+## 목차
+- [사용하기](#사용하기)
+   - [1. 토큰 발급](#1-토큰-발급)
+   - [2. 결제 단건 조회](#2-결제-단건-조회)
+   - [3. 결제 취소 (전액 취소 / 부분 취소)](#3-결제-취소-전액-취소--부분-취소)
+   - [4. 자동/빌링/정기 결제](#4-자동빌링정기-결제)
+      - [4-1. 카드 빌링키 발급](#4-1-카드-빌링키-발급)
+      - [4-2. 계좌 빌링키 발급](#4-2-계좌-빌링키-발급)
+      - [4-3. 결제 요청하기](#4-3-결제-요청하기)
+      - [4-4. 결제 예약하기](#4-4-결제-예약하기)
+      - [4-5. 예약 조회하기](#4-5-예약-조회하기)
+      - [4-6. 예약 취소하기](#4-6-예약-취소하기)
+      - [4-7. 빌링키 삭제하기](#4-7-빌링키-삭제하기)
+      - [4-8. 빌링키 조회하기](#4-8-빌링키-조회하기)
+   - [5. 회원 토큰 발급요청](#5-회원-토큰-발급요청)
+   - [6. 서버 승인 요청](#6-서버-승인-요청)
+   - [7. 본인 인증 결과 조회](#7-본인-인증-결과-조회)
+   - [8. 에스크로 이용시 PG사로 배송정보 보내기](#8-에스크로-이용시-pg사로-배송정보-보내기)
+   - [9-1. 현금영수증 발행하기](#9-1-현금영수증-발행하기)
+   - [9-2. 현금영수증 발행 취소](#9-2-현금영수증-발행-취소)
+   - [9-3. 별건 현금영수증 발행](#9-3-별건-현금영수증-발행)
+   - [9-4. 별건 현금영수증 발행 취소](#9-4-별건-현금영수증-발행-취소)
+- [Example 프로젝트](#example-프로젝트)
+- [Documentation](#documentation)
+- [기술문의](#기술문의)
+- [License](#license)
 
-   4-1. 빌링키 발급
-
-   4-2. 발급된 빌링키로 결제 승인 요청
-
-   4-3. 발급된 빌링키로 결제 예약 요청
-
-   4-4. 발급된 빌링키로 결제 예약 - 취소 요청
-
-   4-5. 빌링키 삭제
-
-   4-6. 빌링키 조회
-
-5. (생체인증, 비밀번호 결제를 위한) 구매자 토큰 발급
-6. 서버 승인 요청
-7. 본인 인증 결과 조회
-8. (에스크로 이용시) PG사로 배송정보 보내기 
 
 ## Gem으로 설치하기
 
@@ -68,7 +73,7 @@ end
 함수 단위의 샘플 코드는 [이곳](https://github.com/bootpay/backend-ruby/tree/2-x-development/spec/bootpay)을 참조하세요.
 
 
-## 1. (부트페이 통신을 위한) 토큰 발급
+## 1. 토큰 발급
 
 부트페이와 서버간 통신을 하기 위해서는 부트페이 서버로부터 토큰을 발급받아야 합니다.  
 발급된 토큰은 30분간 유효하며, 최초 발급일로부터 30분이 지날 경우 토큰 발급 함수를 재호출 해주셔야 합니다.
@@ -125,7 +130,7 @@ if api.request_access_token.success?
 end
 ```
 
-## 4-1. 빌링키 발급
+## 4-1. 카드 빌링키 발급
 REST API 방식으로 고객의 카드 정보를 전달하여, PG사로부터 빌링키를 발급받을 수 있습니다. (부트페이에서는 PG사의 빌링키를 개발사에게 전달하지 않고, 부트페이가 내부적으로 발급한 빌링키를 전달합니다)
 발급받은 빌링키를 저장하고 있다가, 원하는 시점, 원하는 금액에 결제 승인 요청하여 좀 더 자유로운 결제시나리오에 적용이 가능합니다.
 * 비인증 정기결제(REST API) 방식을 지원하는 PG사만 사용 가능합니다.
@@ -151,7 +156,40 @@ end
  
 ```
 
-## 4-2. 발급된 빌링키로 결제 승인 요청
+
+## 4-2. 계좌 빌링키 발급
+REST API 방식으로 고객의 계좌 정보를 전달하여, PG사에게 빌링키 발급을 요청합니다. 요청 후 빌링키가 바로 발급되진 않고, 출금동의 확인 절차까지 진행해야 빌링키가 발급됩니다.
+먼저 빌링키를 요청합니다.
+```ruby
+res1 = api.request_subscribe_automatic_transfer_billing_key(
+    pg:         'nicepay',
+    order_name: '테스트 결제',
+    price:       100,
+    tax_free:    0,
+    subscription_id:    Time.current.to_i,
+    username:    '홍길동',
+    user:        {
+      phone:    '01012341234',
+      username: '홍길동',
+      email:    'test@bootpay.co.kr'
+    },
+    bank_name: '국민',
+    bank_account: '675123412342472',
+    identity_no: '901014',
+    cash_receipt_identity_no: '01012341234',
+    phone: '01012341234',
+  )
+  print res1.data.to_json
+```
+이후 빌링키 발급 요청시 응답받은 receipt_id로, 출금 동의 확인을 요청합니다.
+
+```ruby
+res2 = api.publish_automatic_transfer_billing_key(receipt_id: res1.data[:receipt_id])
+print "\n\n" + res2.data.to_json
+```
+
+
+## 4-3. 결제 요청하기
 발급된 빌링키로 원하는 시점에 원하는 금액으로 결제 승인 요청을 할 수 있습니다. 잔액이 부족하거나 도난 카드 등의 특별한 건이 아니면 PG사에서 결제를 바로 승인합니다.
 
 ```ruby  
@@ -175,7 +213,7 @@ if api.request_access_token.success?
   puts response.data.to_json
 end
 ```
-## 4-3. 발급된 빌링키로 결제 예약 요청
+## 4-4. 결제 예약하기
 원하는 시점에 4-1로 결제 승인 요청을 보내도 되지만, 빌링키 발급 이후에 바로 결제 예약 할 수 있습니다. (빌링키당 최대 10건)
 ```ruby  
 api = Bootpay::RestClient.new(
@@ -198,8 +236,24 @@ if api.request_access_token.success?
   print response.data.to_json
 end
 ```
-##  4-4. 발급된 빌링키로 결제 예약 - 취소 요청
-빌링키로 예약된 결제건을 취소합니다.
+
+## 4-5. 예약 조회하기
+예약시 응답받은 reserveId로 예약된 건을 조회합니다.
+```ruby  
+api = Bootpay::RestClient.new(
+   application_id: '59bfc738e13f337dbd6ca48a',
+   private_key:    'pDc0NwlkEX3aSaHTp/PPL/i8vn5E/CqRChgyEp/gHD0='
+) 
+if api.request_access_token.success?
+  reserve_id = "628c0d0d1fc19202e5ef2866"
+  response = api.subscribe_payment_reserve_lookup(reserve_id)
+  print response.data.to_json
+``` 
+
+
+
+## 4-6. 예약 취소하기
+예약시 응답받은 reserveId로 예약된 건을 취소합니다.
 ```ruby  
 api = Bootpay::RestClient.new(
    application_id: '59bfc738e13f337dbd6ca48a',
@@ -226,8 +280,8 @@ if api.request_access_token.success?
   end
 end
 ```
-## 4-5. 빌링키 삭제
-발급된 빌링키가 더 이상 사용되지 않도록, 삭제 요청합니다.
+## 4-7. 빌링키 삭제하기
+발급된 빌링키를 삭제합니다. 삭제하더라도 예약된 결제건은 취소되지 않습니다. 예약된 결제건 취소를 원하시면 예약 취소하기를 요청하셔야 합니다.
 ```ruby 
 api = Bootpay::RestClient.new(
    application_id: '59bfc738e13f337dbd6ca48a',
@@ -241,8 +295,9 @@ if api.request_access_token.success?
 end
 ```
 
-## 4-6. 빌링키 조회
-(빌링키 발급 완료시 리턴받았던 receipt_id에 한정) 어떤 빌링키였는지 조회합니다.
+## 4-8. 빌링키 조회하기
+클라이언트에서 빌링키 발급시, 보안상 클라이언트 이벤트에 빌링키를 전달해주지 않습니다. 그러므로 이 API를 통해 조회해야 합니다.
+다음은 빌링키 발급 요청했던 receiptId 로 빌링키를 조회합니다.
 ```ruby 
 api = Bootpay::RestClient.new(
    application_id: '59bfc738e13f337dbd6ca48a',
@@ -256,9 +311,9 @@ if api.request_access_token.success?
 end
 ```
 
-## 5. (생체인증, 비밀번호 결제를 위한) 구매자 토큰 발급
-부트페이에서 제공하는 간편결제창, 생체인증 기반의 결제 사용을 위해서는 개발사에서 회원 고유번호를 관리해야하며, 해당 회원에 대한 사용자 토큰을 발급합니다.
-이 토큰값을 기반으로 클라이언트에서 결제요청 하시면 되겠습니다.
+## 5. 회원 토큰 발급요청
+ㅇㅇ페이 사용을 위해 가맹점 회원의 토큰을 발급합니다. 가맹점은 회원의 고유번호를 관리해야합니다.
+이 토큰값을 기반으로 클라이언트에서 결제요청(payload.user_token) 하시면 되겠습니다.
 ```ruby  
 api = Bootpay::RestClient.new(
    application_id: '59bfc738e13f337dbd6ca48a',
@@ -344,7 +399,7 @@ end
 
 ## Documentation
 
-[부트페이 개발매뉴얼](https://docs.bootpay.co.kr/next/)을 참조해주세요
+[부트페이 개발매뉴얼](https://developer.bootpay.co.kr/)을 참조해주세요
 
 ## 기술문의
 

data/bootpay-backend-ruby.gemspec

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative "lib/bootpay/version"
+require_relative "lib/version"
 
 Gem::Specification.new do |spec|
   spec.name    = "bootpay-backend-ruby"

data/lib/{bootpay-backend-ruby.rb → bootpay/bootpay-rest-client.rb}

@@ -3,8 +3,8 @@
 require 'active_support/all'
 require 'http'
 require_relative 'response'
-require_relative 'bootpay/version'
-require_relative 'bootpay/concern'
+require_relative '../version'
+require_relative 'concern'
 
 module Bootpay
   class RestClient
@@ -17,7 +17,7 @@ module Bootpay
         production:  'https://api.bootpay.co.kr/v2'
       }
 
-    SDK_VERSION = '4.2.1'
+    SDK_VERSION = '5.0.0'
 
     def initialize(application_id:, private_key:, mode: 'production')
       @application_id = application_id

data/lib/bootpay/concern/cash_receipt.rb

@@ -45,18 +45,21 @@ module Bootpay::Concern::CashReceipt
     # 결제된 계좌이체/가상계좌 결제건중 누락된 현금영수증을 발행해주는 API
     # Comment by Gosomi
     # Date: 2022-07-21
-    def cash_receipt_publish_on_receipt(receipt_id:, username:, email:, phone:, identity_no:, currency: 'WON', cash_receipt_type: '소득공제')
+    def cash_receipt_publish_on_receipt(receipt_id:, username:, email:, phone:, identity_no:, currency: 'WON',
+                                        cash_receipt_type: '소득공제', pg: nil, test_production: false)
       request(
         method:  :post,
         uri:     "request/receipt/cash/publish",
         payload: {
+          pg:                pg,
           receipt_id:        receipt_id,
           username:          username,
           email:             email,
           phone:             phone,
           identity_no:       identity_no,
           currency:          currency,
-          cash_receipt_type: cash_receipt_type
+          cash_receipt_type: cash_receipt_type,
+          test_production:   test_production
         }
       )
     end

data/lib/bootpay/concern/payment.rb

@@ -60,7 +60,8 @@ module Bootpay::Concern::Payment
     # Comment by Gosomi
     # Date: 2023-03-28
     def request_payment(platform_application_id:, pg:, method: nil, price:, tax_free: 0, order_name:, order_id:, user_token: nil, uuid: nil, sk: nil,
-                        ti: 0, tk: nil, items: [], extra: {}, user: {}, agent: nil)
+                        ti: 0, tk: nil, items: [], extra: {}, user: {}, agent: nil, commission_keys: nil, wallet_id: nil, terms: [], widget_key: nil, widget_sandbox: false,
+                        redirect_url: nil)
       rand_uuid = SecureRandom.uuid
       request(
         uri: 'request/payment',
@@ -74,6 +75,12 @@ module Bootpay::Concern::Payment
                order_name:              order_name,
                order_id:                order_id,
                user_token:              user_token,
+               wallet_id:               wallet_id,
+               commission_keys:         commission_keys,
+               terms:                   terms,
+               redirect_url:            redirect_url,
+               widget_key:              widget_key,
+               widget_sandbox:          widget_sandbox,
                uuid:                    uuid.presence || rand_uuid,
                sk:                      sk.presence || "#{rand_uuid}-#{Time.current.to_i}",
                ti:                      ti,

data/lib/bootpay/concern/reseller.rb

@@ -28,6 +28,16 @@ module Bootpay::Concern::Reseller
       )
     end
 
+    # 가맹점 정보를 조회한다
+    # Comment by GOSOMI
+    # @date: 2024-07-09
+    def lookup_seller(provider_id)
+      request(
+        method: :get,
+        uri:    "reseller/seller/#{provider_id}",
+      )
+    end
+
     # 테스트로 생성한 계정을 모두 삭제한다
     # Comment by GOSOMI
     # @date: 2023-10-11

data/lib/bootpay/concern/rest.rb

@@ -7,7 +7,7 @@ module Bootpay::Concern::Rest
     # HTTP Request 기본 Method
     # Comment by Gosomi
     # Date: 2021-05-21
-    def request(method: :post, uri:, payload: {}, headers: {})
+    def request(method: :post, uri:, payload: {}, headers: {}, params: nil)
       response = HTTP.headers(
         {
           Authorization:       "Bearer #{@token}",
@@ -20,7 +20,8 @@ module Bootpay::Concern::Rest
       ).send(
         method.to_sym,
         [Bootpay::RestClient::API[@mode.to_sym], uri].join('/'),
-        json: payload
+        json:   payload,
+        params: params
       )
       Bootpay::Response.new(
         response.status.to_i == 200,

data/lib/bootpay/concern/service.rb

@@ -0,0 +1,15 @@
+module Bootpay::Concern::Service
+  extend ActiveSupport::Concern
+
+  included do
+    # 등록된 Wallet 정보를 가져온다
+    # Comment by GOSOMI
+    # @date: 2024-06-27
+    def lookup_service_wallets
+      request(
+        uri:    'seller/service/wallet',
+        method: :get
+      )
+    end
+  end
+end

data/lib/bootpay/concern/subscription.rb

@@ -204,6 +204,13 @@ module Bootpay::Concern::Subscription
       )
     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

data/lib/bootpay/concern/wallet.rb

@@ -0,0 +1,41 @@
+module Bootpay::Concern::Wallet
+  extend ActiveSupport::Concern
+
+  included do
+    # 설정된 wallet 기준으로 결제를 진행한다
+    def request_wallet_payment(user_id:, order_name:, price:, tax_free: 0, webhook_url: nil, content_type: nil, order_id:,
+                               items: [], user: {}, extra: {}, metadata: {}, sandbox: false)
+      request(
+        uri:     'wallet/payment',
+        payload: {
+          user_id:      user_id,
+          order_name:   order_name,
+          price:        price,
+          tax_free:     tax_free,
+          webhook_url:  webhook_url,
+          content_type: content_type,
+          order_id:     order_id,
+          items:        items,
+          user:         user,
+          extra:        extra,
+          metadata:     metadata,
+          sandbox:      sandbox
+        }
+      )
+    end
+
+    # 등록된 회원의 지갑 정보를 가져온다
+    # Comment by GOSOMI
+    # @date: 2025-02-13
+    def user_wallets(user_id:, sandbox:)
+      request(
+        uri:    'wallet',
+        method: :get,
+        params: {
+          user_id: user_id,
+          sandbox: sandbox
+        }
+      )
+    end
+  end
+end

data/lib/bootpay/concern.rb

@@ -9,9 +9,11 @@ module Bootpay
     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
@@ -23,9 +25,11 @@ module Bootpay
     include Rest
     include Sdk
     include Seller
+    include Service
     include Subscription
     include Token
     include UserToken
+    include Wallet
     include Webhook
   end
 end

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/image.rb

@@ -0,0 +1,19 @@
+module BootpayStorage::Concern::Image
+  extend ActiveSupport::Concern
+
+  included do
+
+
+    # REST API로 본인인증 요청하기
+    # Comment by Gosomi
+    # Date: 2022-11-02
+    def image_upload(image_data:, image_name:)
+      upload(
+        uri:     'images',
+        image_data: image_data,
+        image_name: image_name
+      )
+    end
+
+  end
+end

data/lib/bootpay_storage/concern/rest.rb

@@ -0,0 +1,88 @@
+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:, 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

data/lib/bootpay_storage/concern.rb

@@ -0,0 +1,10 @@
+module BootpayStorage
+  module Concern
+    require_relative 'concern/rest'
+    require_relative 'concern/token'
+    require_relative 'concern/image'
+    include Rest
+    include Image
+    include Token
+  end
+end

data/lib/bootpay_storage/response.rb

@@ -0,0 +1,14 @@
+module BootpayStorage
+  class Response
+    attr_reader :data
+
+    def initialize(success = true, data = {})
+      @success = success
+      @data    = data
+    end
+
+    def success?
+      @success
+    end
+  end
+end

data/lib/bootpay_store/bootpay-store-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 BootpayStore
+  class RestClient
+    include Concern
+
+    API =
+      {
+        development: 'https://dev-api.bootapi.com/v1',
+        stage:       'https://stage-api.bootapi.com/v1',
+        production:  'https://api.bootapi.com/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_store/concern/rest.rb

@@ -0,0 +1,38 @@
+module BootpayStore::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,
+        [BootpayStore::RestClient::API[@mode.to_sym], uri].join('/'),
+        json:   payload,
+        params: params
+      )
+      BootpayStore::Response.new(
+        response.status.to_i == 200,
+        JSON.parse(response.body.to_s, symbolize_names: true)
+      )
+    rescue Exception => e
+      BootpayStore::Response.new(
+        false,
+        message:   "부트페이 API 서버와의 통신이 실패하였습니다. 오류 메세지: #{e.message}",
+        backtrace: e.backtrace.join("\n")
+      )
+    end
+  end
+end

data/lib/bootpay_store/concern/token.rb

@@ -0,0 +1,24 @@
+module BootpayStore::Concern::Token
+  extend ActiveSupport::Concern
+
+  included do
+    # Access Token을 요청한다
+    # Comment by Gosomi
+    # Date: 2021-05-21
+    def request_access_token
+      response = request(
+        uri:     'token',
+        payload: {
+          server_key:  @server_key,
+          private_key: @private_key
+        }
+      )
+      @token   = response.data[:access_token] if response.success?
+      response
+    end
+
+    def set_token(token)
+      @token = token
+    end
+  end
+end

data/lib/bootpay_store/concern.rb

@@ -0,0 +1,35 @@
+module BootpayStore
+  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_store/response.rb

@@ -0,0 +1,14 @@
+module BootpayStore
+  class Response
+    attr_reader :data
+
+    def initialize(success = true, data = {})
+      @success = success
+      @data    = data
+    end
+
+    def success?
+      @success
+    end
+  end
+end

data/lib/{bootpay/version.rb → version.rb}

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module Bootpay
-  V2_VERSION = "2.0.5"
+  V2_VERSION = "3.0.0-alpha.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bootpay-backend-ruby
 version: !ruby/object:Gem::Version
-  version: 2.0.5
+  version: 3.0.0.pre.alpha.1
 platform: ruby
 authors:
 - gosomi
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-05-29 00:00:00.000000000 Z
+date: 2025-03-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -56,7 +56,7 @@ files:
 - bin/console
 - bin/setup
 - bootpay-backend-ruby.gemspec
-- lib/bootpay-backend-ruby.rb
+- lib/bootpay/bootpay-rest-client.rb
 - lib/bootpay/concern.rb
 - lib/bootpay/concern/authenticate.rb
 - lib/bootpay/concern/cash_receipt.rb
@@ -67,12 +67,25 @@ files:
 - lib/bootpay/concern/rest.rb
 - lib/bootpay/concern/sdk.rb
 - lib/bootpay/concern/seller.rb
+- lib/bootpay/concern/service.rb
 - lib/bootpay/concern/subscription.rb
 - lib/bootpay/concern/token.rb
 - lib/bootpay/concern/user_token.rb
+- lib/bootpay/concern/wallet.rb
 - lib/bootpay/concern/webhook.rb
-- lib/bootpay/version.rb
-- lib/response.rb
+- lib/bootpay/response.rb
+- lib/bootpay_storage/bootpay-storage-rest-client.rb
+- lib/bootpay_storage/concern.rb
+- lib/bootpay_storage/concern/image.rb
+- lib/bootpay_storage/concern/rest.rb
+- lib/bootpay_storage/concern/token.rb
+- lib/bootpay_storage/response.rb
+- lib/bootpay_store/bootpay-store-rest-client.rb
+- lib/bootpay_store/concern.rb
+- lib/bootpay_store/concern/rest.rb
+- lib/bootpay_store/concern/token.rb
+- lib/bootpay_store/response.rb
+- lib/version.rb
 homepage:
 licenses:
 - MIT
@@ -92,7 +105,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: Bootpay Ruby REST Client