starkinfra 0.0.2 → 0.0.3

data/lib/pixchargeback/pixchargeback.rb

@@ -0,0 +1,225 @@
+# frozen_string_literal: true
+
+require_relative('../utils/resource')
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+
+module StarkInfra
+  # # PixChargeback object
+  #
+  # A Pix chargeback can be created when fraud is detected on a transaction or a system malfunction
+  # results in an erroneous transaction.
+  # It notifies another participant of your request to reverse the payment they have received.
+  # When you initialize a PixChargeback, the entity will not be automatically
+  # created in the Stark Infra API. The 'create' function sends the objects
+  #
+  # ## Parameters (required):
+  # - amount [integer]: amount in cents to be reversed. ex: 11234 (= R$ 112.34)
+  # - reference_id [string]: end_to_end_id or return_id of the transaction to be reversed. ex: 'E20018183202201201450u34sDGd19lz'
+  # - reason [string]: reason why the reversal was requested. Options: 'fraud', 'flaw', 'reversalChargeback'
+  #
+  # ## Parameters (optional):
+  # - description [string, default nil]: description for the PixChargeback. ex: 'Payment for service #1234'
+  #
+  # ## Attributes (return-only):
+  # - id [string]: unique id returned when PixChargeback is created. ex: '5656565656565656'
+  # - analysis [string]: analysis that led to the result.
+  # - bacen_id [string]: central bank's unique UUID that identifies the PixChargeback.
+  # - sender_bank_code [string]: bank_code of the Pix participant that created the PixChargeback. ex: '20018183'
+  # - receiver_bank_code [string]: bank_code of the Pix participant that received the PixChargeback. ex: '20018183'
+  # - rejection_reason [string]: reason for the rejection of the Pix chargeback. Options: 'noBalance', 'accountClosed', 'unableToReverse'
+  # - reversal_reference_id [string]: return id of the reversal transaction. ex: 'D20018183202202030109X3OoBHG74wo'.
+  # - id [string]: unique id returned when the PixChargeback is created. ex: '5656565656565656'
+  # - result [string]: result after the analysis of the PixChargeback by the receiving party. Options: 'rejected', 'accepted', 'partiallyAccepted'
+  # - status [string]: current PixChargeback status. Options: 'created', 'failed', 'delivered', 'closed', 'canceled'.
+  # - created [DateTime]: creation datetime for the PixChargeback. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - updated [DateTime]: latest update datetime for the PixChargeback. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  class PixChargeback < StarkInfra::Utils::Resource
+    attr_reader :amount, :reference_id, :reason, :description, :id, :analysis, :bacen_id, :sender_bank_code,
+                :receiver_bank_code, :rejection_reason, :reversal_reference_id, :result, :status, :created, :updated
+    def initialize(
+      amount:, reference_id:, reason:, description: nil, id: nil, analysis: nil, bacen_id: nil,
+      sender_bank_code: nil, receiver_bank_code: nil, rejection_reason: nil, reversal_reference_id: nil,
+      result: nil, status: nil, created: nil, updated: nil
+    )
+      super(id)
+      @amount = amount
+      @reference_id = reference_id
+      @reason = reason
+      @description = description
+      @analysis = analysis
+      @bacen_id = bacen_id
+      @sender_bank_code = sender_bank_code
+      @receiver_bank_code = receiver_bank_code
+      @rejection_reason = rejection_reason
+      @reversal_reference_id = reversal_reference_id
+      @result = result
+      @status = status
+      @created = StarkInfra::Utils::Checks.check_datetime(created)
+      @updated = StarkInfra::Utils::Checks.check_datetime(updated)
+    end
+
+    # # Create PixChargebacks
+    #
+    # Send a list of PixChargeback objects for creation in the Stark Infra API
+    #
+    # ## Parameters (required):
+    # - chargebacks [list of PixChargeback objects]: list of PixChargeback objects to be created in the API. ex: [PixChargeback.new()]
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - list of PixChargeback objects with updated attributes
+    def self.create(chargebacks, user: nil)
+      StarkInfra::Utils::Rest.post(entities: chargebacks, user: user, **resource)
+    end
+
+    # # Retrieve a specific PixChargeback
+    #
+    # Receive a single PixChargeback object previously created in the Stark Infra API by passing 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:
+    # - PixChargeback object with updated attributes
+    def self.get(id, user: nil)
+      StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
+    end
+
+    # # Retrieve PixChargebacks
+    #
+    # Receive a generator of PixChargeback objects previously created in the Stark Infra API
+    #
+    # ## Parameters (optional):
+    # - 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 or updated only after specified date. ex: Date.new(2020, 3, 10)
+    # - before [Date or string, default nil]: date filter for objects created or updated only before specified date. ex: Date.new(2020, 3, 10)
+    # - status [string, default nil]: filter for status of retrieved objects. ex: 'success' or 'failed'
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. 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 PixChargeback objects with updated attributes
+    def self.query(limit: nil, after: nil, before: nil, status: nil, ids: nil, user: nil)
+      after = StarkInfra::Utils::Checks.check_date(after)
+      before = StarkInfra::Utils::Checks.check_date(before)
+      StarkInfra::Utils::Rest.get_stream(
+        limit: limit,
+        after: after,
+        before: before,
+        status: status,
+        ids: ids,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Retrieve paged PixChargebacks
+    #
+    # Receive a list of up to 100 PixChargeback 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 chargebacks.
+    #
+    # ## Parameters (optional):
+    # - cursor [string, default nil]: cursor returned on the previous page function call
+    # - 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 or updated only after specified date. ex: Date.new(2020, 3, 10)
+    # - before [Date or string, default nil]: date filter for objects created or updated only before specified date. ex: Date.new(2020, 3, 10)
+    # - status [string, default nil]: filter for status of retrieved objects. ex: 'success' or 'failed'
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. 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 PixChargeback objects with updated attributes
+    # - cursor to retrieve the next page of PixChargeback objects
+    def self.page(cursor: nil, limit: nil, after: nil, before: nil, status: nil, ids: nil, user: nil)
+      after = StarkInfra::Utils::Checks.check_date(after)
+      before = StarkInfra::Utils::Checks.check_date(before)
+      StarkInfra::Utils::Rest.get_page(
+        cursor: cursor,
+        limit: limit,
+        after: after,
+        before: before,
+        status: status,
+        ids: ids,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Update a PixChargeback entity
+    #
+    # Respond to a received PixChargeback.
+    #
+    # ## Parameters (required):
+    # - id [string]: PixChargeback unique id. ex: '5656565656565656'
+    # - result [string]: result of the PixChargeback. Options: 'rejected', 'accepted', 'partiallyAccepted'.
+    #
+    # ## Parameters (conditionally required):
+    # - rejection_reason [string, default nil]: if the PixChargeback is rejected a reason is required. Options: 'noBalance', 'accountClosed', 'unableToReverse',
+    # - reversal_reference_id [string, default nil]: return_id of the reversal transaction. ex: 'D20018183202201201450u34sDGd19lz'
+    #
+    # ## Parameters (optional):
+    # - analysis [string, default nil]: description of the analysis that led to the result.
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - updated PixChargeback object
+    def self.update(id, result:, rejection_reason: nil, reversal_reference_id: nil, analysis: nil, user: nil)
+      StarkInfra::Utils::Rest.patch_id(
+        id: id,
+        result: result,
+        rejection_reason: rejection_reason,
+        analysis: analysis,
+        reversal_reference_id: reversal_reference_id,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Cancel a PixChargeback entity
+    #
+    # Cancel a PixChargeback entity previously created in the Stark Infra API
+    #
+    # ## Parameters (required):
+    # - id [string]: PixChargeback 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:
+    # - canceled PixChargeback object
+    def self.cancel(id, user: nil)
+      StarkInfra::Utils::Rest.delete_id(id: id, user: user, **resource)
+    end
+
+    def self.resource
+      {
+        resource_name: 'PixChargeback',
+        resource_maker: proc { |json|
+          PixChargeback.new(
+            amount: json['amount'],
+            reference_id: json['reference_id'],
+            reason: json['reason'],
+            description: json['description'],
+            id: json['id'],
+            analysis: json['analysis'],
+            bacen_id: json['bacen_id'],
+            sender_bank_code: json['sender_bank_code'],
+            receiver_bank_code: json['receiver_bank_code'],
+            rejection_reason: json['rejection_reason'],
+            reversal_reference_id: json['reversal_reference_id'],
+            result: json['result'],
+            status: json['status'],
+            created: json['created'],
+            updated: json['updated']
+          )
+        }
+      }
+    end
+  end
+end

data/lib/pixclaim/log.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+require_relative('../utils/resource')
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+require_relative('pixclaim')
+
+module StarkInfra
+  class PixClaim
+    # # PixClaim::Log object
+    #
+    # Every time a PixClaim entity is modified, a corresponding PixClaim::Log
+    # is generated for the entity. This log is never generated by the
+    # user.
+    #
+    # ## Attributes:
+    # - id [string]: unique id returned when the log is created. ex: '5656565656565656'
+    # - created [DateTime]: creation datetime for the log. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+    # - type [string]: type of the PixClaim event which triggered the log creation. Options: 'created', 'failed', 'delivering', 'delivered', 'confirming', 'confirmed', 'success', 'canceling', 'canceled'.
+    # - errors [list of strings]: list of errors linked to this PixClaim event.
+    # - agent [string]: agent that modified the PixClaim resulting in the Log. Options: 'claimer', 'claimed'.
+    # - reason [string]: reason why the PixClaim was modified, resulting in the Log. Options: 'fraud', 'userRequested', 'accountClosure', 'defaultOperation', 'reconciliation'
+    # - claim [PixClaim]: PixClaim entity to which the log refers to.
+    class Log < StarkInfra::Utils::Resource
+      attr_reader :id, :created, :type, :errors, :agent, :reason, :claim
+      def initialize(id:, created:, type:, errors:, agent:, reason:, claim:)
+        super(id)
+        @created = StarkInfra::Utils::Checks.check_datetime(created)
+        @type = type
+        @errors = errors
+        @agent = agent
+        @reason = reason
+        @claim = claim
+      end
+
+      # # Retrieve a specific Log
+      #
+      # Receive a single Log object previously created by the Stark Infra API by passing 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:
+      # - Log object with updated attributes
+      def self.get(id, user: nil)
+        StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
+      end
+
+      # # Retrieve Logs
+      #
+      # Receive a generator of Log objects previously created in the Stark Infra API
+      #
+      # ## Parameters (optional):
+      # - ids [list of strings, default nil]: Log ids to filter PixClaim Logs. ex: ['5656565656565656']
+      # - 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]: filter PixClaim Logs by their types. Options: 'created', 'failed', 'delivering', 'delivered', 'confirming', 'confirmed', 'success', 'canceling', 'canceled'.
+      # - claim_ids [list of strings, default nil]: list of PixClaim ids to filter retrieved objects. ex: %w[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 Log objects with updated attributes
+      def self.query(ids: nil, limit: nil, after: nil, before: nil, types: nil, claim_ids: nil, user: nil)
+        after = StarkInfra::Utils::Checks.check_date(after)
+        before = StarkInfra::Utils::Checks.check_date(before)
+        StarkInfra::Utils::Rest.get_stream(
+          ids: ids,
+          limit: limit,
+          after: after,
+          before: before,
+          types: types,
+          claim_ids: claim_ids,
+          user: user,
+          **resource
+        )
+      end
+
+      # # Retrieve paged Logs
+      #
+      # Receive a list of up to 100 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 claims.
+      #
+      # ## Parameters (optional):
+      # - ids [list of strings, default nil]: Log ids to filter PixClaim Logs. ex: ['5656565656565656']
+      # - cursor [string, default nil]: cursor returned on the previous page function call
+      # - 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]: filter PixClaim Logs by their types. Options: 'created', 'failed', 'delivering', 'delivered', 'confirming', 'confirmed', 'success', 'canceling', 'canceled'.
+      # - claim_ids [list of strings, default nil]: list of PixClaim ids to filter retrieved objects. ex: %w[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 Log objects with updated attributes
+      # - cursor to retrieve the next page of Log objects
+      def self.page(cursor: nil, ids: nil, limit: nil, after: nil, before: nil, types: nil, claim_ids: nil, user: nil)
+        after = StarkInfra::Utils::Checks.check_date(after)
+        before = StarkInfra::Utils::Checks.check_date(before)
+        StarkInfra::Utils::Rest.get_page(
+          cursor: cursor,
+          ids: ids,
+          limit: limit,
+          after: after,
+          before: before,
+          types: types,
+          claim_ids: claim_ids,
+          user: user,
+          **resource
+        )
+      end
+
+      def self.resource
+        claim_maker = StarkInfra::PixClaim.resource[:resource_maker]
+        {
+          resource_name: 'PixClaimLog',
+          resource_maker: proc { |json|
+            Log.new(
+              id: json['id'],
+              created: json['created'],
+              type: json['type'],
+              errors: json['errors'],
+              agent: json['agent'],
+              reason: json['reason'],
+              claim: StarkInfra::Utils::API.from_api_json(claim_maker, json['claim'])
+            )
+          }
+        }
+      end
+    end
+  end
+end

data/lib/pixclaim/pixclaim.rb

@@ -0,0 +1,225 @@
+# frozen_string_literal: true
+
+require_relative('../utils/resource')
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+
+module StarkInfra
+  # # PixClaim object
+  #
+  # PixClaims intend to transfer a PixClaim from one account to another.
+  # When you initialize a PixClaim, the entity will not be automatically
+  # created in the Stark Infra API. The 'create' function sends the objects
+  # to the Stark Infra API and returns the created object.
+  #
+  # ## Parameters (required):
+  # - account_created [Date, DateTime or string]: opening Date or DateTime for the account claiming the PixClaim. ex: '2022-01-01'.
+  # - account_number [string]: number of the account claiming the PixClaim. ex: '76543'.
+  # - account_type [string]: type of the account claiming the PixClaim. Options: 'checking', 'savings', 'salary' or 'payment'.
+  # - branch_code [string]: branch code of the account claiming the PixClaim. ex: 1234'.
+  # - name [string]: holder's name of the account claiming the PixClaim. ex: 'Jamie Lannister'.
+  # - tax_id [string]: holder's taxId of the account claiming the PixClaim (CPF/CNPJ). ex: '012.345.678-90'.
+  # - key_id [string]: id of the registered Pix Key to be claimed. Allowed keyTypes are CPF, CNPJ, phone number or email. ex: '+5511989898989'.
+  #
+  # ## Attributes (return-only):
+  # - id [string]: unique id returned when the PixClaim is created. ex: '5656565656565656'
+  # - status [string]: current PixClaim status. Options: 'created', 'failed', 'delivered', 'confirmed', 'success', 'canceled'
+  # - type [string]: type of Pix Claim. Options: 'ownership', 'portability'.
+  # - key_type [string]: keyType of the claimed Pix Key. Options: 'CPF', 'CNPJ', 'phone' or 'email'
+  # - agent [string]: Options: 'claimer' if you requested the PixClaim or 'claimed' if you received a PixClaim request.
+  # - bank_code [string]: bank_code of the account linked to the PixClaim being claimed. ex: '20018183'.
+  # - claimed_bank_code [string]: bank_code of the account donating the PixClaim. ex: '20018183'.
+  # - created [DateTime]: creation datetime for the PixClaim. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - updated [DateTime]: update datetime for the PixClaim. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  class PixClaim < StarkInfra::Utils::Resource
+    attr_reader :account_created, :account_number, :account_type, :branch_code, :name, :tax_id, :key_id, :id, :status, :type, :key_type, :agent, :bank_code, :claimed_bank_code, :created, :updated
+    def initialize(
+      account_created:, account_number:, account_type:, branch_code:, name:,
+      tax_id:, key_id:, id: nil, status: nil, type: nil, key_type: nil, agent: nil,
+      bank_code: nil, claimed_bank_code: nil, created: nil, updated: nil
+    )
+      super(id)
+      @account_created = account_created
+      @account_number = account_number
+      @account_type = account_type
+      @branch_code = branch_code
+      @name = name
+      @tax_id = tax_id
+      @key_id = key_id
+      @status = status
+      @type = type
+      @key_type = key_type
+      @agent = agent
+      @bank_code = bank_code
+      @claimed_bank_code = claimed_bank_code
+      @created = StarkInfra::Utils::Checks.check_datetime(created)
+      @updated = StarkInfra::Utils::Checks.check_datetime(updated)
+    end
+
+    # # Create a PixClaim
+    #
+    # Send a PixClaim object for creation in the Stark Infra API
+    #
+    # ## Parameters (required):
+    # - claim [PixClaim object]: PixClaim object to be created in the API. ex: PixClaim.new()
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - PixClaim object with updated attributes
+    def self.create(claim, user: nil)
+      StarkInfra::Utils::Rest.post_single(entity: claim, user: user, **resource)
+    end
+
+    # # Retrieve a specific PixClaim
+    #
+    # Receive a single PixClaim object previously created in the Stark Infra API by passing 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:
+    # - PixClaim object with updated attributes
+    def self.get(id, user: nil)
+      StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
+    end
+
+    # # Retrieve PixClaims
+    #
+    # Receive a generator of PixClaim objects previously created in the Stark Infra API
+    #
+    # ## Parameters (optional):
+    # - 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 or updated only after specified date. ex: Date.new(2020, 3, 10)
+    # - before [Date or string, default nil]: date filter for objects created or updated only before specified date. ex: Date.new(2020, 3, 10)
+    # - status [string, default nil]: filter for status of retrieved objects. Options: 'created', 'failed', 'delivered', 'confirmed', 'success', 'canceled'
+    # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - type [string, default nil]: filter for the type of retrieved PixClaims. Options: 'ownership' or 'portability'
+    # - agent [string, default nil]: filter for the agent of retrieved PixClaims. Options: 'claimer' or 'claimed'.
+    # - key_type [string, default nil]: filter for the PixKey type of retrieved PixClaims. Options: 'cpf', 'cnpj', 'phone', 'email' and 'evp',
+    # - key_id [string, default nil]: filter PixClaims linked to a specific PixKey id. Example: '+5511989898989'.
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - generator of PixClaim objects with updated attributes
+    def self.query(
+      limit: nil, after: nil, before: nil, status: nil, ids: nil,
+      type: nil, agent: nil, key_type: nil, key_id: nil, user: nil
+    )
+      after = StarkInfra::Utils::Checks.check_date(after)
+      before = StarkInfra::Utils::Checks.check_date(before)
+      StarkInfra::Utils::Rest.get_stream(
+        limit: limit,
+        after: after,
+        before: before,
+        status: status,
+        ids: ids,
+        type: type,
+        agent: agent,
+        key_type: key_type,
+        key_id: key_id,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Retrieve paged PixClaims
+    #
+    # Receive a list of up to 100 PixClaim 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 claims.
+    #
+    # ## Parameters (optional):
+    # - cursor [string, default nil]: cursor returned on the previous page function call
+    # - 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 or updated only after specified date. ex: Date.new(2020, 3, 10)
+    # - before [Date or string, default nil]: date filter for objects created or updated only before specified date. ex: Date.new(2020, 3, 10)
+    # - status [string, default nil]: filter for status of retrieved objects. Options: 'created', 'failed', 'delivered', 'confirmed', 'success', 'canceled'
+    # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - type [string, default nil]: filter for the type of retrieved PixClaims. Options: 'ownership' or 'portability'
+    # - agent [string, default nil]: filter for the agent of retrieved PixClaims. Options: 'claimer' or 'claimed'.
+    # - key_type [string, default nil]: filter for the PixKey type of retrieved PixClaims. Options: 'cpf', 'cnpj', 'phone', 'email' and 'evp',
+    # - key_id [string, default nil]: filter PixClaims linked to a specific PixKey id. Example: '+5511989898989'.
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - list of PixClaim objects with updated attributes
+    # - cursor to retrieve the next page of PixClaim objects
+    def self.page(
+      cursor: nil, limit: nil, after: nil, before: nil, status: nil, ids: nil,
+      type: nil, agent: nil, key_type: nil, key_id: nil, user: nil
+    )
+      after = StarkInfra::Utils::Checks.check_date(after)
+      before = StarkInfra::Utils::Checks.check_date(before)
+      StarkInfra::Utils::Rest.get_page(
+        cursor: cursor,
+        limit: limit,
+        after: after,
+        before: before,
+        status: status,
+        ids: ids,
+        type: type,
+        agent: agent,
+        key_type: key_type,
+        key_id: key_id,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Update a PixClaim entity
+    #
+    # Respond to a received PixClaim.
+    #
+    # ## Parameters (required):
+    # - id [string]: PixClaim unique id. ex: '5656565656565656'
+    # - status [string]: patched status for Pix Claim. Options: 'confirmed' and 'canceled'
+    #
+    # ## Parameters (optional):
+    # - reason [string, default 'userRequested']: reason why the PixClaim is being patched. Options: 'fraud', 'userRequested', 'accountClosure'.
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - updated PixClaim object
+    def self.update(id, status:, reason: nil, user: nil)
+      StarkInfra::Utils::Rest.patch_id(
+        id: id,
+        status: status,
+        reason: reason,
+        user: user,
+        **resource
+      )
+    end
+
+    def self.resource
+      {
+        resource_name: 'PixClaim',
+        resource_maker: proc { |json|
+          PixClaim.new(
+            account_created: json['account_created'],
+            account_number: json['account_number'],
+            account_type: json['account_type'],
+            branch_code: json['branch_code'],
+            name: json['name'],
+            tax_id: json['tax_id'],
+            key_id: json['key_id'],
+            id: json['id'],
+            status: json['status'],
+            type: json['type'],
+            key_type: json['key_type'],
+            agent: json['agent'],
+            bank_code: json['bank_code'],
+            claimed_bank_code: json['claimed_bank_code'],
+            created: json['created'],
+            updated: json['updated']
+          )
+        }
+      }
+    end
+  end
+end

data/lib/pixdirector/pixdirector.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require_relative('../utils/resource')
+require_relative('../utils/rest')
+
+module StarkInfra
+  # # PixDirector object
+  #
+  # Mandatory data that must be registered within the Central Bank for
+  # emergency contact purposes. When you initialize a PixDirector,
+  # the entity will not be automatically created in the Stark Infra API.
+  # The 'create' function sends the objects to the Stark Infra API and
+  # returns the list of created objects.
+  #
+  # ## Parameters (required):
+  # - name [string]: name of the PixDirector. ex: 'Edward Stark'.
+  # - tax_id [string]: tax ID (CPF) of the PixDirector. ex: '012.345.678-90'
+  # - phone [string]: phone of the PixDirector. ex: '+551198989898'
+  # - email [string]: email of the PixDirector. ex: 'ned.stark@starkbank.com'
+  # - password [string]: password of the PixDirector. ex: '12345678'
+  # - team_email [string]: team email. ex: 'pix.team@company.com'
+  # - team_phones [list of strings]: list of phones of the team. ex: ['+5511988889999', '+5511988889998']
+  #
+  # ## Attributes (return-only):
+  # - id [string]: unique id returned when the PixDirector is created. ex: '5656565656565656'
+  # - status [string]: current PixDirector status. ex: 'success'
+  class PixDirector < StarkInfra::Utils::Resource
+    attr_reader :name, :tax_id, :phone, :email, :password, :team_email, :team_phones, :id, :status
+    def initialize(name:, tax_id:, phone:, email:, password:, team_email:, team_phones:, id: nil, status: nil)
+      super(id)
+      @name = name
+      @tax_id = tax_id
+      @phone = phone
+      @email = email
+      @password = password
+      @team_email = team_email
+      @team_phones = team_phones
+      @status = status
+    end
+
+    # # Create a PixDirector
+    #
+    # Send a PixDirector object for creation in the Stark Infra API
+    #
+    # ## Parameters (required):
+    # - director [PixDirector object]: PixDirector object to be created in the API. ex: PixDirector.new()
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - PixDirector object with updated attributes.
+    def self.create(director, user: nil)
+      StarkInfra::Utils::Rest.post_single(entity: director, user: user, **resource)
+    end
+
+    def self.resource
+      {
+        resource_name: 'PixDirector',
+        resource_maker: proc { |json|
+          PixDirector.new(
+            id: json['id'],
+            name: json['name'],
+            tax_id: json['tax_id'],
+            phone: json['phone'],
+            email: json['email'],
+            password: json['password'],
+            team_email: json['team_email'],
+            team_phones: json['team_phones'],
+            status: json['status']
+          )
+        }
+      }
+    end
+  end
+end