mangopay4-ruby-sdk 3.47.0 → 4.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8cc10e268ef7f7029a76cd99da66abdcfbe9a76c7cd1b938992e102758e4396e
-  data.tar.gz: 947581ca00b8c352e07be28d4bf5f21f28211a15f6c69afc6595aa669f201249
+  metadata.gz: 043facedde7d0e2e39ee93b0725498ecd735f9b630d186118b9a61d07140296e
+  data.tar.gz: b587b64329a5c61b09656b305e6fb8f08eed2a8b06ed4f5130567d3a1fd0548b
 SHA512:
-  metadata.gz: 7deab526bea4f06430b8b0ce51ee9d7208a7c6e103abb0cced837e4463bf634f5a686215e8ca3a547d57a685b0a7b61912efcb9fb46455c592a96555d6b5a2de
-  data.tar.gz: 1dd444f37f32c14ea3f74d9fa12e40a1d1957eee20be9bb121c8707e7df13d6d92a7bd3e07e37756abec1addb3f53e9b0320fa84d451e69dcb02abff99533db8
+  metadata.gz: 4565aadf4d1a72baee4ca3b60c067e3479f01a79028bb00f38ce7d9bcb81329cff055d70c8dc82d37e676593a95956d19a4e19fec7b89127c9448128872e6659
+  data.tar.gz: 8cc922b2fc56c0097abb4ef1031ea38d1e00f6ca43d9f87e0208167f186aada60a63455d8dc1d036fe2fc6fbac611ee504c26cccb2568eb2731140b195b6d93f

data/CHANGELOG.md

@@ -1,3 +1,99 @@
+## [4.1.0] - 2026-10-01
+### Added – Extended Preauthorizations
+- Added `MangoPay::ExtendedPreauthorization` with:
+  - `create` – create an extended preauthorization (card/direct)
+  - `create_paypal_preauthorization` – create an extended preauthorization via PayPal
+  - `get` – fetch an extended preauthorization by id
+  - `update` – update an extended preauthorization. To cancel one, call `update` with `{ PaymentStatus: 'CANCELED' }`
+  - `get_all_for_user` – list a user's extended preauthorizations
+  - `get_all_for_card` – list a card's extended preauthorizations
+  - `get_transactions` – list an extended preauthorization's transactions
+- Added `MangoPay::PayIn::PreAuthorized::Direct.create_pre_authorized_extended_pay_in` for extended preauthorized pay-ins
+
+#### Deprecated
+- `MangoPay::Deposit` – use `MangoPay::ExtendedPreauthorization` instead
+- `MangoPay::PayIn::PreAuthorized::Direct.create_pre_authorized_deposit_pay_in` – use `create_pre_authorized_extended_pay_in` instead
+
+## [4.0.0] - 2026-09-02
+### Infrastructure – CI/CD Migration
+
+Migrated CI/CD from GitHub Actions to GitLab. This is an infrastructure-only release with no new API features.
+
+#### Added
+- `simplecov` development dependency for test coverage reporting
+
+#### Removed
+- `Rakefile`
+- `bin/mangopay` interactive console script
+
+#### Changed
+- Gemspec `s.files` uses `Dir.glob` instead of `git ls-files`. The published gem now contains **only** `lib/**/*`, `README.md`, `LICENSE`, `CHANGELOG.md`, and `mangopay.gemspec`. Files that were previously packaged are no longer shipped, including `spec/`, `bin/`, `Gemfile`, `Gemfile.lock`, and `Rakefile`.
+- `YAML.load` replaced with `YAML.safe_load` restricted to `Time` (`permitted_classes: [Time], aliases: false`) when reading the cached authorization token — avoids arbitrary object deserialization and is Ruby 3.1+ Psych 4 compatible
+- `File.exists?` replaced with `File.exist?` (deprecated method removal)
+- `multi_json` dependency constraint tightened from `>= 1.15.0` to `~> 1.21`
+
+### Breaking Changes
+
+> **Ruby version requirement raised from `>= 1.9.2` to `>= 3.3.0`.**
+> Any environment running Ruby < 3.3 will no longer be able to install this gem.
+
+> **`bin/mangopay` console removed.**
+> The interactive IRB console that was shipped with the gem is no longer available.
+
+> **`Rakefile` removed.**
+> If your workflow depends on `rake` tasks defined in this gem's Rakefile (e.g., `bundler/gem_tasks`), those are no longer provided.
+
+> **`multi_json` pinned to `~> 1.21`.**
+> If you depend on a future major version of `multi_json`, it will conflict.
+
+> **Published gem contents reduced.**
+> The gem now ships only `lib/**/*`, `README.md`, `LICENSE`, `CHANGELOG.md`, and `mangopay.gemspec`. Previously packaged files — including `spec/`, `bin/`, `Gemfile`, `Gemfile.lock`, and `Rakefile` — are no longer bundled. Any tooling that relied on these files being present in the installed gem will break.
+
+## [3.52.0] - 2026-09-01
+### Added – Get PayPal Data Collection (Acquiring)
+- Added `MangoPay::Acquiring::PayIn::PayPal::Web.get_data_collection` to fetch a PayPal data collection by id
+
+## [3.51.0] - 2026-08-17
+### Added – External providers list for PayIn Intents
+#342
+- Added `MangoPay::PayIn::PayInIntent::Intent.get_external_providers_list` to fetch the list of external providers available for pay-in intents
+
+### Added – PSC retry for Identity Verifications
+#343
+- Added `MangoPay::IdentityVerification.retry_psc` to request the retry of a PSC session, optionally passing the values to update
+
+## [3.50.0] - 2026-07-13
+### Deprecated – Non-SCA users and deposit preauthorized complement pay-ins
+- `MangoPay::LegalUser` create, get by id and update operations are deprecated. Use `MangoPay::LegalUserSca` instead.
+- `MangoPay::NaturalUser` create, get by id and update operations are deprecated. Use `MangoPay::NaturalUserSca` instead.
+- `MangoPay::PayIn::PreAuthorized::Direct.create_deposit_preauthorized_pay_in_prior_to_complement` is deprecated.
+- `MangoPay::PayIn::PreAuthorized::Direct.create_deposit_preauthorized_pay_in_complement` is deprecated.
+
+## [3.49.0] - 2026-05-21
+### Added – PayPal Deposit Preauthorizations
+- Added `MangoPay::Deposit.create_paypal_preauthorization` to create a PayPal deposit preauthorization
+- Added `MangoPay::PayIn::PayPal::Web.create_pre_authorized_deposit_pay_in` to create a PayPal web deposit preauthorized pay-in (full capture)
+
+### Added – Pagination support for Recipients
+- `MangoPay::Recipient.get_user_recipients` now accepts `page` and `per_page` pagination parameters
+
+### Added – Recurring PayIns for Google Pay and Apple Pay
+- Added `MangoPay::PayIn::RecurringPayments::RecurringGooglePayPayIn` to create recurring Google Pay pay-ins
+- Added `MangoPay::PayIn::RecurringPayments::RecurringApplePayPayIn` to create recurring Apple Pay pay-ins
+
+### Changed – Improved naming for Recurring PayIn classes
+New classes were introduced with clearer names, and the old ones are now deprecated (still functional, scheduled for removal in a future release):
+- Added `MangoPay::PayIn::RecurringPayments::RecurringPayInRegistration` — **deprecates** `MangoPay::PayIn::RecurringPayments::Recurring`
+- Added `MangoPay::PayIn::RecurringPayments::RecurringCardPayIn` — **deprecates** `MangoPay::PayIn::RecurringPayments::CIT` and `MangoPay::PayIn::RecurringPayments::MIT`
+- Added `MangoPay::PayIn::RecurringPayments::RecurringPayPalPayIn` — **deprecates** `MangoPay::PayIn::RecurringPayments::PayPalCIT` and `MangoPay::PayIn::RecurringPayments::PayPalMIT`
+
+### Fixed – ReportV2.get_all parameters
+- `MangoPay::ReportV2.get_all` now accepts a `filters` hash (sent as query parameters) and defaults to `{}` instead of `nil`. This fixes a crash when calling the method with no arguments while request logging is enabled, and ensures any provided values are actually sent to the API.
+
+## [3.48.0] - 2026-03-25
+### Removed
+- Payconiq PayIn (`MangoPay::PayIn::PayconiqWeb::Create`) removed following provider discontinuation on 4 Dec 2025 (#334)
+
 ## [3.47.0] - 2026-03-19
 ### Added - mTLS certificates support
 - mTLS certificates are now configurable in the SDK via file paths or encoded strings

data/lib/mangopay/acquiring.rb

@@ -50,6 +50,10 @@ module MangoPay
           def self.create_data_collection(params, idempotency_key = nil)
             MangoPay.request(:post, "#{MangoPay.api_path}/acquiring/payins/payment-methods/paypal/data-collection", params, {}, idempotency_key)
           end
+
+          def self.get_data_collection(data_collection_id)
+            MangoPay.request(:get, "#{MangoPay.api_path}/acquiring/payins/payment-methods/paypal/data-collection/#{data_collection_id}")
+          end
         end
       end
     end

data/lib/mangopay/authorization_token.rb

@@ -66,7 +66,7 @@ module MangoPay
           f.flock(File::LOCK_SH)
           txt = f.read
           f.close
-          YAML.load(txt) || nil
+          YAML.safe_load(txt, permitted_classes: [Time], aliases: false)
         rescue Errno::ENOENT
           nil
         end

data/lib/mangopay/deposit.rb

@@ -1,11 +1,18 @@
 module MangoPay
 
   # See http://docs.mangopay.com/api-references/payins/preauthorized-payin/
+  #
+  # <b>DEPRECATED</b>: The "deposit" terminology is being phased out.
+  # Please use MangoPay::ExtendedPreauthorization instead.
   class Deposit < Resource
     def self.create(params, idempotency_key = nil)
       MangoPay.request(:post, "#{MangoPay.api_path}/deposit-preauthorizations/card/direct", params, {}, idempotency_key)
     end
 
+    def self.create_paypal_preauthorization(params, idempotency_key = nil)
+      MangoPay.request(:post, "#{MangoPay.api_path}/deposit-preauthorizations/payment-methods/paypal", params, {}, idempotency_key)
+    end
+
     def self.get(deposit_id, filters = {})
       MangoPay.request(:get, "#{MangoPay.api_path}/deposit-preauthorizations/#{deposit_id}", {}, filters)
     end

data/lib/mangopay/extended_preauthorization.rb

@@ -0,0 +1,32 @@
+module MangoPay
+
+  class ExtendedPreauthorization < Resource
+    def self.create(params, idempotency_key = nil)
+      MangoPay.request(:post, "#{MangoPay.api_path}/extended-preauthorizations/card/direct", params, {}, idempotency_key)
+    end
+
+    def self.create_paypal_preauthorization(params, idempotency_key = nil)
+      MangoPay.request(:post, "#{MangoPay.api_path}/extended-preauthorizations/payment-methods/paypal", params, {}, idempotency_key)
+    end
+
+    def self.get(extended_preauthorization_id, filters = {})
+      MangoPay.request(:get, "#{MangoPay.api_path}/extended-preauthorizations/#{extended_preauthorization_id}", {}, filters)
+    end
+
+    def self.update(extended_preauthorization_id, params)
+      MangoPay.request(:put, "#{MangoPay.api_path}/extended-preauthorizations/#{extended_preauthorization_id}", params)
+    end
+
+    def self.get_all_for_user(user_id, filters = {})
+      MangoPay.request(:get, "#{MangoPay.api_path}/users/#{user_id}/extended-preauthorizations", {}, filters)
+    end
+
+    def self.get_all_for_card(card_id, filters = {})
+      MangoPay.request(:get, "#{MangoPay.api_path}/cards/#{card_id}/extended-preauthorizations", {}, filters)
+    end
+
+    def self.get_transactions(extended_preauthorization_id, filters = {})
+      MangoPay.request(:get, "#{MangoPay.api_path}/extended-preauthorizations/#{extended_preauthorization_id}/transactions", {}, filters)
+    end
+  end
+end

data/lib/mangopay/http_calls.rb

@@ -54,7 +54,7 @@ module MangoPay
         #
         def fetch(id_or_filters = nil, idempotency_key = nil, query_params_get_by_id = nil)
           id, filters = HTTPCalls::Fetch.parse_id_or_filters(id_or_filters)
-          if query_params_get_by_id != nil and query_params_get_by_id != {}
+          if query_params_get_by_id != nil && query_params_get_by_id != {}
             filters = query_params_get_by_id
           end
           response = MangoPay.request(:get, url(id), {}, filters, idempotency_key)

data/lib/mangopay/identity_verification.rb

@@ -12,5 +12,11 @@ module MangoPay
     def self.get_all(user_id, filters = {})
       MangoPay.request(:get, "#{MangoPay.api_path}/users/#{user_id}/identity-verifications", {}, filters)
     end
+
+    # Request the retry of a PSC session.
+    # +params+ can be empty or contain the values to be updated.
+    def self.retry_psc(identity_verification_id, psc_id, params = {})
+      MangoPay.request(:put, "#{MangoPay.api_path}/identity-verifications/#{identity_verification_id}/pscs/#{psc_id}/retry", params)
+    end
   end
 end

data/lib/mangopay/legal_user.rb

@@ -2,6 +2,9 @@ module MangoPay
 
   # See http://docs.mangopay.com/api-references/users/legal-users/
   # See also parent class MangoPay::User
+  #
+  # <b>DEPRECATED</b>: The non-SCA legal user create, get by id and update
+  # operations are deprecated. Please use MangoPay::LegalUserSca instead.
   class LegalUser < User
 
     def self.url(id = nil)

data/lib/mangopay/natural_user.rb

@@ -1,6 +1,9 @@
 module MangoPay
 
   # See http://docs.mangopay.com/api-references/users/natural-users/
+  #
+  # <b>DEPRECATED</b>: The non-SCA natural user create, get by id and update
+  # operations are deprecated. Please use MangoPay::NaturalUserSca instead.
   class NaturalUser < User
 
     def self.url(id = nil)

data/lib/mangopay/pay_in.rb

@@ -59,19 +59,36 @@ module MangoPay
           "#{MangoPay.api_path}/payins/preauthorized/direct"
         end
 
+        # <b>DEPRECATED</b>: 'create_pre_authorized_deposit_pay_in' function is now deprecated.
+        # Please use 'create_pre_authorized_extended_pay_in' instead.
         def self.create_pre_authorized_deposit_pay_in(params, idempotency_key = nil)
+          warn "[DEPRECATION] MangoPay::PayIn::PreAuthorized::Direct.create_pre_authorized_deposit_pay_in is deprecated. Please use create_pre_authorized_extended_pay_in instead."
           MangoPay.request(:post, "#{MangoPay.api_path}/payins/deposit-preauthorized/direct/full-capture", params, {}, idempotency_key)
         end
 
+        def self.create_pre_authorized_extended_pay_in(params, idempotency_key = nil)
+          MangoPay.request(:post, "#{MangoPay.api_path}/payins/extended-preauthorized/direct/full-capture", params, {}, idempotency_key)
+        end
+
+        # <b>DEPRECATED</b>: 'create_deposit_preauthorized_pay_in_prior_to_complement' function is now deprecated.
         def self.create_deposit_preauthorized_pay_in_prior_to_complement(params, idempotency_key = nil)
+          warn "[DEPRECATION] MangoPay::PayIn::PreAuthorized::Direct.create_deposit_preauthorized_pay_in_prior_to_complement is deprecated."
           MangoPay.request(:post, "#{MangoPay.api_path}/payins/deposit-preauthorized/direct/capture-with-complement", params, {}, idempotency_key)
         end
 
+        # <b>DEPRECATED</b>: 'create_deposit_preauthorized_pay_in_complement' function is now deprecated.
         def self.create_deposit_preauthorized_pay_in_complement(params, idempotency_key = nil)
+          warn "[DEPRECATION] MangoPay::PayIn::PreAuthorized::Direct.create_deposit_preauthorized_pay_in_complement is deprecated."
           MangoPay.request(:post, "#{MangoPay.api_path}/payins/deposit-preauthorized/direct/complement", params, {}, idempotency_key)
         end
       end
 
+      class Web < Resource
+        def self.create_pre_authorized_deposit_pay_in(params, idempotency_key = nil)
+          MangoPay.request(:post, "#{MangoPay.api_path}/payins/deposit-preauthorized/direct/full-capture", params, {}, idempotency_key)
+        end
+      end
+
     end
 
     module BankWire
@@ -147,22 +164,6 @@ module MangoPay
 
     end
 
-    module Payconiq
-
-      class Web < Resource
-        include HTTPCalls::Create
-
-        def self.url(*)
-          "#{MangoPay.api_path}/payins/payment-methods/payconiq"
-        end
-
-        def self.create_legacy(params, idempotency_key = nil)
-          MangoPay.request(:post, "#{MangoPay.api_path}/payins/payconiq/web", params, {}, idempotency_key)
-        end
-      end
-
-    end
-
     module ApplePay
       class Direct < Resource
         include HTTPCalls::Create
@@ -310,6 +311,7 @@ module MangoPay
     end
 
     module RecurringPayments
+      # <b>DEPRECATED</b>: Please use MangoPay::PayIn::RecurringPayments::RecurringPayInRegistration instead.
       class Recurring < Resource
         include HTTPCalls::Create
         include HTTPCalls::Fetch
@@ -324,6 +326,21 @@ module MangoPay
         end
       end
 
+      class RecurringPayInRegistration < Resource
+        include HTTPCalls::Create
+        include HTTPCalls::Fetch
+        include HTTPCalls::Update
+
+        def self.url(*args)
+          if args.any?
+            "#{MangoPay.api_path}/recurringpayinregistrations/#{args.first}"
+          else
+            "#{MangoPay.api_path}/recurringpayinregistrations"
+          end
+        end
+      end
+
+      # <b>DEPRECATED</b>: Please use MangoPay::PayIn::RecurringPayments::RecurringCardPayIn instead.
       class CIT < Resource
         include HTTPCalls::Create
 
@@ -332,6 +349,7 @@ module MangoPay
         end
       end
 
+      # <b>DEPRECATED</b>: Please use MangoPay::PayIn::RecurringPayments::RecurringCardPayIn instead.
       class MIT < Resource
         include HTTPCalls::Create
 
@@ -340,6 +358,15 @@ module MangoPay
         end
       end
 
+      class RecurringCardPayIn < Resource
+        include HTTPCalls::Create
+
+        def self.url(*)
+          "#{MangoPay.api_path}/payins/recurring/card/direct"
+        end
+      end
+
+      # <b>DEPRECATED</b>: Please use MangoPay::PayIn::RecurringPayments::RecurringPayPalPayIn instead.
       class PayPalCIT < Resource
         include HTTPCalls::Create
 
@@ -348,6 +375,7 @@ module MangoPay
         end
       end
 
+      # <b>DEPRECATED</b>: Please use MangoPay::PayIn::RecurringPayments::RecurringPayPalPayIn instead.
       class PayPalMIT < Resource
         include HTTPCalls::Create
 
@@ -355,6 +383,30 @@ module MangoPay
           "#{MangoPay.api_path}/payins/payment-methods/paypal/recurring"
         end
       end
+
+      class RecurringPayPalPayIn < Resource
+        include HTTPCalls::Create
+
+        def self.url(*)
+          "#{MangoPay.api_path}/payins/payment-methods/paypal/recurring"
+        end
+      end
+
+      class RecurringApplePayPayIn < Resource
+        include HTTPCalls::Create
+
+        def self.url(*)
+          "#{MangoPay.api_path}/payins/payment-methods/applepay/recurring"
+        end
+      end
+
+      class RecurringGooglePayPayIn < Resource
+        include HTTPCalls::Create
+
+        def self.url(*)
+          "#{MangoPay.api_path}/payins/payment-methods/googlepay/recurring"
+        end
+      end
     end
 
     module PayInIntent
@@ -383,6 +435,10 @@ module MangoPay
           def cancel(intent_id, params, idempotency_key = nil)
             MangoPay.request(:post, "#{MangoPay.api_path_v3}/payins/intents/#{intent_id}/cancel", params, {}, idempotency_key)
           end
+
+          def get_external_providers_list
+            MangoPay.request(:get, "#{MangoPay.api_path_v3}/payins/intents/external-providers")
+          end
         end
       end
 

data/lib/mangopay/report_v2.rb

@@ -12,8 +12,8 @@ module MangoPay
         MangoPay.request(:get, "#{MangoPay.api_path}/reporting/reports/#{id}")
       end
 
-      def get_all(params = nil)
-        MangoPay.request(:get, "#{MangoPay.api_path}/reporting/reports", params)
+      def get_all(filters = {})
+        MangoPay.request(:get, "#{MangoPay.api_path}/reporting/reports", {}, filters)
       end
 
     end

data/lib/mangopay/version.rb

@@ -1,3 +1,3 @@
 module MangoPay
-  VERSION = '3.47.0'
+  VERSION = '4.1.0'
 end

data/lib/mangopay.rb

@@ -50,6 +50,7 @@ module MangoPay
   autoload :Ubo, 'mangopay/ubo'
   autoload :Regulatory, 'mangopay/regulatory'
   autoload :Deposit, 'mangopay/deposit'
+  autoload :ExtendedPreauthorization, 'mangopay/extended_preauthorization'
   autoload :Conversion, 'mangopay/conversion'
   autoload :PaymentMethodMetadata, 'mangopay/payment_method_metadata'
   autoload :VirtualAccount, 'mangopay/virtual_account'
@@ -250,8 +251,8 @@ module MangoPay
         raise MangoPay::ResponseError.new(uri, res.code, details)
       end
 
-      unless res.is_a?(Net::HTTPOK) or res.is_a?(Net::HTTPCreated) or res.is_a?(Net::HTTPNoContent)
-        if res.is_a?(Net::HTTPUnauthorized) and res['www-authenticate'] != nil
+      unless res.is_a?(Net::HTTPOK) || res.is_a?(Net::HTTPCreated) || res.is_a?(Net::HTTPNoContent)
+        if res.is_a?(Net::HTTPUnauthorized) && res['www-authenticate'] != nil
           redirect_url = res['www-authenticate'][/RedirectUrl=(.+)/, 1]
           data['RedirectUrl'] = redirect_url
           data['message'] = 'SCA required to perform this action.'

data/mangopay.gemspec

@@ -16,15 +16,15 @@ Gem::Specification.new do |s|
   s.homepage    = 'http://docs.mangopay.com/'
   s.license     = 'MIT'
 
-  s.required_ruby_version = '>= 1.9.2'
+  s.required_ruby_version = '>= 3.3.0'
 
-  s.add_dependency('multi_json', '>= 1.15.0')
+  s.add_dependency('multi_json', '~> 1.21')
 
-  s.add_development_dependency('rake', '>= 13.2.1')
-  s.add_development_dependency('rspec', '>= 3.13.0')
+  s.add_development_dependency('rake', '~> 13.4.2')
+  s.add_development_dependency('rspec', '~> 3.13.2')
+  s.add_development_dependency('simplecov', '~> 0.22.0')
 
-  s.files         = `git ls-files`.split("\n")
-  s.test_files    = `git ls-files -- spec/*`.split("\n")
-  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.files         = Dir.glob('lib/**/*', File::FNM_DOTMATCH).reject { |f| File.directory?(f) } +
+                    %w[README.md LICENSE CHANGELOG.md mangopay.gemspec].select { |f| File.exist?(f) }
   s.require_paths = ['lib']
 end