starkinfra 0.6.0 → 0.7.0

data/lib/pix_key_holmes/log.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+require('starkcore')
+require_relative('../utils/rest')
+require_relative('pix_key_holmes')
+
+module StarkInfra
+  class PixKeyHolmes
+    # # PixKeyHolmes::Log object
+    #
+    # Every time a PixKeyHolmes entity is updated, a corresponding PixKeyHolmes::Log
+    # is generated for the entity. This log is never generated by the
+    # user, but it can be retrieved to check additional information
+    # on the PixKeyHolmes.
+    #
+    # ## Attributes (return-only):
+    # - id [string]: unique id returned when the log is created. ex: '5656565656565656'
+    # - holmes [PixKeyHolmes]: PixKeyHolmes entity to which the log refers to.
+    # - errors [list of strings]: list of errors linked to this PixKeyHolmes event.
+    # - type [string]: type of the PixKeyHolmes event which triggered the log creation. ex: 'solving', 'solved'
+    # - created [DateTime]: creation datetime for the log. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+    class Log < StarkCore::Utils::Resource
+      attr_reader :id, :created, :type, :errors, :holmes
+      def initialize(id:, created:, type:, errors:, holmes:)
+        super(id)
+        @holmes = holmes
+        @errors = errors
+        @type = type
+        @created = StarkCore::Utils::Checks.check_datetime(created)
+      end
+
+      # # Retrieve a specific PixKeyHolmes::Log
+      #
+      # Receive a single PixKeyHolmes::Log object previously created by the Stark Infra API by its id
+      #
+      # ## Parameters (required):
+      # - id [string]: object unique id. ex: '5656565656565656'
+      #
+      # ## Parameters (optional):
+      # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+      #
+      # ## Return:
+      # - PixKeyHolmes::Log object with updated attributes
+      def self.get(id, user: nil)
+        StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
+      end
+
+      # # Retrieve PixKeyHolmes::Logs
+      #
+      # Receive a generator of PixKeyHolmes::Log objects previously created in the Stark Infra API
+      #
+      # ## Parameters (optional):
+      # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+      # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
+      # - after [Date or string, default nil]: date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
+      # - before [Date or string, default nil]: date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
+      # - types [list of strings, default nil]: filter for log event types. ex: ['solving', 'solved']
+      # - holmes_ids [list of strings, default nil]: list of PixKeyHolmes ids to filter logs. ex: ['5656565656565656', '4545454545454545']
+      # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+      #
+      # ## Return:
+      # - generator of PixKeyHolmes::Log objects with updated attributes
+      def self.query(ids: nil, limit: nil, after: nil, before: nil, types: nil, holmes_ids: nil, user: nil)
+        after = StarkCore::Utils::Checks.check_date(after)
+        before = StarkCore::Utils::Checks.check_date(before)
+        StarkInfra::Utils::Rest.get_stream(
+          ids: ids,
+          limit: limit,
+          after: after,
+          before: before,
+          types: types,
+          holmes_ids: holmes_ids,
+          user: user,
+          **resource
+        )
+      end
+
+      # # Retrieve paged PixKeyHolmes::Logs
+      #
+      # Receive a list of up to 100 PixKeyHolmes::Log objects previously created in the Stark Infra API and the cursor to the next page.
+      # Use this function instead of query if you want to manually page your requests.
+      #
+      # ## Parameters (optional):
+      # - cursor [string, default nil]: cursor returned on the previous page function call
+      # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+      # - limit [integer, default 100]: maximum number of objects to be retrieved. Max = 100. ex: 35
+      # - after [Date or string, default nil]: date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
+      # - before [Date or string, default nil]: date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
+      # - types [list of strings, default nil]: filter for log event types. ex: ['solving', 'solved']
+      # - holmes_ids [list of strings, default nil]: list of PixKeyHolmes ids to filter logs. ex: ['5656565656565656', '4545454545454545']
+      # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+      #
+      # ## Return:
+      # - list of PixKeyHolmes::Log objects with updated attributes
+      # - cursor to retrieve the next page of PixKeyHolmes::Log objects
+      def self.page(cursor: nil, ids: nil, limit: nil, after: nil, before: nil, types: nil, holmes_ids: nil, user: nil)
+        after = StarkCore::Utils::Checks.check_date(after)
+        before = StarkCore::Utils::Checks.check_date(before)
+        StarkInfra::Utils::Rest.get_page(
+          cursor: cursor,
+          ids: ids,
+          limit: limit,
+          after: after,
+          before: before,
+          types: types,
+          holmes_ids: holmes_ids,
+          user: user,
+          **resource
+        )
+      end
+
+      def self.resource
+        holmes_maker = StarkInfra::PixKeyHolmes.resource[:resource_maker]
+        {
+          resource_name: 'PixKeyHolmesLog',
+          resource_maker: proc { |json|
+            Log.new(
+              id: json['id'],
+              holmes: StarkCore::Utils::API.from_api_json(holmes_maker, json['holmes']),
+              errors: json['errors'],
+              type: json['type'],
+              created: json['created']
+            )
+          }
+        }
+      end
+    end
+  end
+end

data/lib/pix_key_holmes/pix_key_holmes.rb

@@ -23,7 +23,7 @@ module StarkInfra
   # ## Attributes (return-only):
   # - id [string]: unique id returned when the PixKeyHolmes is created. ex: "5656565656565656"
   # - result [string]: investigation result once the case is solved. ex: "registered", "unregistered"
-  # - status [string]: current status of the PixKeyHolmes. ex: "created", "solving", "solved", "failed"
+  # - status [string]: current status of the PixKeyHolmes. ex: "solving", "solved"
   # - created [DateTime]: creation datetime for the PixKeyHolmes. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   # - updated [DateTime]: latest update datetime for the PixKeyHolmes. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   class PixKeyHolmes < StarkCore::Utils::Resource
@@ -41,7 +41,8 @@ module StarkInfra
 
     # # Create PixKeyHolmes
     #
-    # Send a list of PixKeyHolmes objects for creation at the Stark Infra API
+    # Send a list of PixKeyHolmes objects for creation at the Stark Infra API. You can create up to 100
+    # PixKeyHolmes in a single call.
     #
     # ## Parameters (required):
     # - holmes [list of PixKeyHolmes objects]: list of PixKeyHolmes objects to be created in the API.
@@ -55,6 +56,22 @@ module StarkInfra
       StarkInfra::Utils::Rest.post(entities: holmes, user: user, **resource)
     end
 
+    # # Retrieve a specific PixKeyHolmes
+    #
+    # Receive a single PixKeyHolmes object previously created in the Stark Infra API by its id
+    #
+    # ## Parameters (required):
+    # - id [string]: object unique id. ex: "5656565656565656"
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - PixKeyHolmes object with updated attributes
+    def self.get(id, user: nil)
+      StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
+    end
+
     # # Retrieve PixKeyHolmes
     #
     # Receive a generator of PixKeyHolmes objects previously created in the Stark Infra API

data/lib/pix_pull_request/pix_pull_request.rb

@@ -34,7 +34,7 @@ module StarkInfra
   #
   # ## Attributes (return-only):
   # - id [string]: unique id returned when the PixPullRequest is created. ex: '5656565656565656'
-  # - status [string]: current PixPullRequest status. Options: 'created', 'processing', 'scheduled', 'denied', 'success', 'canceled', 'expired'
+  # - status [string]: current PixPullRequest status. Options: 'created', 'processing', 'scheduled', 'denied', 'success', 'failed', 'canceled', 'expired'.
   # - flow [string]: direction of money flow. Options: 'in', 'out'
   # - receiver_name [string]: receiver's full name (filled in by the Pix infrastructure during settlement). ex: 'Edward Stark'
   # - receiver_tax_id [string]: receiver's tax ID (CPF or CNPJ). ex: '01234567890' or '20.018.183/0001-80'
@@ -85,7 +85,10 @@ module StarkInfra
 
     # # Create PixPullRequests
     #
-    # Send a list of PixPullRequest objects for creation in the Stark Infra API
+    # Send a list of 1 to 100 PixPullRequest objects for creation in the Stark Infra API. Stark Infra verifies
+    # that the parent subscription is approved, the amount is within its authorized limit, the settlement date
+    # matches the subscription's charge cycle, payer/receiver details match the contract, the request is made
+    # between 10 and 2 days before settlement, and there is no other scheduled request for the same cycle.
     #
     # ## Parameters (required):
     # - requests [list of PixPullRequest objects]: list of PixPullRequest objects to be created in the API
@@ -211,7 +214,7 @@ module StarkInfra
     #
     # ## Parameters (required):
     # - id [string]: PixPullRequest unique id. ex: '5656565656565656'
-    # - reason [string]: reason for the cancellation. As receiver: 'accountClosed', 'receiverOrganizationClosed', 'receiverInternalError', 'fraud', 'receiverUserRequested'. As sender: 'accountClosed', 'senderDeceased', 'fraud', 'senderUserRequested'.
+    # - reason [string]: cancellation reason. As sender: 'accountClosed', 'accountBlocked', 'pixRequestFailed', 'other', 'senderUserRequested'. As receiver: 'accountClosed', 'accountBlocked', 'other', 'receiverUserRequested'.
     #
     # ## Parameters (optional):
     # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call

data/lib/pix_pull_subscription/pix_pull_subscription.rb

@@ -2,6 +2,7 @@
 
 require('starkcore')
 require_relative('../utils/rest')
+require_relative('../utils/parse')
 
 module StarkInfra
   # # PixPullSubscription object
@@ -192,9 +193,9 @@ module StarkInfra
 
     # # Update PixPullSubscriptions
     #
-    # A Pix Subscription can be patched for three distinct purposes - to update, confirm or deny it.
-    # As the receiver, you can approve or deny the subscription if the subscription type is 'subscriptionAndPayment'.
-    # As the sender, you can confirm or deny a delivered subscription.
+    # A PixPullSubscription can be patched to approve, deny or activate it. As the payer (sender), you may set
+    # status to 'approved' or 'denied'. As the receiver, you may set status to 'active' once approved. When
+    # confirming (approving), include sender_city_code.
     #
     # ## Parameters (required):
     # - id [string]: PixPullSubscription unique id. ex: '5656565656565656'
@@ -203,7 +204,7 @@ module StarkInfra
     #     - status [string]: new status of the Pix Subscription.
     #     ## Parameters (conditionally-required):
     #     - sender_city_code [string]: IBGE code of the payer's city. Required if you are confirming the subscription.
-    #     - reason [string]: reason why the Pix Subscription is being patched. Options: 'accountClosed', 'accountBlocked', 'invalidBranchCode', 'notRecognizedBySender', 'userRejected', 'notOffered'
+    #     - reason [string]: reason why the PixPullSubscription is being patched. Options: 'invalidSenderAccountNumber', 'accountClosed', 'accountBlocked', 'invalidBranchCode', 'notRecognizedBySender', 'userRejected', 'notOffered'.
     #
     # ## Parameters (optional):
     # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
@@ -222,7 +223,7 @@ module StarkInfra
     #
     # ## Parameters (required):
     # - id [string]: PixPullSubscription unique id. ex: '5656565656565656'
-    # - reason [string]: reason for the cancellation. As receiver: 'accountClosed', 'receiverOrganizationClosed', 'receiverInternalError', 'fraud', 'receiverUserRequested'. As sender: 'accountClosed', 'senderDeceased', 'fraud', 'senderUserRequested'.
+    # - reason [string, default nil]: reason for the cancellation. Options: 'accountClosed', 'receiverOrganizationClosed', 'receiverInternalError', 'senderDeceased', 'fraud', 'senderUserRequested', 'receiverUserRequested', 'paymentNotFound'.
     #
     # ## Parameters (optional):
     # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
@@ -240,6 +241,31 @@ module StarkInfra
       StarkCore::Utils::API.from_api_json(maker, response.json['subscription'])
     end
 
+    # # Create a single verified PixPullSubscription object from a content string
+    #
+    # Create a single PixPullSubscription object from a content string received from a handler listening at the subscription url.
+    # If the provided digital signature does not check out with the StarkInfra public key, a
+    # StarkInfra::Error::InvalidSignatureError will be raised.
+    #
+    # ## Parameters (required):
+    # - content [string]: response content from request received at user endpoint (not parsed)
+    # - signature [string]: base-64 digital signature received at response header 'Digital-Signature'
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - Parsed PixPullSubscription object
+    def self.parse(content:, signature:, user: nil)
+      StarkInfra::Utils::Parse.parse_and_verify(
+        content: content,
+        signature: signature,
+        user: user,
+        key: nil,
+        resource: resource
+      )
+    end
+
     def self.resource
       {
         resource_name: 'PixPullSubscription',

data/lib/pix_request/pix_request.rb

@@ -35,7 +35,7 @@ module StarkInfra
   # - cashier_bank_code [string]: Cashier's bank code. Required if the cash_amount is different from 0. ex: '20018183'
   #
   # ## Parameters (optional):
-  # - cash_amount [integer, default nil]: Amount to be withdrawal from the cashier in cents. ex: 1000 (= R$ 10.00)
+  # - cash_amount [integer, default nil]: amount to be withdrawn from the cashier in cents for Pix Saque/Troco; must be less than or equal to amount. ex: 1000 (= R$ 10.00)
   # - receiver_key_id [string, default nil]: Receiver's dict key. Example: tax id (CPF/CNPJ).
   # - description [string, default nil]: optional description to override default description to be shown in the bank statement. ex: 'Payment for service #1234'
   # - reconciliation_id [string, default nil]: Reconciliation ID linked to this payment. ex: 'b77f5236-7ab9-4487-9f95-66ee6eaf1781'
@@ -43,12 +43,15 @@ module StarkInfra
   # - tags [list of strings, default nil]: list of strings for reference when searching for PixRequests. ex: ['employees', 'monthly']
   # - method [string, default nil]: execution method of creation of the Pix. ex: 'manual', 'payerQrcode', 'dynamicQrcode'.
   # - priority priority [string, default 'high']: Specifies the message channel used to send the Pix Request. If set to 'high', the request is sent through the primary channel; if set to 'low', it uses the secondary channel. Options: 'high' or 'low'
-  # - reason [string, default 'customerRequest']: underlying reason for the payment transaction. ex: 'customerRequest', 'fraud', 'subscriptionFlaw'
+  # - reason [string, default 'customerRequest']: underlying reason for the payment transaction. Options: 'customerRequest', 'subscriptionFlaw', 'fraud'. When reason is 'fraud' (returning funds from a PixDispute), dispute_id is required and sender_tax_id must be your institution's organization tax ID (CNPJ).
+  #
+  # ## Parameters (conditionally-required):
+  # - dispute_id [string, default nil]: Id of the Pix Dispute being refunded. Required when reason is 'fraud' and not allowed with any other reason. The dispute must be one you received and must be awaiting the refund, otherwise the request is refused with invalidDisputeId.
   #
   # ## Attributes (return-only):
   # - id [string]: unique id returned when the PixRequest is created. ex: '5656565656565656'
   # - fee [integer]: fee charged when PixRequest is paid. ex: 200 (= R$ 2.00)
-  # - status [string]: current PixRequest status. ex: 'registered' or 'paid'
+  # - status [string]: current PixRequest status. Options: 'created', 'processing', 'success', 'failed'.
   # - flow [string]: direction of money flow. ex: 'in' or 'out'
   # - sender_bank_code [string]: code of the sender bank institution in Brazil. ex: '20018183'
   # - created [DateTime]: creation datetime for the PixRequest. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
@@ -58,13 +61,13 @@ module StarkInfra
                 :sender_account_type, :receiver_name, :receiver_tax_id, :receiver_bank_code, :receiver_account_number,
                 :receiver_branch_code, :receiver_account_type, :end_to_end_id, :cashier_type,
                 :cashier_bank_code, :cash_amount, :receiver_key_id, :description, :reconciliation_id, :initiator_tax_id,
-                :tags, :method, :priority, :reason, :id, :fee, :status, :flow, :sender_bank_code, :created, :updated
+                :tags, :method, :priority, :reason, :dispute_id, :id, :fee, :status, :flow, :sender_bank_code, :created, :updated
     def initialize(
       amount:, external_id:, sender_name:, sender_tax_id:, sender_branch_code:, sender_account_number:, 
       sender_account_type:, receiver_name:, receiver_tax_id:, receiver_bank_code:, receiver_account_number:, 
       receiver_branch_code:, receiver_account_type:, end_to_end_id:, cashier_type: nil, cashier_bank_code: nil,
       cash_amount: nil, receiver_key_id: nil, description: nil, reconciliation_id: nil, initiator_tax_id: nil,
-      tags: nil, method: nil, priority: nil, reason: nil, id: nil, fee: nil, status:nil, flow: nil, sender_bank_code: nil,
+      tags: nil, method: nil, priority: nil, reason: nil, dispute_id: nil, id: nil, fee: nil, status:nil, flow: nil, sender_bank_code: nil,
       created: nil, updated: nil
     )
       super(id)
@@ -93,6 +96,7 @@ module StarkInfra
       @method = method
       @priority = priority
       @reason = reason
+      @dispute_id = dispute_id
       @fee = fee
       @status = status
       @flow = flow
@@ -221,7 +225,7 @@ module StarkInfra
     # ## Return:
     # - Parsed PixRequest object
     def self.parse(content:, signature:, user: nil)
-      request = StarkCore::Utils::Parse.parse_and_verify(content: content, signature: signature, user: user, resource: resource)
+      request = StarkInfra::Utils::Parse.parse_and_verify(content: content, signature: signature, user: user, resource: resource)
 
       !request.fee.nil? ? request.fee : 0
       !request.tags.nil? ? request.tags : []
@@ -231,7 +235,8 @@ module StarkInfra
       request
     end
 
-    # Helps you respond to a PixRequest authorization
+    # Helps you respond to a PixRequest authorization. You must answer within 1 second with HTTP status 200,
+    # or the request is denied by default.
     #
     ## Parameters (required):
     # - status [string]: response to the authorization. ex: 'approved' or 'denied'
@@ -283,6 +288,7 @@ module StarkInfra
             method: json['method'],
             priority: json['priority'],
             reason: json['reason'],
+            dispute_id: json['dispute_id'],
             fee: json['fee'],
             status: json['status'],
             flow: json['flow'],

data/lib/pix_reversal/pix_reversal.rb

@@ -18,7 +18,7 @@ module StarkInfra
   # - amount [integer]: amount in cents to be reversed from PixRequest. ex: 1234 (= R$ 12.34)
   # - external_id [string]: string that must be unique among all your PixReversals. Duplicated external IDs will cause failures. By default, this parameter will block any PixReversal that repeats amount and receiver information on the same date. ex: 'my-internal-id-123456'
   # - end_to_end_id [string]: central bank's unique transaction ID. ex: 'E79457883202101262140HHX553UPqeq'
-  # - reason [string]: reason why the PixRequest is being reversed. Options are 'bankError', 'fraud', 'pixWithdrawError', 'refund3ByEndCustomer'
+  # - reason [string]: reason why the PixReversal is being reversed. Options are 'bankError', 'fraud', 'cashierError', 'customerRequest'.
   #
   # ## Parameters (optional):
   # - tags [list of strings, default nil]: list of strings for reference when searching for PixReversals. ex: ['employees', 'monthly']
@@ -27,16 +27,17 @@ module StarkInfra
   # - id [string]: unique id returned when the PixReversal is created. ex: '5656565656565656'.
   # - return_id [string]: central bank's unique reversal transaction ID. ex: 'D20018183202202030109X3OoBHG74wo'.
   # - fee [string]: fee charged by this PixReversal. ex: 200 (= R$ 2.00)
-  # - status [string]: current PixReversal status. ex: 'registered' or 'paid'
+  # - status [string]: current PixReversal status. Options are 'created', 'processing', 'success' or 'failed'.
   # - flow [string]: direction of money flow. ex: 'in' or 'out'
   # - created [DateTime]: creation datetime for the PixReversal. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   # - updated [DateTime]: latest update datetime for the PixReversal. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - description [string]: description of the reversal.
   class PixReversal < StarkCore::Utils::Resource
     attr_reader :amount, :external_id, :end_to_end_id, :reason, :tags, :id, :return_id,
-                :fee, :status, :flow, :created, :updated
+                :fee, :status, :flow, :created, :updated, :description
     def initialize(
       amount:, external_id:, end_to_end_id:, reason:, tags: nil, id: nil, return_id: nil, fee: nil,
-      status: nil, flow: nil, created: nil, updated: nil
+      status: nil, flow: nil, created: nil, updated: nil, description: nil
     )
       super(id)
       @amount = amount
@@ -50,11 +51,13 @@ module StarkInfra
       @flow = flow
       @created = StarkCore::Utils::Checks.check_datetime(created)
       @updated = StarkCore::Utils::Checks.check_datetime(updated)
+      @description = description
     end
 
     # # Create PixReversals
     #
-    # Send a list of PixReversal objects for creation in the Stark Infra API
+    # Send a list of PixReversal objects for creation in the Stark Infra API. Reversals can only be created
+    # for inbound PixRequests with status 'success'; reference the original request by its end_to_end_id.
     #
     # ## Parameters (required):
     # - reversals [list of PixReversal objects]: list of PixReversal objects to be created in the API
@@ -170,7 +173,7 @@ module StarkInfra
     # ## Return:
     # - Parsed PixReversal object
     def self.parse(content:, signature:, user: nil)
-      reversal = StarkCore::Utils::Parse.parse_and_verify(
+      reversal = StarkInfra::Utils::Parse.parse_and_verify(
         content: content,
         signature: signature,
         user: user,
@@ -185,7 +188,9 @@ module StarkInfra
       reversal
     end
 
-    # Helps you respond to a PixReversal authorization
+    # Helps you respond to a PixReversal authorization sent to your pixReversalUrl (must differ from your
+    # pixRequestUrl). Answer within 1 second with HTTP 200, or it is denied by default; if no pixReversalUrl
+    # is registered, inbound reversals are accepted by default.
     #
     ## Parameters (required):
     # - status [string]: response to the authorization. ex: 'approved' or 'denied'
@@ -222,7 +227,8 @@ module StarkInfra
             status: json['status'],
             flow: json['flow'],
             created: json['created'],
-            updated: json['updated']
+            updated: json['updated'],
+            description: json['description']
           )
         }
       }

data/lib/pix_statement/pix_statement.rb

@@ -22,13 +22,17 @@ module StarkInfra
   #
   # ## Attributes (return-only):
   # - id [string]: unique id returned when the PixStatement is created. ex: '5656565656565656'
-  # - status [string]: current PixStatement status. ex: 'success' or 'failed'
+  # - status [string]: current PixStatement status. Options: 'created', 'looking', 'success', 'failed'.
   # - transaction_count [integer]: number of transactions that happened during the day that the PixStatement was requested. ex: 11
   # - created [DateTime]: creation datetime for the PixStatement. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   # - updated [DateTime]: latest update datetime for the PixStatement. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - chunk_count [integer]: number of chunks the statement file is split into. ex: 2
   class PixStatement < StarkCore::Utils::Resource
-    attr_reader :after, :before, :type, :id, :status, :transaction_count, :created, :updated
-    def initialize(after:, before:, type:, id: nil, status: nil, transaction_count: nil, created: nil, updated: nil)
+    attr_reader :after, :before, :type, :id, :status, :transaction_count, :created, :updated, :chunk_count
+    def initialize(
+      after:, before:, type:, id: nil, status: nil, transaction_count: nil, created: nil, updated: nil,
+      chunk_count: nil
+    )
       super(id)
       @after = StarkCore::Utils::Checks.check_date(after)
       @before = StarkCore::Utils::Checks.check_date(before)
@@ -37,6 +41,7 @@ module StarkInfra
       @transaction_count = transaction_count
       @created = StarkCore::Utils::Checks.check_datetime(created)
       @updated = StarkCore::Utils::Checks.check_datetime(updated)
+      @chunk_count = chunk_count
     end
 
     # # Create a PixStatement object
@@ -117,7 +122,7 @@ module StarkInfra
 
     # # # Retrieve a .cvs PixStatement
     #
-    # Retrieve a specific PixStatement by its ID in a .csv file.
+    # Retrieve a specific PixStatement's CSV file by its ID. The file is returned compressed in gzip format.
     #
     # ## Parameters (required):
     # - id [string]: object unique id. ex: '5656565656565656'
@@ -143,7 +148,8 @@ module StarkInfra
             status: json['status'],
             transaction_count: json['transaction_count'],
             created: json['created'],
-            updated: json['updated']
+            updated: json['updated'],
+            chunk_count: json['chunk_count']
           )
         }
       }

data/lib/pix_user/pix_user.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require('starkcore')
+require_relative('../utils/rest')
+
+module StarkInfra
+  # # PixUser object
+  #
+  # Pix Users are used to get fraud statistics of a user.
+  #
+  # ## Parameters (required):
+  # - id [string]: user tax ID (CPF or CNPJ) with or without formatting. ex: '01234567890' or '20.018.183/0001-80'
+  #
+  # ## Attributes (return-only):
+  # - statistics [list of PixUser::Statistics, default []]: list of PixUser::Statistics objects. ex: [PixUser::Statistics.new(after: '2023-11-06T18:57:08.325090+00:00', source: 'pix-key')]
+  class PixUser < StarkCore::Utils::Resource
+    attr_reader :id, :statistics
+    def initialize(id:, statistics: nil)
+      super(id)
+      @statistics = StarkInfra::PixUser::Statistics.parse_statistics(statistics)
+    end
+
+    # # Retrieve a PixUser object
+    #
+    # Receive a single PixUser object information by passing its taxId
+    #
+    # ## Parameters (required):
+    # - id [string]: user tax ID (CPF or CNPJ) with or without formatting. ex: '01234567890' or '20.018.183/0001-80'
+    #
+    # ## Parameters (optional):
+    # - key_id [string, default nil]: marked PixKey id. ex: '+5511989898989'
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - PixUser object that corresponds to the given id.
+    def self.get(id, key_id: nil, user: nil)
+      StarkInfra::Utils::Rest.get_id(id: id, key_id: key_id, user: user, **resource)
+    end
+
+    def self.resource
+      {
+        resource_name: 'PixUser',
+        resource_maker: proc { |json|
+          PixUser.new(
+            id: json['id'],
+            statistics: json['statistics']
+          )
+        }
+      }
+    end
+  end
+end

data/lib/pix_user/statistics.rb

@@ -0,0 +1,64 @@
+require_relative('../utils/rest')
+
+module StarkInfra
+  class PixUser
+    # # PixUser::Statistics object
+    #
+    # The PixUser::Statistics object stores fraud statistics data of a Pix user.
+    #
+    # ## Attributes (return-only):
+    # - value [integer]: aggregated value of the statistic. ex: 3
+    # - type [string]: type of the statistic. ex: 'infractions'
+    # - source [string]: source of the statistic. ex: 'keyManagement'
+    # - after [DateTime]: start datetime considered for the statistic aggregation. ex: DateTime.new(2020, 4, 23, 23, 0, 0)
+    # - updated [DateTime]: latest update datetime for the statistic. ex: DateTime.new(2020, 4, 23, 23, 0, 0)
+    class Statistics < StarkCore::Utils::SubResource
+      attr_reader :value, :type, :source, :after, :updated
+      def initialize(value: nil, type: nil, source: nil, after: nil, updated: nil)
+        @value = value
+        @type = type
+        @source = source
+        @after = StarkCore::Utils::Checks.check_datetime(after)
+        @updated = StarkCore::Utils::Checks.check_datetime(updated)
+      end
+
+      # # Parse PixUser::Statistics
+      #
+      # Converts a list of hashes (or Statistics objects) received from the API into a list of PixUser::Statistics objects.
+      #
+      # ## Parameters (required):
+      # - statistics [list of hashes or PixUser::Statistics objects]: list to be parsed.
+      #
+      # ## Return:
+      # - list of parsed PixUser::Statistics objects
+      def self.parse_statistics(statistics)
+        resource_maker = StarkInfra::PixUser::Statistics.resource[:resource_maker]
+        return statistics if statistics.nil?
+
+        parsed_statistics = []
+        statistics.each do |statistic|
+          unless statistic.is_a? Statistics
+            statistic = StarkCore::Utils::API.from_api_json(resource_maker, statistic)
+          end
+          parsed_statistics << statistic
+        end
+        return parsed_statistics
+      end
+
+      def self.resource
+      {
+        resource_name: 'Statistics',
+        resource_maker: proc { |json|
+          Statistics.new(
+            value: json['value'],
+            type: json['type'],
+            source: json['source'],
+            after: json['after'],
+            updated: json['updated']
+          )
+        }
+      }
+      end
+    end
+  end
+end