fintoc 1.2.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1a0932a63c0c93038089b3054adbe8c105e82248627ce22105fa7e785548ecf
-  data.tar.gz: 03e8f9737a40f23f03dec7d293b0741e6b95477ef3330181f7d0d0396fa98b03
+  metadata.gz: 34910f21240b0f76d808c9ab4f22b8ea4a904c9280b11e3bb1d39eee6660a0b6
+  data.tar.gz: ce6b1ca7100789cb27067aaeccd80324e089cbaf7b819317f35472f1fd3dad6d
 SHA512:
-  metadata.gz: 67767ca7af9b52848bb8224134b352c1e83999cb3e4650ee248a0b241d31d476521c2422fbb821130463968d18b4e828bf55aedcf9269702483f478bd4665cc9
-  data.tar.gz: 934617f315dfb320eb14fe2974272e17b9b17b87bf942c1b6fa6fb23192bf56cf4bd113724e89390282b1966d53d3f7f7392a11c68644ccb372e36d13e00bb2c
+  metadata.gz: 963c67d86b28ec2a1215720a6ddc69ff102f2f4368bc32871167750418d49e0e1b46ad95ebb6406862be93bd80034ea9398eac3622b9ced2a8b13719c7f7a519
+  data.tar.gz: fb45a851b1ce805c9bfd31d9eeefb21646c0acccdff4e0a3be04e541e57778af090f553892127638ef2ebd623319c17c430f9a09168875fe1b94ec99392f25f5

data/.github/workflows/release.yml

@@ -0,0 +1,53 @@
+name: release
+
+on:
+  workflow_dispatch:
+    inputs:
+      bump:
+        description: 'Tipo de bump'
+        type: choice
+        required: true
+        default: minor
+        options: [patch, minor, major]
+      release-notes:
+        description: 'Release notes (markdown, opcional)'
+        type: string
+        required: false
+
+jobs:
+  release:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4'
+          bundler-cache: true
+
+      - run: bundle exec rspec
+
+      # setup-ruby's bundler-cache sets BUNDLE_FROZEN; prepare needs to refresh Gemfile.lock
+      - run: bundle config unset --local deployment && bundle config unset --local frozen
+
+      - uses: fintoc-com/release-action/prepare@main
+        id: prep
+        with:
+          bump: ${{ inputs.bump }}
+          version-format: ruby
+          tag-prefix: v
+          app-id: ${{ vars.FIN_RELEASES_APP_ID }}
+          app-private-key: ${{ secrets.FIN_RELEASES_PRIVATE_KEY }}
+
+      - uses: rubygems/release-gem@v1
+
+      - uses: fintoc-com/release-action/finalize@main
+        with:
+          tag: ${{ steps.prep.outputs.tag }}
+          release-notes: ${{ inputs.release-notes }}
+          app-id: ${{ vars.FIN_RELEASES_APP_ID }}
+          app-private-key: ${{ secrets.FIN_RELEASES_PRIVATE_KEY }}

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 1.3.0 - 2026-08-25
+
+### 🚀 New Features
+
+- **Entity Onboardings**: Added `entities` resource with `create`, and `onboardings` under entities, including legal representative document upload
+- **Webhook Endpoints**: Added `webhook_endpoints` manager
+- **Multipart Uploads**: HTTP client now supports `multipart/form-data` requests
+
+### 🐛 Bug Fixes
+
+- **HTTP 6 Compatibility**: Request options are passed as keyword arguments
+
 ## 1.2.0 - 2026-04-08
 
 ### 🚀 New Features

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    fintoc (1.2.0)
+    fintoc (1.5.0)
       http
       money-rails
       tabulate
@@ -38,16 +38,16 @@ GEM
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
       uri (>= 0.13.1)
-    addressable (2.8.7)
-      public_suffix (>= 2.0.2, < 7.0)
+    addressable (2.9.0)
+      public_suffix (>= 2.0.2, < 8.0)
     ast (2.4.3)
     base64 (0.3.0)
     benchmark (0.4.1)
-    bigdecimal (3.2.2)
+    bigdecimal (4.1.2)
     builder (3.3.0)
     concurrent-ruby (1.3.5)
     connection_pool (2.5.3)
-    crack (1.0.0)
+    crack (1.0.1)
       bigdecimal
       rexml
     crass (1.0.6)
@@ -58,27 +58,12 @@ GEM
     drb (2.2.3)
     erb (5.0.2)
     erubi (1.13.1)
-    ffi (1.17.2)
-    ffi (1.17.2-aarch64-linux-gnu)
-    ffi (1.17.2-aarch64-linux-musl)
-    ffi (1.17.2-arm-linux-gnu)
-    ffi (1.17.2-arm-linux-musl)
-    ffi (1.17.2-arm64-darwin)
-    ffi (1.17.2-x86_64-darwin)
-    ffi (1.17.2-x86_64-linux-gnu)
-    ffi (1.17.2-x86_64-linux-musl)
-    ffi-compiler (1.3.2)
-      ffi (>= 1.15.5)
-      rake
-    hashdiff (1.2.0)
-    http (5.3.1)
-      addressable (~> 2.8)
+    hashdiff (1.2.1)
+    http (6.0.4)
       http-cookie (~> 1.0)
-      http-form_data (~> 2.2)
-      llhttp-ffi (~> 0.5.0)
-    http-cookie (1.0.8)
+      llhttp (~> 0.6.1)
+    http-cookie (1.1.6)
       domain_name (~> 0.5)
-    http-form_data (2.3.0)
     i18n (1.14.7)
       concurrent-ruby (~> 1.0)
     io-console (0.8.1)
@@ -89,9 +74,7 @@ GEM
     json (2.13.2)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
-    llhttp-ffi (0.5.1)
-      ffi-compiler (~> 1.0)
-      rake (~> 13.0)
+    llhttp (0.6.2)
     logger (1.7.0)
     loofah (2.24.1)
       crass (~> 1.0.2)
@@ -133,7 +116,7 @@ GEM
     psych (5.2.6)
       date
       stringio
-    public_suffix (6.0.2)
+    public_suffix (7.0.5)
     racc (1.8.1)
     rack (3.2.0)
     rack-session (2.1.1)
@@ -159,14 +142,14 @@ GEM
       thor (~> 1.0, >= 1.2.2)
       zeitwerk (~> 2.6)
     rainbow (3.1.1)
-    rake (13.3.0)
+    rake (13.4.2)
     rdoc (6.14.2)
       erb
       psych (>= 4.0.0)
     regexp_parser (2.11.2)
     reline (0.6.2)
       io-console (~> 0.5)
-    rexml (3.4.2)
+    rexml (3.4.4)
     rspec (3.13.1)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
@@ -233,7 +216,7 @@ GEM
     useragent (0.16.11)
     vcr (6.3.1)
       base64
-    webmock (3.25.1)
+    webmock (3.26.2)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)

data/README.md

@@ -31,8 +31,10 @@ Do yourself a favor: go grab some ice cubes by installing this refreshing librar
       - [Accounts](#accounts)
       - [Account Numbers](#account-numbers)
       - [Transfers](#transfers)
+      - [Transfer Batches](#transfer-batches)
       - [Simulate](#simulate)
       - [Account Verifications](#account-verifications)
+    - [Entity onboardings API Examples](#entity-onboardings-api-examples)
   - [Idempotency Keys](#idempotency-keys)
     - [Idempotency Examples](#idempotency-examples)
       - [Account Methods with Idempotency Key](#account-methods-with-idempotency-key)
@@ -138,6 +140,15 @@ transfer = client.v2.transfers.create(
 )
 client.v2.transfers.return('transfer_id')
 
+# Transfer Batches
+transfer_batches = client.v2.transfer_batches.list
+transfer_batch = client.v2.transfer_batches.get('transfer_batch_id')
+transfer_batch = client.v2.transfer_batches.create(
+  description: 'Supplier payments',
+  currency: 'MXN',
+  transfers: [{...}]
+)
+
 # Simulate
 simulated_transfer = client.v2.simulate.receive_transfer(
   account_number_id: 'account_number_id',
@@ -150,6 +161,11 @@ account_verifications = client.v2.account_verifications.list
 account_verification = client.v2.account_verifications.get('account_verification_id')
 account_verification = client.v2.account_verifications.create(account_number: 'account_number')
 
+# Entity onboardings
+entity = client.v2.entities.get('entity_id')
+onboardings = entity.onboardings.list
+onboarding = entity.onboardings.get('onboarding_id')
+
 # TODO: Movements
 ```
 
@@ -354,6 +370,42 @@ transfers = client.v2.transfers.list
 returned_transfer = client.v2.transfers.return('transfer_id')
 ```
 
+#### Transfer Batches
+
+```ruby
+require 'fintoc'
+
+client = Fintoc::Client.new('api_key', jws_private_key: 'jws_private_key')
+
+# Create a transfer batch. Each transfer has the same shape as `transfers.create`, without `currency`
+transfer_batch = client.v2.transfer_batches.create(
+  description: 'Supplier payments',
+  currency: 'MXN',
+  transfers: [
+    {
+      account_id: 'account_id',
+      amount: 10000,
+      comment: 'Invoice 1234',
+      reference_id: '123456',
+      counterparty: { account_number: '735969000000203297' }
+    }
+  ]
+)
+
+# Get a specific transfer batch
+transfer_batch = client.v2.transfer_batches.get('transfer_batch_id')
+
+# List transfer batches, optionally filtered by status and creation date
+transfer_batches = client.v2.transfer_batches.list(
+  'status[]': %w[succeeded partially_succeeded],
+  since: '2026-10-01T00:00:00Z',
+  until: '2026-10-31T23:59:59Z'
+)
+
+# List the transfers of a batch
+transfers = client.v2.transfers.list(transfer_batch_id: 'transfer_batch_id')
+```
+
 #### Simulate
 
 ```ruby
@@ -386,6 +438,90 @@ account_verification = client.v2.account_verifications.get('account_verification
 account_verifications = client.v2.account_verifications.list
 ```
 
+### Entity onboardings API Examples
+
+An entity onboarding represents the onboarding process for an entity. You access it from
+an `Entity` instance (`entity.onboardings`); the full lifecycle is available: list,
+retrieve, create, submit, and upload documents to a slot.
+
+```ruby
+require 'fintoc'
+
+client = Fintoc::Client.new('api_key', jws_private_key: 'jws_private_key')
+entity = client.v2.entities.get('entity_id')
+
+# List the onboardings of an entity (cursor-paginated, light shape)
+onboardings = entity.onboardings.list
+
+# Retrieve a single onboarding (full shape, includes legal representatives,
+# shareholders and documents)
+onboarding = entity.onboardings.get('onboarding_id')
+puts onboarding                     # 📋 Onboarding onbprc_0ujs... (in_progress)
+onboarding.type                     # => 'account_holder'
+onboarding.legal_representatives    # => array of legal representative hashes
+onboarding.shareholders             # => array of shareholder hashes
+onboarding.documents                # => array of document hashes
+
+# Create an onboarding. `type` selects the onboarding to run (`account_holder` or
+# `settlement_recipient`) and `data` holds the nested structures, which are passed
+# through as-is and validated by the API.
+onboarding = entity.onboardings.create(
+  type: 'account_holder',
+  data: {
+    company_information: {
+      incorporation_date: '2020-01-15',
+      business_activity: 'Servicios financieros',
+      fiscal_address: 'Av. Reforma 123, CDMX',
+      business_address: 'Av. Insurgentes 456, CDMX',
+      settlement_account: '646180357600000013',
+      phone: '+521111111111'
+    },
+    legal_representatives: [
+      {
+        first_name: 'Jane',
+        last_name: 'Doe',
+        email: 'jane@acme.com',
+        nationality: 'mx',
+        identification_number: 'AAAA010101HDFAAA01',
+        position: 'Director General'
+      }
+    ],
+    transactional_profile: {
+      resource_origins: %w[trusts investments],
+      monthly_amount_range: '1_500000',
+      monthly_operations_range: '1_15000'
+    },
+    shareholders: [
+      {
+        type: 'natural_person',
+        name: 'Jane',
+        last_name: 'Doe',
+        holder_id: 'AAAA010101AAA',
+        nationality: 'mx',
+        percentage: 100
+      }
+    ]
+  }
+)
+
+# Upload a document for a given slot (multipart). `file:` accepts a path or an IO.
+entity.onboardings.upload_document('onboarding_id', 'slot_key', file: 'path/to/file.pdf')
+
+# Upload a document for a specific shareholder (multipart).
+entity.onboardings.upload_shareholder_document(
+  'onboarding_id', 'shareholder_id', file: 'path/to/file.pdf'
+)
+
+# Upload a document for a specific legal representative (multipart).
+# Slots: `identification` and `power_of_attorney`.
+entity.onboardings.upload_legal_representative_document(
+  'onboarding_id', 'legal_representative_id', 'identification', file: 'path/to/file.pdf'
+)
+
+# Submit the onboarding for review.
+onboarding = entity.onboardings.submit('onboarding_id')
+```
+
 ## Idempotency Keys
 
 The Fintoc API supports [idempotency](https://docs.fintoc.com/reference/idempotent-requests) for safely retrying requests without accidentally performing the same operation twice. This is particularly useful when creating transfers, account numbers, accounts, or other resources where you want to avoid duplicates due to network issues.

data/lib/fintoc/base_client.rb

@@ -38,9 +38,13 @@ module Fintoc
       request('patch', version:, use_jws:, idempotency_key:)
     end
 
+    def put(version: :v1, use_jws: false, idempotency_key: nil)
+      request('put', version:, use_jws:, idempotency_key:)
+    end
+
     def request(method, version: :v1, use_jws: false, idempotency_key: nil)
-      proc do |resource, **kwargs|
-        parameters = params(method, **kwargs)
+      proc do |resource, form: nil, **kwargs|
+        parameters = form ? { form: build_form(form) } : params(method, **kwargs)
         response = make_request(method, resource, parameters, version:, use_jws:, idempotency_key:)
         content = JSON.parse(response.body, symbolize_names: true)
 
@@ -118,7 +122,7 @@ module Fintoc
         request_client = request_client.headers('Idempotency-Key' => idempotency_key)
       end
 
-      request_client.send(method, url, parameters)
+      request_client.send(method, url, **parameters)
     end
 
     def params(method, **kwargs)
@@ -129,6 +133,16 @@ module Fintoc
       end
     end
 
+    def build_form(form)
+      form.transform_values do |value|
+        file?(value) ? HTTP::FormData::File.new(value) : value
+      end
+    end
+
+    def file?(value)
+      value.respond_to?(:read) || (value.is_a?(String) && File.file?(value))
+    end
+
     def raise_custom_error(error)
       raise error_class(error[:code]).new(error[:message], error[:doc_url])
     end

data/lib/fintoc/errors.rb

@@ -66,6 +66,9 @@ module Fintoc
     class InvalidInstallmentsCurrencyError < FintocError; end
     class InvalidClabeError < FintocError; end
     class MismatchTransferAccountCurrencyError < FintocError; end
+    class InvalidTransfersError < FintocError; end
+    class InvalidTransfersSizeError < FintocError; end
+    class InvalidDescriptionSizeError < FintocError; end
 
     # 401 Unauthorized Errors
     class AuthenticationError < FintocError; end
@@ -124,6 +127,7 @@ module Fintoc
     class InvalidTransferDirectionError < FintocError; end
     class AccountNumberLimitReachedError < FintocError; end
     class AccountCannotBeBlockedError < FintocError; end
+    class InvalidSenderAccountsError < FintocError; end
 
     # 422 Unprocessable Entity Errors
     class InvalidOtpCodeError < FintocError; end
@@ -150,6 +154,9 @@ module Fintoc
     class UnrecognizedRequestError < FintocError; end
     class CoreResponseError < FintocError; end
 
+    # 501 Not Implemented Errors
+    class OperationNotImplementedError < FintocError; end
+
     # Webhook Errors
     class WebhookSignatureError < FintocError; end
 

data/lib/fintoc/v1/client/client.rb

@@ -1,5 +1,6 @@
 require 'fintoc/base_client'
 require 'fintoc/v1/managers/links_manager'
+require 'fintoc/v1/managers/webhook_endpoints_manager'
 
 module Fintoc
   module V1
@@ -7,6 +8,10 @@ module Fintoc
       def links
         @links ||= Managers::LinksManager.new(self)
       end
+
+      def webhook_endpoints
+        @webhook_endpoints ||= Managers::WebhookEndpointsManager.new(self)
+      end
     end
   end
 end

data/lib/fintoc/v1/managers/webhook_endpoints_manager.rb

@@ -0,0 +1,77 @@
+require 'fintoc/v1/resources/webhook_endpoint'
+
+module Fintoc
+  module V1
+    module Managers
+      class WebhookEndpointsManager
+        def initialize(client)
+          @client = client
+        end
+
+        def create(url:, enabled_events:, idempotency_key: nil, **params)
+          data = _create_webhook_endpoint(
+            url:, enabled_events:, idempotency_key:, **params
+          )
+          build_webhook_endpoint(data)
+        end
+
+        def get(webhook_endpoint_id)
+          data = _get_webhook_endpoint(webhook_endpoint_id)
+          build_webhook_endpoint(data)
+        end
+
+        def list(**params)
+          _list_webhook_endpoints(**params).map { |data| build_webhook_endpoint(data) }
+        end
+
+        def update(webhook_endpoint_id, idempotency_key: nil, **params)
+          data = _update_webhook_endpoint(webhook_endpoint_id, idempotency_key:, **params)
+          build_webhook_endpoint(data)
+        end
+
+        def delete(webhook_endpoint_id)
+          _delete_webhook_endpoint(webhook_endpoint_id)
+        end
+
+        def test(webhook_endpoint_id, type:)
+          data = _test_webhook_endpoint(webhook_endpoint_id, type:)
+          build_webhook_endpoint(data)
+        end
+
+        private
+
+        def _create_webhook_endpoint(url:, enabled_events:, idempotency_key: nil, **params)
+          request_params = { url:, enabled_events: }
+          request_params.merge!(params)
+
+          @client.post(version: :v1, idempotency_key:).call('webhook_endpoints', **request_params)
+        end
+
+        def _get_webhook_endpoint(webhook_endpoint_id)
+          @client.get(version: :v1).call("webhook_endpoints/#{webhook_endpoint_id}")
+        end
+
+        def _list_webhook_endpoints(**params)
+          @client.get(version: :v1).call('webhook_endpoints', **params)
+        end
+
+        def _update_webhook_endpoint(webhook_endpoint_id, idempotency_key: nil, **params)
+          @client.patch(version: :v1, idempotency_key:)
+                 .call("webhook_endpoints/#{webhook_endpoint_id}", **params)
+        end
+
+        def _delete_webhook_endpoint(webhook_endpoint_id)
+          @client.delete(version: :v1).call("webhook_endpoints/#{webhook_endpoint_id}")
+        end
+
+        def _test_webhook_endpoint(webhook_endpoint_id, type:)
+          @client.post(version: :v1).call("webhook_endpoints/#{webhook_endpoint_id}/test", type:)
+        end
+
+        def build_webhook_endpoint(data)
+          Fintoc::V1::WebhookEndpoint.new(**data, client: @client)
+        end
+      end
+    end
+  end
+end

data/lib/fintoc/v1/resources/webhook_endpoint.rb

@@ -0,0 +1,38 @@
+module Fintoc
+  module V1
+    class WebhookEndpoint
+      attr_reader :id, :object, :url, :mode, :enabled_events, :secret, :disabled, :created_at
+
+      def initialize(
+        id:,
+        object:,
+        url:,
+        mode:,
+        enabled_events:,
+        secret:,
+        disabled:,
+        created_at:,
+        client: nil,
+        **
+      )
+        @id = id
+        @object = object
+        @url = url
+        @mode = mode
+        @enabled_events = enabled_events
+        @secret = secret
+        @disabled = disabled
+        @created_at = created_at
+        @client = client
+      end
+
+      def to_s
+        "🔔 #{@url} (#{@id})"
+      end
+
+      def disabled?
+        @disabled
+      end
+    end
+  end
+end

data/lib/fintoc/v2/client/client.rb

@@ -3,6 +3,7 @@ require 'fintoc/v2/managers/entities_manager'
 require 'fintoc/v2/managers/accounts_manager'
 require 'fintoc/v2/managers/account_numbers_manager'
 require 'fintoc/v2/managers/transfers_manager'
+require 'fintoc/v2/managers/transfer_batches_manager'
 require 'fintoc/v2/managers/simulate_manager'
 require 'fintoc/v2/managers/account_verifications_manager'
 
@@ -25,6 +26,10 @@ module Fintoc
         @transfers ||= Managers::TransfersManager.new(self)
       end
 
+      def transfer_batches
+        @transfer_batches ||= Managers::TransferBatchesManager.new(self)
+      end
+
       def simulate
         @simulate ||= Managers::SimulateManager.new(self)
       end

data/lib/fintoc/v2/managers/entities_manager.rb

@@ -8,6 +8,11 @@ module Fintoc
           @client = client
         end
 
+        def create(holder_name:, holder_id:, country_code:, idempotency_key: nil, **params)
+          data = _create_entity(holder_name:, holder_id:, country_code:, idempotency_key:, **params)
+          build_entity(data)
+        end
+
         def get(entity_id)
           data = _get_entity(entity_id)
           build_entity(data)
@@ -19,6 +24,11 @@ module Fintoc
 
         private
 
+        def _create_entity(holder_name:, holder_id:, country_code:, idempotency_key: nil, **params)
+          @client.post(version: :v2, idempotency_key:)
+                 .call('entities', holder_name:, holder_id:, country_code:, **params)
+        end
+
         def _get_entity(entity_id)
           @client.get(version: :v2).call("entities/#{entity_id}")
         end

data/lib/fintoc/v2/managers/onboardings_manager.rb

@@ -0,0 +1,105 @@
+require 'fintoc/v2/resources/onboarding'
+
+module Fintoc
+  module V2
+    module Managers
+      class OnboardingsManager
+        def initialize(client, entity_id)
+          @client = client
+          @entity_id = entity_id
+        end
+
+        def list(**params)
+          _list_onboardings(**params).map { |data| build_onboarding(data) }
+        end
+
+        def get(onboarding_id)
+          data = _get_onboarding(onboarding_id)
+          build_onboarding(data)
+        end
+
+        def create(idempotency_key: nil, **params)
+          data = _create_onboarding(idempotency_key:, **params)
+          build_onboarding(data)
+        end
+
+        def submit(onboarding_id, idempotency_key: nil)
+          data = _submit_onboarding(onboarding_id, idempotency_key:)
+          build_onboarding(data)
+        end
+
+        def upload_document(onboarding_id, slot_key, file:, idempotency_key: nil)
+          data = _upload_document(onboarding_id, slot_key, file:, idempotency_key:)
+          build_onboarding(data)
+        end
+
+        def upload_shareholder_document(onboarding_id, shareholder_id, file:, idempotency_key: nil)
+          data = _upload_shareholder_document(
+            onboarding_id, shareholder_id, file:, idempotency_key:
+          )
+          build_onboarding(data)
+        end
+
+        def upload_legal_representative_document(
+          onboarding_id, legal_representative_id, slot_key, file:, idempotency_key: nil
+        )
+          data = _upload_legal_representative_document(
+            onboarding_id, legal_representative_id, slot_key, file:, idempotency_key:
+          )
+          build_onboarding(data)
+        end
+
+        private
+
+        def base_path
+          "entities/#{@entity_id}/onboardings"
+        end
+
+        def _list_onboardings(**params)
+          @client.get(version: :v2).call(base_path, **params)
+        end
+
+        def _get_onboarding(onboarding_id)
+          @client.get(version: :v2).call("#{base_path}/#{onboarding_id}")
+        end
+
+        def _create_onboarding(idempotency_key: nil, **params)
+          @client.post(version: :v2, idempotency_key:).call(base_path, **params)
+        end
+
+        def _submit_onboarding(onboarding_id, idempotency_key: nil)
+          @client.post(version: :v2, idempotency_key:)
+                 .call("#{base_path}/#{onboarding_id}/submit")
+        end
+
+        def _upload_document(onboarding_id, slot_key, file:, idempotency_key: nil)
+          @client.put(version: :v2, idempotency_key:).call(
+            "#{base_path}/#{onboarding_id}/documents/#{slot_key}",
+            form: { file: }
+          )
+        end
+
+        def _upload_shareholder_document(onboarding_id, shareholder_id, file:, idempotency_key: nil)
+          @client.put(version: :v2, idempotency_key:).call(
+            "#{base_path}/#{onboarding_id}/shareholders/#{shareholder_id}/document",
+            form: { file: }
+          )
+        end
+
+        def _upload_legal_representative_document(
+          onboarding_id, legal_representative_id, slot_key, file:, idempotency_key: nil
+        )
+          @client.put(version: :v2, idempotency_key:).call(
+            "#{base_path}/#{onboarding_id}/legal_representatives" \
+            "/#{legal_representative_id}/documents/#{slot_key}",
+            form: { file: }
+          )
+        end
+
+        def build_onboarding(data)
+          Fintoc::V2::Onboarding.new(**data, client: @client)
+        end
+      end
+    end
+  end
+end

data/lib/fintoc/v2/managers/transfer_batches_manager.rb

@@ -0,0 +1,47 @@
+require 'fintoc/v2/resources/transfer_batch'
+
+module Fintoc
+  module V2
+    module Managers
+      class TransferBatchesManager
+        def initialize(client)
+          @client = client
+        end
+
+        def create(description:, currency:, transfers:, idempotency_key: nil)
+          data = _create_transfer_batch(description:, currency:, transfers:, idempotency_key:)
+          build_transfer_batch(data)
+        end
+
+        def get(transfer_batch_id)
+          data = _get_transfer_batch(transfer_batch_id)
+          build_transfer_batch(data)
+        end
+
+        def list(**params)
+          _list_transfer_batches(**params).map { |data| build_transfer_batch(data) }
+        end
+
+        private
+
+        def _create_transfer_batch(description:, currency:, transfers:, idempotency_key: nil)
+          @client
+            .post(version: :v2, use_jws: true, idempotency_key:)
+            .call('transfer_batches', description:, currency:, transfers:)
+        end
+
+        def _get_transfer_batch(transfer_batch_id)
+          @client.get(version: :v2).call("transfer_batches/#{transfer_batch_id}")
+        end
+
+        def _list_transfer_batches(**params)
+          @client.get(version: :v2).call('transfer_batches', **params)
+        end
+
+        def build_transfer_batch(data)
+          Fintoc::V2::TransferBatch.new(**data, client: @client)
+        end
+      end
+    end
+  end
+end

data/lib/fintoc/v2/resources/entity.rb

@@ -1,7 +1,9 @@
+require 'fintoc/v2/managers/onboardings_manager'
+
 module Fintoc
   module V2
     class Entity
-      attr_reader :object, :mode, :id, :holder_name, :holder_id, :is_root
+      attr_reader :object, :mode, :id, :holder_name, :holder_id, :is_root, :status, :country_code
 
       def initialize(
         object:,
@@ -10,6 +12,8 @@ module Fintoc
         holder_name:,
         holder_id:,
         is_root:,
+        status: nil,
+        country_code: nil,
         client: nil,
         **
       )
@@ -19,6 +23,8 @@ module Fintoc
         @holder_name = holder_name
         @holder_id = holder_id
         @is_root = is_root
+        @status = status
+        @country_code = country_code
         @client = client
       end
 
@@ -31,6 +37,10 @@ module Fintoc
         refresh_from_entity(fresh_entity)
       end
 
+      def onboardings
+        @onboardings ||= Managers::OnboardingsManager.new(@client, @id)
+      end
+
       private
 
       def refresh_from_entity(entity)
@@ -43,6 +53,8 @@ module Fintoc
         @holder_name = entity.holder_name
         @holder_id = entity.holder_id
         @is_root = entity.is_root
+        @status = entity.status
+        @country_code = entity.country_code
 
         self
       end

data/lib/fintoc/v2/resources/onboarding.rb

@@ -0,0 +1,46 @@
+module Fintoc
+  module V2
+    class Onboarding
+      attr_reader :object, :id, :entity_id, :type, :status, :source, :submitted_at,
+                  :reviewed_at, :submittable, :data, :legal_representatives, :shareholders,
+                  :documents
+
+      def initialize(
+        object:,
+        id:,
+        entity_id: nil,
+        type: nil,
+        status: nil,
+        source: nil,
+        submitted_at: nil,
+        reviewed_at: nil,
+        submittable: nil,
+        data: nil,
+        legal_representatives: nil,
+        shareholders: nil,
+        documents: nil,
+        client: nil,
+        **
+      )
+        @object = object
+        @id = id
+        @entity_id = entity_id
+        @type = type
+        @status = status
+        @source = source
+        @submitted_at = submitted_at
+        @reviewed_at = reviewed_at
+        @submittable = submittable
+        @data = data
+        @legal_representatives = legal_representatives
+        @shareholders = shareholders
+        @documents = documents
+        @client = client
+      end
+
+      def to_s
+        "📋 Onboarding #{@id} (#{@status})"
+      end
+    end
+  end
+end

data/lib/fintoc/v2/resources/transfer_batch.rb

@@ -0,0 +1,114 @@
+require 'money'
+
+module Fintoc
+  module V2
+    class TransferBatch
+      attr_reader :id, :object, :mode, :description, :status, :currency, :transfer_count,
+                  :amount, :succeeded_count, :settled_amount, :created_at, :authorized_at,
+                  :rejected_at, :expired_at, :succeeded_at, :partially_succeeded_at
+
+      def initialize( # rubocop:disable Metrics/MethodLength
+        id:,
+        object:,
+        mode:,
+        status:,
+        currency:,
+        transfer_count:,
+        amount:,
+        description: nil,
+        succeeded_count: nil,
+        settled_amount: nil,
+        created_at: nil,
+        authorized_at: nil,
+        rejected_at: nil,
+        expired_at: nil,
+        succeeded_at: nil,
+        partially_succeeded_at: nil,
+        client: nil,
+        **
+      )
+        @id = id
+        @object = object
+        @mode = mode
+        @description = description
+        @status = status
+        @currency = currency
+        @transfer_count = transfer_count
+        @amount = amount
+        @succeeded_count = succeeded_count
+        @settled_amount = settled_amount
+        @created_at = created_at
+        @authorized_at = authorized_at
+        @rejected_at = rejected_at
+        @expired_at = expired_at
+        @succeeded_at = succeeded_at
+        @partially_succeeded_at = partially_succeeded_at
+        @client = client
+      end
+
+      def to_s
+        amount_str = Money.from_cents(@amount, @currency).format
+        "📦 #{amount_str} (#{@id}) - #{@status}"
+      end
+
+      def refresh
+        fresh_transfer_batch = @client.transfer_batches.get(@id)
+        refresh_from_transfer_batch(fresh_transfer_batch)
+      end
+
+      def pending_authorization?
+        @status == 'pending_authorization'
+      end
+
+      def in_progress?
+        @status == 'in_progress'
+      end
+
+      def rejected?
+        @status == 'rejected'
+      end
+
+      def expired?
+        @status == 'expired'
+      end
+
+      def succeeded?
+        @status == 'succeeded'
+      end
+
+      def partially_succeeded?
+        @status == 'partially_succeeded'
+      end
+
+      def failed?
+        @status == 'failed'
+      end
+
+      private
+
+      def refresh_from_transfer_batch(transfer_batch) # rubocop:disable Metrics/MethodLength
+        unless transfer_batch.id == @id
+          raise ArgumentError, 'Transfer batch must be the same instance'
+        end
+
+        @object = transfer_batch.object
+        @mode = transfer_batch.mode
+        @description = transfer_batch.description
+        @status = transfer_batch.status
+        @currency = transfer_batch.currency
+        @transfer_count = transfer_batch.transfer_count
+        @amount = transfer_batch.amount
+        @succeeded_count = transfer_batch.succeeded_count
+        @settled_amount = transfer_batch.settled_amount
+        @created_at = transfer_batch.created_at
+        @authorized_at = transfer_batch.authorized_at
+        @rejected_at = transfer_batch.rejected_at
+        @expired_at = transfer_batch.expired_at
+        @succeeded_at = transfer_batch.succeeded_at
+        @partially_succeeded_at = transfer_batch.partially_succeeded_at
+
+        self
+      end
+    end
+  end
+end

data/lib/fintoc/version.rb

@@ -1,3 +1,3 @@
 module Fintoc
-  VERSION = '1.2.0'
+  VERSION = '1.5.0'
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: fintoc
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Juan Ca Sardin
-autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-04-08 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http
@@ -61,6 +60,7 @@ extra_rdoc_files: []
 files:
 - ".github/pull_request_template.md"
 - ".github/workflows/ci.yml"
+- ".github/workflows/release.yml"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
@@ -84,12 +84,14 @@ files:
 - lib/fintoc/utils.rb
 - lib/fintoc/v1/client/client.rb
 - lib/fintoc/v1/managers/links_manager.rb
+- lib/fintoc/v1/managers/webhook_endpoints_manager.rb
 - lib/fintoc/v1/resources/account.rb
 - lib/fintoc/v1/resources/balance.rb
 - lib/fintoc/v1/resources/institution.rb
 - lib/fintoc/v1/resources/link.rb
 - lib/fintoc/v1/resources/movement.rb
 - lib/fintoc/v1/resources/transfer_account.rb
+- lib/fintoc/v1/resources/webhook_endpoint.rb
 - lib/fintoc/v2/client/client.rb
 - lib/fintoc/v2/managers/account_numbers_manager.rb
 - lib/fintoc/v2/managers/account_statements_manager.rb
@@ -97,7 +99,9 @@ files:
 - lib/fintoc/v2/managers/accounts_manager.rb
 - lib/fintoc/v2/managers/entities_manager.rb
 - lib/fintoc/v2/managers/movements_manager.rb
+- lib/fintoc/v2/managers/onboardings_manager.rb
 - lib/fintoc/v2/managers/simulate_manager.rb
+- lib/fintoc/v2/managers/transfer_batches_manager.rb
 - lib/fintoc/v2/managers/transfers_manager.rb
 - lib/fintoc/v2/resources/account.rb
 - lib/fintoc/v2/resources/account_number.rb
@@ -105,7 +109,9 @@ files:
 - lib/fintoc/v2/resources/account_verification.rb
 - lib/fintoc/v2/resources/entity.rb
 - lib/fintoc/v2/resources/movement.rb
+- lib/fintoc/v2/resources/onboarding.rb
 - lib/fintoc/v2/resources/transfer.rb
+- lib/fintoc/v2/resources/transfer_batch.rb
 - lib/fintoc/version.rb
 - lib/fintoc/webhook_signature.rb
 - lib/tasks/simplecov_config.rb
@@ -115,7 +121,6 @@ metadata:
   homepage_uri: https://github.com/fintoc-com/fintoc-ruby
   source_code_uri: https://github.com/fintoc-com/fintoc-ruby
   rubygems_mfa_required: 'true'
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -130,8 +135,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: The official Ruby client for the Fintoc API.
 test_files: []