starkbank 2.6.0 → 2.8.0

data/lib/error.rb

@@ -1,52 +1,19 @@
 # frozen_string_literal: true
 
-require('json')
+require('starkcore')
 
 module StarkBank
   module Error
-    class StarkBankError < StandardError
-      attr_reader :message
-      def initialize(message)
-        @message = message
-        super(message)
-      end
-    end
+    StarkBankError = StarkCore::Error::StarkCoreError
 
-    class Error < StarkBankError
-      attr_reader :code, :message
-      def initialize(code, message)
-        @code = code
-        @message = message
-        super("#{code}: #{message}")
-      end
-    end
+    Error = StarkCore::Error::Error
 
-    class InputErrors < StarkBankError
-      attr_reader :errors
-      def initialize(content)
-        errors = []
-        content.each do |error|
-          errors << Error.new(error['code'], error['message'])
-        end
-        @errors = errors
+    InputErrors = StarkCore::Error::InputErrors
 
-        super(content.to_json)
-      end
-    end
+    InternalServerError = StarkCore::Error::InternalServerError
 
-    class InternalServerError < StarkBankError
-      def initialize(message = 'Houston, we have a problem.')
-        super(message)
-      end
-    end
+    UnknownError = StarkCore::Error::UnknownError
 
-    class UnknownError < StarkBankError
-      def initialize(message)
-        super("Unknown exception encountered: #{message}")
-      end
-    end
-
-    class InvalidSignatureError < StarkBankError
-    end
+    InvalidSignatureError = StarkCore::Error::InvalidSignatureError
   end
 end

data/lib/event/attempt.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-require_relative('../utils/resource')
+require('starkcore')
 require_relative('../utils/rest')
-require_relative('../utils/checks')
 require_relative('event')
 
+
 module StarkBank
   class Event
     # # Event::Attempt object
@@ -12,14 +12,14 @@ module StarkBank
     # When an Event delivery fails, an event attempt will be registered.
     # It carries information meant to help you debug event reception issues.
     #
-    # ## Attributes:
+    # ## Attributes (return-only):
     # - id [string]: unique id that identifies the delivery attempt. ex: "5656565656565656"
     # - code [string]: delivery error code. ex: badHttpStatus, badConnection, timeout
     # - message [string]: delivery error full description. ex: "HTTP POST request returned status 404"
     # - event_id [string]: ID of the Event whose delivery failed. ex: "4848484848484848"
     # - webhook_id [string]: ID of the Webhook that triggered this event. ex: "5656565656565656"
     # - created [DateTime]: creation datetime for the log. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
-    class Attempt < StarkBank::Utils::Resource
+    class Attempt < StarkCore::Utils::Resource
       attr_reader :id, :code, :message, :event_id, :webhook_id, :created
       def initialize(id:, code:, message:, event_id:, webhook_id:, created:)
         super(id)
@@ -27,7 +27,7 @@ module StarkBank
         @message = message
         @event_id = event_id
         @webhook_id = webhook_id
-        @created = StarkBank::Utils::Checks.check_datetime(created)
+        @created = StarkCore::Utils::Checks.check_datetime(created)
       end
 
       # # Retrieve a specific Event::Attempt
@@ -61,8 +61,8 @@ module StarkBank
       # ## Return:
       # - generator of Event::Attempt objects with updated attributes
       def self.query(limit: nil, after: nil, before: nil, event_ids: nil, webhook_ids: nil, user: nil)
-        after = StarkBank::Utils::Checks.check_date(after)
-        before = StarkBank::Utils::Checks.check_date(before)
+        after = StarkCore::Utils::Checks.check_date(after)
+        before = StarkCore::Utils::Checks.check_date(before)
         StarkBank::Utils::Rest.get_stream(
           limit: limit,
           after: after,
@@ -91,8 +91,8 @@ module StarkBank
       # ## Return:
       # - list of Attempt objects with updated attributes and cursor to retrieve the next page of Attempt objects
       def self.page(cursor: nil, limit: nil, after: nil, before: nil, event_ids: nil, webhook_ids: nil, user: nil)
-        after = StarkBank::Utils::Checks.check_date(after)
-        before = StarkBank::Utils::Checks.check_date(before)
+        after = StarkCore::Utils::Checks.check_date(after)
+        before = StarkCore::Utils::Checks.check_date(before)
         return StarkBank::Utils::Rest.get_page(
           cursor: cursor,
           limit: limit,

data/lib/event/event.rb

@@ -1,11 +1,9 @@
 # frozen_string_literal: true
 
 require('json')
-require('starkbank-ecdsa')
-require_relative('../utils/resource')
+require('starkcore')
 require_relative('../utils/rest')
-require_relative('../utils/checks')
-require_relative('../utils/cache')
+require_relative('../utils/parse')
 require_relative('../error')
 require_relative('../boleto/log')
 require_relative('../boleto_holmes/log')
@@ -25,18 +23,18 @@ module StarkBank
   # Events cannot be created, but may be retrieved from the Stark Bank API to
   # list all generated updates on entities.
   #
-  # ## Attributes:
+  # ## Attributes (return-only):
   # - id [string]: unique id returned when the event is created. ex: '5656565656565656'
   # - log [Log]: a Log object from one the subscription services (TransferLog, InvoiceLog, BoletoLog, BoletoPaymentlog or UtilityPaymentLog)
   # - created [DateTime]: creation datetime for the notification event. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   # - is_delivered [bool]: true if the event has been successfully delivered to the user url. ex: False
   # - workspace_id [string]: ID of the Workspace that generated this event. Mostly used when multiple Workspaces have Webhooks registered to the same endpoint. ex: '4545454545454545'
   # - subscription [string]: service that triggered this event. ex: 'transfer', 'utility-payment'
-  class Event < StarkBank::Utils::Resource
+  class Event < StarkCore::Utils::Resource
     attr_reader :id, :log, :created, :is_delivered, :workspace_id, :subscription
     def initialize(id:, log:, created:, is_delivered:, workspace_id:, subscription:)
       super(id)
-      @created = StarkBank::Utils::Checks.check_datetime(created)
+      @created = StarkCore::Utils::Checks.check_datetime(created)
       @is_delivered = is_delivered
       @workspace_id = workspace_id
       @subscription = subscription
@@ -55,7 +53,7 @@ module StarkBank
       }[subscription.to_sym]
 
       @log = log
-      @log = StarkBank::Utils::API.from_api_json(resource[:resource_maker], log) unless resource.nil?
+      @log = StarkCore::Utils::API.from_api_json(resource[:resource_maker], log) unless resource.nil?
     end
 
     # # Retrieve a specific notification Event
@@ -88,8 +86,8 @@ module StarkBank
     # ## Return:
     # - generator of Event objects with updated attributes
     def self.query(limit: nil, after: nil, before: nil, is_delivered: nil, user: nil)
-      after = StarkBank::Utils::Checks.check_date(after)
-      before = StarkBank::Utils::Checks.check_date(before)
+      after = StarkCore::Utils::Checks.check_date(after)
+      before = StarkCore::Utils::Checks.check_date(before)
       StarkBank::Utils::Rest.get_stream(
         user: user,
         limit: limit,
@@ -116,8 +114,8 @@ module StarkBank
     # ## Return:
     # - list of Event objects with updated attributes and cursor to retrieve the next page of Event objects
     def self.page(cursor: nil, limit: nil, after: nil, before: nil, is_delivered: nil, user: nil)
-      after = StarkBank::Utils::Checks.check_date(after)
-      before = StarkBank::Utils::Checks.check_date(before)
+      after = StarkCore::Utils::Checks.check_date(after)
+      before = StarkCore::Utils::Checks.check_date(before)
       return StarkBank::Utils::Rest.get_page(
         cursor: cursor,
         limit: limit,
@@ -179,53 +177,29 @@ module StarkBank
     # ## Return:
     # - Parsed Event object
     def self.parse(content:, signature:, user: nil)
-      event = StarkBank::Utils::API.from_api_json(resource[:resource_maker], JSON.parse(content)['event'])
-
-      begin
-        signature = EllipticCurve::Signature.fromBase64(signature)
-      rescue
-        raise(StarkBank::Error::InvalidSignatureError, 'The provided signature is not valid')
-      end
-
-      return event if verify_signature(content: content, signature: signature, user: user)
-
-      return event if verify_signature(content: content, signature: signature, user: user, refresh: true)
-
-      raise(StarkBank::Error::InvalidSignatureError, 'The provided signature and content do not match the Stark Bank public key')
+      StarkBank::Utils::Parse.parse_and_verify(
+        content: content,
+        signature: signature,
+        user: user,
+        resource: resource,
+        key: 'event'
+      )
     end
 
-    class << self
-      private
-
-      def verify_signature(content:, signature:, user:, refresh: false)
-        public_key = StarkBank::Utils::Cache.starkbank_public_key
-        if public_key.nil? || refresh
-          pem = get_public_key_pem(user)
-          public_key = EllipticCurve::PublicKey.fromPem(pem)
-          StarkBank::Utils::Cache.starkbank_public_key = public_key
-        end
-        EllipticCurve::Ecdsa.verify(content, signature, public_key)
-      end
-
-      def get_public_key_pem(user)
-        StarkBank::Utils::Request.fetch(method: 'GET', path: 'public-key', query: { limit: 1 }, user: user).json['publicKeys'][0]['content']
-      end
-
-      def resource
-        {
-          resource_name: 'Event',
-          resource_maker: proc { |json|
-            Event.new(
-              id: json['id'],
-              log: json['log'],
-              created: json['created'],
-              is_delivered: json['is_delivered'],
-              workspace_id: json['workspace_id'],
-              subscription: json['subscription']
-            )
-          }
+    def self.resource
+      {
+        resource_name: 'Event',
+        resource_maker: proc { |json|
+          Event.new(
+            id: json['id'],
+            log: json['log'],
+            created: json['created'],
+            is_delivered: json['is_delivered'],
+            workspace_id: json['workspace_id'],
+            subscription: json['subscription']
+          )
         }
-      end
+      }
     end
   end
 end

data/lib/institution/institution.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
-require_relative('../utils/sub_resource')
 require_relative('../utils/rest')
-require_relative('../utils/checks')
+
 
 module StarkBank
   # # Institution object
@@ -17,7 +16,7 @@ module StarkBank
   # - name [string]: full version of the institution name. ex: 'Stark Bank S.A.'
   # - spi_code [string]: SPI code used to identify the institution on Pix transactions. ex: '20018183'
   # - str_code [string]: STR code used to identify the institution on TED transactions. ex: '123'
-  class Institution < StarkBank::Utils::SubResource
+  class Institution < StarkCore::Utils::SubResource
     attr_reader :display_name, :name, :spi_code, :str_code
     def initialize(display_name: nil, name: nil, spi_code: nil, str_code: nil)
       @display_name = display_name

data/lib/invoice/invoice.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require_relative('../utils/resource')
+require('starkcore')
 require_relative('../utils/rest')
-require_relative('../utils/checks')
+
 
 module StarkBank
   # # Invoice object
@@ -28,19 +28,20 @@ module StarkBank
   # - tags [list of strings, default nil]: list of strings for tagging
   #
   # ## Attributes (return-only):
-  # - pdf [string, default nil]: public Invoice PDF URL. ex: 'https://invoice.starkbank.com/pdf/d454fa4e524441c1b0c1a729457ed9d8'
-  # - link [string, default nil]: public Invoice webpage URL. ex: 'https://my-workspace.sandbox.starkbank.com/invoicelink/d454fa4e524441c1b0c1a729457ed9d8'
-  # - id [string, default nil]: unique id returned when Invoice is created. ex: '5656565656565656'
-  # - nominal_amount [integer, default nil]: Invoice emission value in cents (will change if invoice is updated, but not if it's paid). ex: 400000
-  # - fine_amount [integer, default nil]: Invoice fine value calculated over nominal_amount. ex: 20000
-  # - interest_amount [integer, default nil]: Invoice interest value calculated over nominal_amount. ex: 10000
-  # - discount_amount [integer, default nil]: Invoice discount value calculated over nominal_amount. ex: 3000
-  # - brcode [string, default nil]: BR Code for the Invoice payment. ex: '00020101021226800014br.gov.bcb.pix2558invoice.starkbank.com/f5333103-3279-4db2-8389-5efe335ba93d5204000053039865802BR5913Arya Stark6009Sao Paulo6220051656565656565656566304A9A0'
-  # - fee [integer, default nil]: fee charged by the Invoice. ex: 65 (= R$ 0.65)
-  # - status [string, default nil]: current Invoice status. ex: 'registered' or 'paid'
-  # - created [DateTime, default nil]: creation datetime for the Invoice. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
-  # - updated [DateTime, default nil]: latest update datetime for the Invoice. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
-  class Invoice < StarkBank::Utils::Resource
+  # - pdf [string]: public Invoice PDF URL. ex: 'https://invoice.starkbank.com/pdf/d454fa4e524441c1b0c1a729457ed9d8'
+  # - link [string]: public Invoice webpage URL. ex: 'https://my-workspace.sandbox.starkbank.com/invoicelink/d454fa4e524441c1b0c1a729457ed9d8'
+  # - id [string]: unique id returned when Invoice is created. ex: '5656565656565656'
+  # - nominal_amount [integer]: Invoice emission value in cents (will change if invoice is updated, but not if it's paid). ex: 400000
+  # - fine_amount [integer]: Invoice fine value calculated over nominal_amount. ex: 20000
+  # - interest_amount [integer]: Invoice interest value calculated over nominal_amount. ex: 10000
+  # - discount_amount [integer]: Invoice discount value calculated over nominal_amount. ex: 3000
+  # - brcode [string]: BR Code for the Invoice payment. ex: '00020101021226800014br.gov.bcb.pix2558invoice.starkbank.com/f5333103-3279-4db2-8389-5efe335ba93d5204000053039865802BR5913Arya Stark6009Sao Paulo6220051656565656565656566304A9A0'
+  # - fee [integer]: fee charged by the Invoice. ex: 65 (= R$ 0.65)
+  # - transaction_ids [list of strings]: ledger transaction ids linked to this Invoice (if there are more than one, all but the first are reversals or failed reversal chargebacks). ex: ["19827356981273"]
+  # - status [string]: current Invoice status. ex: 'registered' or 'paid'
+  # - created [DateTime]: creation datetime for the Invoice. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - updated [DateTime]: latest update datetime for the Invoice. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  class Invoice < StarkCore::Utils::Resource
     attr_reader :amount, :tax_id, :name, :due, :expiration, :fine, :interest, :discounts, :tags, :pdf, :link, :descriptions, :nominal_amount, :fine_amount, :interest_amount, :discount_amount, :id, :brcode, :fee, :status, :transaction_ids, :created, :updated
     def initialize(
       amount:, tax_id:, name:, due: nil, expiration: nil, fine: nil, interest: nil, discounts: nil,
@@ -49,7 +50,7 @@ module StarkBank
     )
       super(id)
       @amount = amount
-      @due = StarkBank::Utils::Checks.check_date_or_datetime(due)
+      @due = StarkCore::Utils::Checks.check_date_or_datetime(due)
       @tax_id = tax_id
       @name = name
       @expiration = expiration
@@ -67,12 +68,12 @@ module StarkBank
       @fee = fee
       @status = status
       @transaction_ids = transaction_ids
-      @updated = StarkBank::Utils::Checks.check_datetime(updated)
-      @created = StarkBank::Utils::Checks.check_datetime(created)
+      @updated = StarkCore::Utils::Checks.check_datetime(updated)
+      @created = StarkCore::Utils::Checks.check_datetime(created)
       if !discounts.nil?
         checked_discounts = []
         discounts.each do |discount|
-          discount["due"] = StarkBank::Utils::Checks.check_date_or_datetime(discount["due"])
+          discount["due"] = StarkCore::Utils::Checks.check_date_or_datetime(discount["due"])
           checked_discounts.push(discount)
         end
         @discounts = checked_discounts
@@ -159,8 +160,8 @@ module StarkBank
     # ## Return:
     # - generator of Invoice objects with updated attributes
     def self.query(limit: nil, after: nil, before: nil, status: nil, tags: nil, ids: nil, user: nil)
-      after = StarkBank::Utils::Checks.check_date(after)
-      before = StarkBank::Utils::Checks.check_date(before)
+      after = StarkCore::Utils::Checks.check_date(after)
+      before = StarkCore::Utils::Checks.check_date(before)
       StarkBank::Utils::Rest.get_stream(
         limit: limit,
         after: after,
@@ -191,8 +192,8 @@ module StarkBank
     # ## Return:
     # - list of Invoice objects with updated attributes and cursor to retrieve the next page of Invoice objects
     def self.page(cursor: nil, limit: nil, after: nil, before: nil, status: nil, tags: nil, ids: nil, user: nil)
-      after = StarkBank::Utils::Checks.check_date(after)
-      before = StarkBank::Utils::Checks.check_date(before)
+      after = StarkCore::Utils::Checks.check_date(after)
+      before = StarkCore::Utils::Checks.check_date(before)
       return StarkBank::Utils::Rest.get_page(
         cursor: cursor,
         limit: limit,

data/lib/invoice/log.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-require_relative('../utils/resource')
+require('starkcore')
 require_relative('../utils/rest')
-require_relative('../utils/checks')
 require_relative('invoice')
 
+
 module StarkBank
   class Invoice
     # # Invoice::Log object
@@ -14,20 +14,20 @@ module StarkBank
     # user, but it can be retrieved to check additional information
     # on the Invoice.
     #
-    # ## Attributes:
+    # ## Attributes (return-only):
     # - id [string]: unique id returned when the log is created. ex: '5656565656565656'
     # - invoice [Invoice]: Invoice entity to which the log refers to.
     # - errors [list of strings]: list of errors linked to this Invoice event
     # - type [string]: type of the Invoice event which triggered the log creation. ex: 'canceled' or 'paid'
     # - created [DateTime]: creation datetime for the log. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
-    class Log < StarkBank::Utils::Resource
+    class Log < StarkCore::Utils::Resource
       attr_reader :id, :created, :type, :errors, :invoice
       def initialize(id:, created:, type:, errors:, invoice:)
         super(id)
         @type = type
         @errors = errors
         @invoice = invoice
-        @created = StarkBank::Utils::Checks.check_datetime(created)
+        @created = StarkCore::Utils::Checks.check_datetime(created)
       end
 
       # # Retrieve a specific Log
@@ -61,8 +61,8 @@ module StarkBank
       # ## Return:
       # - list of Log objects with updated attributes
       def self.query(limit: nil, after: nil, before: nil, types: nil, invoice_ids: nil, user: nil)
-        after = StarkBank::Utils::Checks.check_date(after)
-        before = StarkBank::Utils::Checks.check_date(before)
+        after = StarkCore::Utils::Checks.check_date(after)
+        before = StarkCore::Utils::Checks.check_date(before)
         StarkBank::Utils::Rest.get_stream(
           limit: limit,
           after: after,
@@ -91,8 +91,8 @@ module StarkBank
       # ## Return:
       # - list of Log objects with updated attributes and cursor to retrieve the next page of Log objects
       def self.page(cursor: nil, limit: nil, after: nil, before: nil, types: nil, invoice_ids: nil, user: nil)
-        after = StarkBank::Utils::Checks.check_date(after)
-        before = StarkBank::Utils::Checks.check_date(before)
+        after = StarkCore::Utils::Checks.check_date(after)
+        before = StarkCore::Utils::Checks.check_date(before)
         return StarkBank::Utils::Rest.get_page(
           cursor: cursor,
           limit: limit,
@@ -131,7 +131,7 @@ module StarkBank
               created: json['created'],
               type: json['type'],
               errors: json['errors'],
-              invoice: StarkBank::Utils::API.from_api_json(invoice_maker, json['invoice'])
+              invoice: StarkCore::Utils::API.from_api_json(invoice_maker, json['invoice'])
             )
           }
         }

data/lib/invoice/payment.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require_relative('../utils/sub_resource')
 require_relative('invoice')
 
 module StarkBank
@@ -20,7 +19,7 @@ module StarkBank
         # - account_type [string]: payer bank account type. ex: 'checking', 'savings', 'salary' or 'payment'
         # - end_to_end_id [string]: central bank's unique transaction ID. ex: 'E79457883202101262140HHX553UPqeq'
         # - method [string]: payment method that was used. ex: 'pix'
-        class Payment < StarkBank::Utils::SubResource
+        class Payment < StarkCore::Utils::SubResource
             attr_reader :name, :tax_id, :bank_code, :branch_code, :account_number, :account_type, :amount, :end_to_end_id, :method
             def initialize(name:, tax_id:, bank_code:, branch_code:, account_number:, account_type:, amount:, end_to_end_id:, method:)
                 @name = name

data/lib/payment_preview/boleto_preview.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
-require_relative('../utils/sub_resource')
 require_relative('../utils/rest')
-require_relative('../utils/checks')
+
 
 module StarkBank
   class PaymentPreview
@@ -26,7 +25,7 @@ module StarkBank
     # - payer_tax_id [string]: payer tax ID (CPF or CNPJ). ex: '20.018.183/0001-80'
     # - line [string]: Number sequence that identifies the payment. ex: '34191.09008 63571.277308 71444.640008 5 81960000000062'
     # - bar_code [string]: Bar code number that identifies the payment. ex: '34195819600000000621090063571277307144464000'
-    class BoletoPreview < StarkBank::Utils::SubResource
+    class BoletoPreview < StarkCore::Utils::SubResource
       attr_reader :status, :amount, :discount_amount, :fine_amount, :interest_amount, :due, :expiration, :name, :tax_id, :receiver_name, :receiver_tax_id, :payer_name, :payer_tax_id, :line, :bar_code
       def initialize(status:, amount:, discount_amount:, fine_amount:, interest_amount:, due:, expiration:, name:, tax_id:, receiver_name:, receiver_tax_id:, payer_name:, payer_tax_id:, line:, bar_code:)
         @status = status
@@ -34,8 +33,8 @@ module StarkBank
         @discount_amount = discount_amount
         @fine_amount = fine_amount
         @interest_amount = interest_amount
-        @due = StarkBank::Utils::Checks.check_datetime(due)
-        @expiration = StarkBank::Utils::Checks.check_datetime(expiration)
+        @due = StarkCore::Utils::Checks.check_datetime(due)
+        @expiration = StarkCore::Utils::Checks.check_datetime(expiration)
         @name = name
         @tax_id = tax_id
         @receiver_name = receiver_name

data/lib/payment_preview/brcode_preview.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
-require_relative('../utils/sub_resource')
 require_relative('../utils/rest')
-require_relative('../utils/checks')
+
 
 module StarkBank
   class PaymentPreview
@@ -26,7 +25,7 @@ module StarkBank
     # - reduction_amount [integer]: Current value reduction value in cents that this payment is expecting. ex: 123 (= R$1,23)
     # - discount_amount [integer]: Current discount value in cents that this payment is expecting. ex: 123 (= R$1,23)
     # - reconciliation_id [string]: Reconciliation ID linked to this payment. ex: 'txId', 'payment-123'
-    class BrcodePreview < StarkBank::Utils::SubResource
+    class BrcodePreview < StarkCore::Utils::SubResource
       attr_reader :status, :name, :tax_id, :bank_code, :branch_code, :account_number, :account_type, :allow_change, :amount, :nominal_amount, :interest_amount, :fine_amount, :reduction_amount, :discount_amount, :reconciliation_id
       def initialize(status:, name:, tax_id:, bank_code:, branch_code:, account_number:, account_type:, allow_change:, amount:, nominal_amount:, interest_amount:, fine_amount:, reduction_amount:, discount_amount:, reconciliation_id:)
         @status = status

data/lib/payment_preview/payment_preview.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require_relative('../utils/resource')
+require('starkcore')
 require_relative('../utils/rest')
-require_relative('../utils/checks')
+
 
 module StarkBank
   # # PaymentPreview object
@@ -10,16 +10,20 @@ module StarkBank
   # A PaymentPreview is used to get information from a payment code before confirming the payment.
   # This resource can be used to preview BR Codes and bar codes of boleto, tax and utility payments
   #
-  # ## Attributes (return-only):
+  # ## Parameters (required):
   # - id [string]: Main identification of the payment. This should be the BR Code for Pix payments and lines or bar codes for payment slips. ex: '34191.09008 63571.277308 71444.640008 5 81960000000062', '00020126580014br.gov.bcb.pix0136a629532e-7693-4846-852d-1bbff817b5a8520400005303986540510.005802BR5908T'Challa6009Sao Paulo62090505123456304B14A'
+  #
+  # ## Parameters (optional):
   # - scheduled [DateTime or string]: intended payment date. Right now, this parameter only has effect on BrcodePreviews. ex: '2020-04-30'
+  #
+  # ## Attributes (return-only):
   # - type [string]: Payment type. ex: 'brcode-payment', 'boleto-payment', 'utility-payment' or 'tax-payment'
   # - payment [BrcodePreview, BoletoPreview, UtilityPreview or TaxPreview]: Information preview of the informed payment.
-  class PaymentPreview < StarkBank::Utils::Resource
+  class PaymentPreview < StarkCore::Utils::Resource
     attr_reader :id, :scheduled, :type, :payment
     def initialize(id: nil, scheduled: nil, type: nil, payment: nil)
       super(id)
-      @scheduled = StarkBank::Utils::Checks.check_date(scheduled)
+      @scheduled = StarkCore::Utils::Checks.check_date(scheduled)
       @type = type
       @payment = payment
       return if type.nil?
@@ -31,7 +35,7 @@ module StarkBank
         'utility-payment': StarkBank::PaymentPreview::UtilityPreview.resource
       }[type.to_sym]
 
-      @payment = StarkBank::Utils::API.from_api_json(resource[:resource_maker], payment) unless resource.nil?
+      @payment = StarkCore::Utils::API.from_api_json(resource[:resource_maker], payment) unless resource.nil?
     end
 
     # # Create PaymentPreviews

data/lib/payment_preview/tax_preview.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
-require_relative('../utils/sub_resource')
 require_relative('../utils/rest')
-require_relative('../utils/checks')
+
 
 module StarkBank
   class PaymentPreview
@@ -16,7 +15,7 @@ module StarkBank
     # - description [string]: tax payment description. ex: "ISS Payment - Iron Throne"
     # - line [string]: Number sequence that identifies the payment. ex: "85660000006 6 67940064007 5 41190025511 7 00010601813 8"
     # - bar_code [string]: Bar code number that identifies the payment. ex: "85660000006679400640074119002551100010601813"
-    class TaxPreview < StarkBank::Utils::SubResource
+    class TaxPreview < StarkCore::Utils::SubResource
       attr_reader :amount, :name, :description, :line, :bar_code
       def initialize(amount:, name:, description:, line:, bar_code:)
         @amount = amount

data/lib/payment_preview/utility_preview.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
-require_relative('../utils/sub_resource')
 require_relative('../utils/rest')
-require_relative('../utils/checks')
+
 
 module StarkBank
   class PaymentPreview
@@ -16,7 +15,7 @@ module StarkBank
     # - description [string]: utility payment description. ex: "Utility Payment - Light Company"
     # - line [string]: Number sequence that identifies the payment. ex: "82660000002 8 44361143007 7 41190025511 7 00010601813 8"
     # - bar_code [string]: Bar code number that identifies the payment. ex: "82660000002443611430074119002551100010601813"
-    class UtilityPreview < StarkBank::Utils::SubResource
+    class UtilityPreview < StarkCore::Utils::SubResource
       attr_reader :amount, :name, :description, :line, :bar_code
       def initialize(amount:, name:, description:, line:, bar_code:)
         @amount = amount