mangopay 3.0.38 → 3.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf7447c17143576fc551c5360bd879c107d30c8311b684d7a6e85fbbd924634f
-  data.tar.gz: b7fba691a647737ffc2a055214fe78c5b9b54c4c1b44b6796dd3333d1e6b6172
+  metadata.gz: b84828fb11033157bfa54765cb99dc5e9ba1c0a00fe7b9351dd8bf4d747d29f2
+  data.tar.gz: 9f83683c46d13b2e6cf18532e4948ccd6daee09bdf4fdf590aee1d9da57e87f8
 SHA512:
-  metadata.gz: ebba688cb4bdec07a07bc7bd56076e381282cfc0d32dd8c619bdab17d300eb545cc95a4961a72a24fff3674d96c6046aa5cd706af2aabb6b894c1e800501785f
-  data.tar.gz: 6b15d0fc47ed468ac522bdda90542839de2ec6d9759ce2568386b9c1c6a45c285280a73ce7a7de9ec642c66228a79867b53e15051d229d582e073a662e6a6976
+  metadata.gz: e593d8cbe199ef24f65ca3a4388015a5cfca4e8b71012fdc3960389ede99e6eef9ad7a424cd136162d581bdc81fb344becf1cced30a5300f09ad1d4aefc49830
+  data.tar.gz: 5d06c7d08de2d7fb8edb1d3ba28bd20643bc3f28c823e535af889b7b270316883134fe95af0fb573811173cbb311fde3ed716249f69269d7927d7350c19ff044

data/.travis.yml

@@ -6,7 +6,8 @@ rvm:
 #  - 2.3
 #  - 2.4
   - 2.5
-script: bundle exec rspec
+script:
+- if [ $TRAVIS_BRANCH != "release" ]; then bundle exec rspec; fi
 deploy:
   provider: rubygems
   api_key:

data/CHANGELOG.md

@@ -1,8 +1,118 @@
-## [3.0.38] - 2020-12-11
-- Added 'Regulatory' endpoint to allow checks of User Block Status
-- Added support for Regulatory -> Blocked Status Hooks
-- Removed sensitive data from logs, such as OwnerName, OwnerAddress BIC
+## [3.5.0] - 2021.06.10
+## Added
 
+We have added a new feature **[recurring payments](https://docs.mangopay.com/guide/recurring-payments)** dedicated to clients needing to charge a card repeatedly, such as subscriptions or payments installments.
+
+You can start testing in sandbox, to help you define your workflow. This release provides the first elements of the full feature.
+
+- [Create a Recurring PayIn Registration object](https://docs.mangopay.com/endpoints/v2.01/payins#e1051_create-a-recurring-payin-registration), containing all the information to define the recurring payment
+- [Initiate your recurring payment flow](https://docs.mangopay.com/endpoints/v2.01/payins#e1053_create-a-recurring-payin-cit) with an authenticated transaction (CIT) using the Card Recurring PayIn endpoint
+- [Continue your recurring payment flow](https://docs.mangopay.com/endpoints/v2.01/payins#e1054_create-a-recurring-payin-mit) with an non-authenticated transaction (MIT) using the Card Recurring PayIn endpoint
+
+This feature is not yet available in production and you need to contact the Support team to request access.
+
+## Accepted PRs
+
+- Add support for refund creation
+- Allow to fetch UBO Declaration without User ID
+
+
+
+## [3.4.0] - 2021.05.27
+## Added
+
+### Instant payment
+
+Mangopay introduces the instant payment mode. It allows payouts (transfer from wallet to user bank account) to be processed within 25 seconds, rather than the 48 hours for a standard payout.
+
+You can now use this new type of payout with the Ruby SDK.
+
+Example :
+
+```ruby
+bankwire = MangoPay::PayOut::BankWire.get_bankwire(payout['Id'])
+# where payout['Id'] is the id of an existing payout
+```
+
+Please note that this feature must be authorized and activated by MANGOPAY. More information [here](https://docs.mangopay.com/guide/instant-payment-payout).
+
+### Accepted PRs
+
+- Add support to create refunds for PayIn, Transfer and PayOut transactions.
+- ResponseError object improvement
+
+## [3.3.0]
+## Fixed
+
+### IBAN for testing purposes
+
+⚠️ **IBAN provided for testing purpose should never be used outside of a testing environement!**
+
+More information about how to test payments, click [here](https://docs.mangopay.com/guide/testing-payments).
+
+### Others
+
+- Adding missing json require in log requests filter spec. Thank you @Vin0uz
+- Extend fetch_wallet and create_payout API. Thank you @peterb
+
+## Added
+
+Some of you use a lot the [PreAuthorization](https://docs.mangopay.com/endpoints/v2.01/preauthorizations#e183_the-preauthorization-object) feature of our API. To make your life easier, we have added three new events :
+
+- PREAUTHORIZATION_CREATED
+- PREAUTHORIZATION_SUCCEEDED
+- PREAUTHORIZATION_FAILED
+
+The goal is to help you monitor a PreAuthorization with a [webhook](https://docs.mangopay.com/endpoints/v2.01/hooks#e246_the-hook-object).
+
+*Example: If a PreAuthorization is desynchronized, when the status is updated, you will be able to know it.*
+
+
+
+## [3.2.0]
+## Added
+
+### On demand feature for 3DSv2
+
+> **This on-demand feature is for testing purposes only and will not be available in production**
+
+#### Request
+
+We've added a new parameter `Requested3DSVersion` (not mandatory) that allows you to choose between versions of 3DS protocols (managed by the parameter `SecureMode`). Two values are available:
+* `V1`
+* `V2_1`
+
+If nothing is sent, the flow will be 3DS V1.
+
+The `Requested3DSVersion` may be included on all calls to the following endpoints:
+* `/preauthorizations/card/direct`
+* `/payins/card/direct`
+
+#### Response
+
+In the API response, the `Requested3DSVersion` will show the value you requested:
+* `V1`
+* `V2_1`
+* `null` – indicates that nothing was requested
+
+The parameter `Applied3DSVersion` shows you the version of the 3DS protocol used. Two values are possible:
+* `V1`
+* `V2_1`
+
+
+
+
+## [3.1.0]
+- 3DS2 integration with Shipping and Billing objects, including FirstName and LastName fields
+The objects Billing and Shipping may be included on all calls to the following endpoints:
+  - /preauthorizations/card/direct
+  - /payins/card/direct
+  - /payins/card/web
+- Enable Instant Payment for payouts by adding a new parameter PayoutModeRequested on the following endpoint /payouts/bankwire
+  - The new parameter PayoutModeRequested can take two differents values : "INSTANT_PAYMENT" or "STANDARD" (STANDARD = the way we procede normaly a payout request)
+  - This new parameter is not mandatory and if empty or not present, the payout will be "STANDARD" by default
+  - Instant Payment is in beta all over Europe - SEPA region
+- Add test on new payout mode PayoutModeRequested
 ## [3.0.37] - 2020-10-30
 - Card Validation endpoint fully activated
 - added pre authorizations transactions method

data/README.md

@@ -15,12 +15,12 @@ Since [v3.0.17](https://github.com/Mangopay/mangopay2-ruby-sdk/releases/tag/v3.0
 
 Account creation
 -------------------------------------------------
-You can get yourself a [free sandbox account](https://www.mangopay.com/signup/create-sandbox/) or sign up for a [production account](https://www.mangopay.com/signup/production-account/) (note that validation of your production account can take a few days, so think about doing it in advance of when you actually want to go live).
+You can get yourself a free sandbox account or sign up for a production account by [registering on the Mangopay site](https://www.mangopay.com/start/) (note that validation of your production account involves several steps, so think about doing it in advance of when you actually want to go live).
 
 ## Usage
 
 ### Install
-* You can get yourself a [free sandbox account](https://www.mangopay.com/get-started/create-sandbox/) or sign up for a [production account](https://www.mangopay.com/signup/production-account/) (note that validation of your production account can take a few days, so think about doing it in advance of when you actually want to go live).
+* You can get yourself a free sandbox account or sign up for a production account [on the Mangopay site](https://www.mangopay.com/start/) (note that validation of your production account will involve several steps, so think about doing it in advance of when you actually want to go live).
 
 * Install the gem by either running ```gem install mangopay```
 or by adding it to your Gemfile ```gem 'mangopay'```

data/lib/mangopay/client.rb

@@ -47,7 +47,10 @@ module MangoPay
       # +currency_iso_code+ is currncy ISO code
       # see https://docs.mangopay.com/api-references/client-wallets/
       def fetch_wallet(funds_type, currency_iso_code)
-        MangoPay.request(:get, url() + "/wallets/#{funds_type}/#{currency_iso_code}")
+        method = :get
+        path = url() + "/wallets/#{funds_type}/#{currency_iso_code}"
+        yield method, path if block_given?
+        MangoPay.request(method, path)
       end
 
       # Fetch transactions for all your client wallets.
@@ -79,7 +82,10 @@ module MangoPay
       end
 
       def create_payout(params)
-        MangoPay.request(:post, url() + "/payouts", params)
+        method = :post
+        path = url() + "/payouts"
+        yield method, path, params if block_given?
+        MangoPay.request(method, path, params)
       end
 
     end

data/lib/mangopay/dispute.rb

@@ -8,9 +8,9 @@ module MangoPay
     include HTTPCalls::Update
     class << self
 
-      def close(dispute_id)
+      def close(dispute_id, idempotency_key = nil)
         url = url(dispute_id) + "/close/"
-        MangoPay.request(:put, url)
+        MangoPay.request(:put, url, {}, {}, idempotency_key)
       end
 
       # +contested_funds+: Money hash
@@ -44,7 +44,7 @@ module MangoPay
         url = "#{MangoPay.api_path}/disputes/pendingsettlement"
         MangoPay.request(:get, url, {}, filters)
       end
-      
+
       #####################################################
       # repudiations / settlement transfers
       #####################################################
@@ -66,7 +66,7 @@ module MangoPay
         url = "#{MangoPay.api_path}/settlements/#{transfer_id}"
         MangoPay.request(:get, url)
       end
-      
+
       #####################################################
       # documents
       #####################################################
@@ -91,13 +91,13 @@ module MangoPay
       # Fetches list of dispute documents:
       # - for the particular dispute if +dispute_id+ is provided (not nil)
       # - or for all disputes otherwise.
-      # 
+      #
       # Optional +filters+ is a hash accepting following keys:
       # - +page+, +per_page+, +sort+: pagination and sorting params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
       # - filters such as +Type+ (e.g. 'REFUND_PROOF') and +Status+ (e.g. 'VALIDATED')
       # - +BeforeDate+ (timestamp): filters documents with CreationDate _before_ this date
       # - +AfterDate+ (timestamp): filters documents with CreationDate _after_ this date
-      # 
+      #
       # See https://docs.mangopay.com/api-references/disputes/dispute-documents/
       #
       def fetch_documents(dispute_id = nil, filters = {})
@@ -106,12 +106,12 @@ module MangoPay
       end
 
       # Adds the file page (attachment) to the given document.
-      # 
+      #
       # See https://docs.mangopay.com/api-references/disputes/dispute-document-pages/ :
       # - Document have to be in 'CREATED' Status
       # - You can create as many pages as needed
       # - Change Status to 'VALIDATION_ASKED' to submit dispute documents
-      # 
+      #
       # The file_content_base64 param may be:
       # - Base64 encoded file content
       # - or nil: in this case pass the file path in the next param

data/lib/mangopay/errors.rb

@@ -49,12 +49,17 @@ module MangoPay
     end
 
     def type;    @details['Type']; end
-    def errors;  @details['errors']; end
+    def error;   @details['error']; end
+    def errors;  @details['errors'] || error; end
 
     def message;
-      msg = @details['Message']
-      msg += errors.sort.map {|k,v| " #{k}: #{v}"}.join if (errors && errors.is_a?(Hash))
-      msg
+      if error
+        msg = error
+      else
+        msg = @details['Message']
+        msg += errors.sort.map {|k,v| " #{k}: #{v}"}.join if (errors && errors.is_a?(Hash))
+        msg
+      end
     end
 
   end

data/lib/mangopay/http_calls.rb

@@ -52,9 +52,9 @@ module MangoPay
         #   MangoPay::User.fetch(filter = {'page' => 2, 'per_page' => 3})
         #   filter # => {"page"=>2, "per_page"=>3, "total_pages"=>1969, "total_items"=>5905}
         #
-        def fetch(id_or_filters = nil)
+        def fetch(id_or_filters = nil, idempotency_key = nil)
           id, filters = HTTPCalls::Fetch.parse_id_or_filters(id_or_filters)
-          response = MangoPay.request(:get, url(id), {}, filters)
+          response = MangoPay.request(:get, url(id), {}, filters, idempotency_key)
         end
       end
 

data/lib/mangopay/kyc_document.rb

@@ -9,20 +9,20 @@ module MangoPay
         MangoPay.request(:post, url(user_id), params, {}, idempotency_key)
       end
 
-      def update(user_id, document_id, params = {})
-        MangoPay.request(:put, url(user_id, document_id), params)
+      def update(user_id, document_id, params = {}, idempotency_key = nil)
+        MangoPay.request(:put, url(user_id, document_id), params, {}, idempotency_key)
       end
 
       # Fetches the KYC document belonging to the given +user_id+, with the given +document_id+.
-      def fetch(user_id, document_id)
+      def fetch(user_id, document_id, idempotency_key = nil)
         url = (user_id) ? url(user_id, document_id) : "#{MangoPay.api_path}/KYC/documents/#{CGI.escape(document_id.to_s)}"
-        MangoPay.request(:get, url)
+        MangoPay.request(:get, url, {}, {}, idempotency_key)
       end
 
       # Fetches list of KYC documents:
       # - for the particular user if +user_id+ is provided (not nil)
       # - or for all users otherwise.
-      # 
+      #
       # Optional +filters+ is a hash accepting following keys:
       # - +page+, +per_page+, +sort+: pagination and sorting params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
       # - filters such as +Type+ (e.g. 'IDENTITY_PROOF') and +Status+ (e.g. 'VALIDATED')
@@ -35,12 +35,12 @@ module MangoPay
       end
 
       # Adds the file page (attachment) to the given document.
-      # 
+      #
       # See http://docs.mangopay.com/api-references/kyc/pages/ :
       # - Document have to be in 'CREATED' Status
       # - You can create as many pages as needed
       # - Change Status to 'VALIDATION_ASKED' to submit KYC documents
-      # 
+      #
       # The file_content_base64 param may be:
       # - Base64 encoded file content
       # - or nil: in this case pass the file path in the next param

data/lib/mangopay/pay_in.rb

@@ -126,5 +126,31 @@ module MangoPay
       end
     end
 
+    module RecurringPayments
+      class Recurring < Resource
+        include HTTPCalls::Create
+
+        def self.url(*)
+          "#{MangoPay.api_path}/recurringpayinregistrations"
+        end
+      end
+
+      class CIT < Resource
+        include HTTPCalls::Create
+
+        def self.url(*)
+          "#{MangoPay.api_path}/payins/recurring/card/direct"
+        end
+      end
+
+      class MIT < Resource
+        include HTTPCalls::Create
+
+        def self.url(*)
+          "#{MangoPay.api_path}/payins/recurring/card/direct"
+        end
+      end
+    end
+
   end
 end

data/lib/mangopay/pay_out.rb

@@ -8,9 +8,9 @@ module MangoPay
     # - +page+, +per_page+, +sort+: pagination and sorting params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
     # - +Status+: TransactionStatus {CREATED, SUCCEEDED, FAILED}
     # - +ResultCode+: string representing the transaction result
-    def self.refunds(pay_out_id, filters = {})
+    def self.refunds(pay_out_id, filters = {}, idempotency_key = nil)
       url = url(pay_out_id) + '/refunds'
-      MangoPay.request(:get, url, {}, filters)
+      MangoPay.request(:get, url, {}, filters, idempotency_key)
     end
 
     # See http://docs.mangopay.com/api-references/pay-out-bank-wire/
@@ -20,6 +20,11 @@ module MangoPay
       def self.url(*)
         "#{MangoPay.api_path}/payouts/bankwire"
       end
+
+      def self.get_bankwire(pay_out_id)
+        url = self.url() + "/" + pay_out_id
+        MangoPay.request(:get, url);
+      end
     end
   end
 end

data/lib/mangopay/refund.rb

@@ -2,6 +2,7 @@ module MangoPay
 
   # See http://docs.mangopay.com/api-references/refund/
   class Refund < Resource
+    include HTTPCalls::Create
     include HTTPCalls::Fetch
 
     # Fetches list of refunds belonging to given +repudiation_id+

data/lib/mangopay/transaction.rb

@@ -3,7 +3,7 @@ module MangoPay
     class << self
       # Fetches list of transactions belonging to the given +wallet_id+.
       # See also transactions for user: MangoPay::User#transactions
-      # 
+      #
       # Optional +filters+ is a hash accepting following keys:
       # - +page+, +per_page+, +sort+: pagination and sorting params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
       # - +Status+: TransactionStatus {CREATED, SUCCEEDED, FAILED}
@@ -12,8 +12,8 @@ module MangoPay
       # - +BeforeDate+ (timestamp): filters transactions with CreationDate _before_ this date
       # - +AfterDate+ (timestamp): filters transactions with CreationDate _after_ this date
       # See https://docs.mangopay.com/api-references/sort-lists/
-      def fetch(wallet_id, filters={})
-        MangoPay.request(:get, url(wallet_id), {}, filters)
+      def fetch(wallet_id, filters={}, headers = nil)
+        MangoPay.request(:get, url(wallet_id), {}, filters, headers)
       end
 
       def url(wallet_id)

data/lib/mangopay/ubo.rb

@@ -10,16 +10,16 @@ module MangoPay
         end
       end
 
-      def create(user_id, ubo_declaration_id, params)
-        MangoPay.request(:post, url(user_id, ubo_declaration_id), params)
+      def create(user_id, ubo_declaration_id, params, idempotency_key = nil)
+        MangoPay.request(:post, url(user_id, ubo_declaration_id), params, {}, idempotency_key)
       end
 
       def fetch(user_id, ubo_declaration_id, ubo_id)
         MangoPay.request(:get, url(user_id, ubo_declaration_id, ubo_id))
       end
 
-      def update(user_id, ubo_declaration_id, ubo_id, params)
-        MangoPay.request(:put, url(user_id, ubo_declaration_id, ubo_id), params)
+      def update(user_id, ubo_declaration_id, ubo_id, params, idempotency_key = nil)
+        MangoPay.request(:put, url(user_id, ubo_declaration_id, ubo_id), params, {}, idempotency_key)
       end
     end
   end

data/lib/mangopay/ubo_declaration.rb

@@ -10,20 +10,22 @@ module MangoPay
         end
       end
 
-      def create(user_id)
-        MangoPay.request(:post, url(user_id))
+      def create(user_id, idempotency_key)
+        MangoPay.request(:post, url(user_id), {}, {}, idempotency_key)
       end
 
-      def fetch(user_id, id)
-        MangoPay.request(:get, url(user_id, id))
+      # Fetches the Ubo declaration belonging to the given +user_id+ if given, with the given +id+.
+      def fetch(user_id, id, idempotency_key)
+        url = (user_id) ? url(user_id, id) : "#{MangoPay.api_path}/kyc/ubodeclarations/#{CGI.escape(id.to_s)}"
+        MangoPay.request(:get, url, {}, {}, idempotency_key)
       end
 
-      def update(user_id, id, params = {})
+      def update(user_id, id, params = {}, idempotency_key)
         request_params = {
             Status: params['Status'],
             Ubos: params['Ubos']
         }
-        MangoPay.request(:put, url(user_id, id), request_params)
+        MangoPay.request(:put, url(user_id, id), request_params, {}, idempotency_key)
       end
     end
   end

data/lib/mangopay/version.rb

@@ -1,3 +1,3 @@
 module MangoPay
-  VERSION = '3.0.38'
+  VERSION = '3.5.0'
 end

data/lib/mangopay/wallet.rb

@@ -10,8 +10,8 @@ module MangoPay
     # Optional +filters+ is a hash accepting following keys:
     # - +page+, +per_page+, +sort+: pagination and sorting params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
     # - other keys specific for transactions filtering (see MangoPay::Transaction.fetch)
-    def self.transactions(wallet_id, filters = {})
-      Transaction.fetch(wallet_id, filters)
+    def self.transactions(wallet_id, filters = {}, headers = nil)
+      Transaction.fetch(wallet_id, filters, headers)
     end
   end
 end

data/spec/mangopay/client_spec.rb

@@ -151,8 +151,8 @@ describe MangoPay::Client do
                                                               PostalCode: '75001',
                                                               Country: 'FR'
                                                           },
-                                                          IBAN: 'FR7618829754160173622224154',
-                                                          BIC: 'CMBRFR2BCME',
+                                                          IBAN: 'FR7630004000031234567890143',
+                                                          BIC: 'BNPAFRPP',
                                                           Tag: 'Test bank account')
       expect(bank_account).not_to be_nil
       expect(bank_account['Id']).not_to be_nil
@@ -172,8 +172,8 @@ describe MangoPay::Client do
                                                               PostalCode: '75001',
                                                               Country: 'FR'
                                                           },
-                                                          IBAN: 'FR7618829754160173622224154',
-                                                          BIC: 'CMBRFR2BCME',
+                                                          IBAN: 'FR7630004000031234567890143',
+                                                          BIC: 'BNPAFRPP',
                                                           Tag: 'Test bank account')
       pay_out = MangoPay::Client.create_payout(BankAccountId: bank_account['Id'],
 
@@ -183,6 +183,7 @@ describe MangoPay::Client do
                                                },
                                                DebitedWalletId: wallets[0]['Id'],
                                                BankWireRef: 'invoice 7282',
+                                               PayoutModeRequested: 'STANDARD',
                                                Tag: 'bla')
 
       expect(pay_out).not_to be_nil

data/spec/mangopay/configuration_spec.rb

@@ -6,7 +6,11 @@ describe MangoPay::Configuration do
       c.client_id = 'test_asd'
       c.client_apiKey = '00000'
       MangoPay::User.fetch()
-    }.to raise_error(MangoPay::ResponseError)
+    }.to raise_error { |err|
+        expect(err).to be_a MangoPay::ResponseError
+        expect(err.code).to eq '401'
+        expect(err.message).to eq 'invalid_client'
+      }
   end
 
   it 'goes ok when calling with correct client credentials' do

data/spec/mangopay/log_requests_filter_spec.rb

@@ -1,6 +1,7 @@
 describe MangoPay do
   include_context 'users'
   include_context 'payins'
+  require 'json'
 
   describe 'requests log file' do
 

data/spec/mangopay/payin_applepay_direct_spec.rb

@@ -11,6 +11,7 @@ describe MangoPay::PayIn::ApplePay::Direct, type: :feature do
 
   describe 'CREATE' do
     it 'creates a applepay direct payin' do
+      #pending("no cards to test for")
       created = new_payin_applepay_direct
       expect(created['Id']).not_to be_nil
       check_type_and_status(created)

data/spec/mangopay/payin_card_direct_spec.rb

@@ -19,6 +19,7 @@ describe MangoPay::PayIn::Card::Direct, type: :feature do
     it 'creates a card direct payin' do
       created = new_payin_card_direct
       expect(created['Id']).not_to be_nil
+      expect(created['Requested3DSVersion']).not_to be_nil
       check_type_and_status(created)
     end
   end

data/spec/mangopay/payout_bankwire_spec.rb

@@ -40,6 +40,15 @@ describe MangoPay::PayOut::BankWire, type: :feature do
     end
   end
 
+  describe 'Get Bankwire' do
+    it 'gets a bankwire' do
+      created = new_payout_bankwire
+      fetched = MangoPay::PayOut::BankWire.get_bankwire(created['Id'])
+      expect(fetched['Id']).to eq(created['Id'])
+      expect(fetched['CreationDate']).to eq(created['CreationDate'])
+    end
+  end
+
   describe 'FETCH' do
     it 'fetches a payout' do
       created = new_payout_bankwire

data/spec/mangopay/preauthorization_spec.rb

@@ -15,6 +15,7 @@ describe MangoPay::PreAuthorization do
       expect(created['PaymentStatus']).to eq('WAITING')
       expect(created['PaymentType']).to eq('CARD')
       expect(created['ExecutionType']).to eq('DIRECT')
+      expect(created['Requested3DSVersion']).to eq('V1')
     end
   end
 

data/spec/mangopay/recurring_payin_spec.rb

@@ -0,0 +1,66 @@
+describe MangoPay::PayIn::RecurringPayments, type: :feature do
+  include_context 'wallets'
+  include_context 'users'
+  include_context 'payins'
+
+  describe 'CREATE' do
+    it 'creates a recurring payment' do
+      cardreg = new_card_registration_3dsecure_completed
+      wallet = new_wallet
+      recurring = MangoPay::PayIn::RecurringPayments::Recurring.create(
+        AuthorId: new_natural_user['Id'],
+        CardId: cardreg['CardId'],
+        CreditedUserId: wallet['Owners'][0],
+        CreditedWalletId: wallet['Id'],
+        FirstTransactionDebitedFunds: {Currency: 'EUR', Amount: 10},
+        FirstTransactionFees: {Currency: 'EUR', Amount: 1},
+        Billing: {
+          Address: {
+            AddressLine1: 'AddressLine1',
+            AddressLine2: 'AddressLine2',
+            City: 'City',
+            Region: 'Region',
+            PostalCode: 'PostalCode',
+            Country: 'FR'
+          },
+          FirstName: 'Joe',
+          LastName: 'Blogs'
+        },
+        Shipping: {
+          Address: {
+            AddressLine1: 'AddressLine1',
+            AddressLine2: 'AddressLine2',
+            City: 'City',
+            Region: 'Region',
+            PostalCode: 'PostalCode',
+            Country: 'FR'
+          },
+          FirstName: 'Joe',
+          LastName: 'Blogs'
+        }
+      )
+      expect(recurring).not_to be_nil
+
+      cit = MangoPay::PayIn::RecurringPayments::CIT.create(
+        RecurringPayinRegistrationId: recurring['Id'],
+        IpAddress: "2001:0620:0000:0000:0211:24FF:FE80:C12C",
+        SecureModeReturnURL: "http://www.my-site.com/returnurl",
+        StatementDescriptor: "lorem",
+        Tag: "custom meta",
+        BrowserInfo: {
+          AcceptHeader: "text/html, application/xhtml+xml, application/xml;q=0.9, /;q=0.8",
+          JavaEnabled: true,
+          Language: "FR-FR",
+          ColorDepth: 4,
+          ScreenHeight: 1800,
+          ScreenWidth: 400,
+          JavascriptEnabled: true,
+          TimeZoneOffset: "+60",
+          UserAgent: "Mozilla/5.0 (iPhone; CPU iPhone OS 13_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"
+        }
+      )
+
+      expect(cit).not_to be_nil
+    end
+  end
+end

data/spec/mangopay/shared_resources.rb

@@ -136,8 +136,8 @@ shared_context 'bank_accounts' do
                                      PostalCode: '75001',
                                      Country: 'FR'
                                  },
-                                 IBAN: 'FR7618829754160173622224154',
-                                 BIC: 'CMBRFR2BCME',
+                                 IBAN: 'FR7630004000031234567890143',
+                                 BIC: 'BNPAFRPP',
                                  Tag: 'Test bank account')
   end
 end
@@ -355,6 +355,28 @@ shared_context 'payins' do
                                       RegistrationData: cardreg['RegistrationData'])
   end
 
+  let(:new_card_registration_3dsecure_completed) do
+    # 1st step: create
+    cardreg = new_card_registration
+
+    # 2nd step: tokenize by payline (fills-in RegistrationData)
+    data = {
+      data: cardreg['PreregistrationData'],
+      accessKeyRef: cardreg['AccessKey'],
+      cardNumber: 4970105191923460,
+      cardExpirationDate: 1224,
+      cardCvx: 123}
+
+    res = Net::HTTP.post_form(URI(cardreg['CardRegistrationURL']), data)
+    raise Exception, [res, res.body] unless res.is_a?(Net::HTTPOK) && res.body.start_with?('data=')
+
+    cardreg['RegistrationData'] = res.body
+
+    # 3rd step: update (fills-in CardId) and return it
+    MangoPay::CardRegistration.update(cardreg['Id'],
+                                      RegistrationData: cardreg['RegistrationData'])
+  end
+
   let(:new_payin_card_direct) { create_new_payin_card_direct(new_wallet) }
 
   def create_new_payin_card_direct(to_wallet, amnt = 1000)
@@ -368,7 +390,8 @@ shared_context 'payins' do
         CardType: 'CB_VISA_MASTERCARD',
         CardId: cardreg['CardId'],
         SecureModeReturnURL: 'http://test.com',
-        Tag: 'Test PayIn/Card/Direct'
+        Tag: 'Test PayIn/Card/Direct',
+        Requested3DSVersion: 'V1'
     )
   end
 
@@ -385,7 +408,8 @@ shared_context 'payins' do
         CardId: cardreg['CardId'],
         SecureMode: 'DEFAULT',
         SecureModeReturnURL: 'http://test.com',
-        Tag: 'Test Card PreAuthorization'
+        Tag: 'Test Card PreAuthorization',
+        Requested3DSVersion: 'V1'
     )
   end
 
@@ -437,7 +461,8 @@ shared_context 'payouts' do
         Fees: {Currency: 'EUR', Amount: 0},
         BankAccountId: new_bank_account['Id'],
         Communication: 'This is a test',
-        Tag: 'Test PayOut/Bank/Wire'
+        Tag: 'Test PayOut/Bank/Wire',
+        PayoutModeRequested: 'Standard'
     )
   end
 end

data/spec/mangopay/ubo_declaration_spec.rb

@@ -6,9 +6,20 @@ describe MangoPay::UboDeclaration do
     it 'can fetch a UBO declaration' do
       legal_user = new_legal_user
 
-      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'])
+      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'], nil)
 
-      ubo_declaration_byId = MangoPay::UboDeclaration.fetch(legal_user['Id'], ubo_declaration['Id'])
+      ubo_declaration_byId = MangoPay::UboDeclaration.fetch(legal_user['Id'], ubo_declaration['Id'], nil)
+
+      expect(ubo_declaration).not_to be_nil
+      expect(ubo_declaration_byId).not_to be_nil
+    end
+
+    it 'fetches ubo declaration just by id' do
+      legal_user = new_legal_user
+
+      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'], nil)
+
+      ubo_declaration_byId = MangoPay::UboDeclaration.fetch(nil, ubo_declaration['Id'], nil)
 
       expect(ubo_declaration).not_to be_nil
       expect(ubo_declaration_byId).not_to be_nil
@@ -17,13 +28,13 @@ describe MangoPay::UboDeclaration do
     describe 'UPDATE' do
       it 'can update a UBO declaration' do
         legal_user = new_legal_user
-        ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'])
+        ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'], nil)
         ubo_declaration['Status'] = 'VALIDATION_ASKED'
 
         ubo = new_ubo(legal_user, ubo_declaration)
 
         ubo_declaration['Ubos'] = [ubo]
-        ubo_declaration = MangoPay::UboDeclaration.update(legal_user['Id'], ubo_declaration['Id'], ubo_declaration)
+        ubo_declaration = MangoPay::UboDeclaration.update(legal_user['Id'], ubo_declaration['Id'], ubo_declaration, nil)
 
         expect(ubo_declaration).not_to be_nil
         expect(ubo_declaration['Status']).to eq 'VALIDATION_ASKED'

data/spec/mangopay/ubo_spec.rb

@@ -5,7 +5,7 @@ describe MangoPay::Ubo do
   describe 'FETCH' do
     it 'can fetch a Ubo' do
       legal_user = new_legal_user
-      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'])
+      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'], nil)
       ubo = new_ubo(legal_user, ubo_declaration)
       result = MangoPay::Ubo.fetch(legal_user['Id'], ubo_declaration['Id'], ubo['Id'])
       expect(result).not_to be_nil
@@ -16,7 +16,7 @@ describe MangoPay::Ubo do
   describe 'CREATE' do
     it 'can create a new Ubo' do
       legal_user = new_legal_user
-      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'])
+      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'], nil)
       result = new_ubo(legal_user, ubo_declaration)
       expect(result).not_to be_nil
     end
@@ -25,7 +25,7 @@ describe MangoPay::Ubo do
   describe 'UPDATE' do
     it 'can update a Ubo' do
       legal_user = new_legal_user
-      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'])
+      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'], nil)
       ubo = new_ubo(legal_user, ubo_declaration)
       ubo['FirstName'] = 'Santa'
       ubo['LastName'] = 'Clause'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mangopay
 version: !ruby/object:Gem::Version
-  version: 3.0.38
+  version: 3.5.0
 platform: ruby
 authors:
 - Geoffroy Lorieux
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-12-16 00:00:00.000000000 Z
+date: 2021-06-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -134,6 +134,7 @@ files:
 - spec/mangopay/payin_preauthorized_direct_spec.rb
 - spec/mangopay/payout_bankwire_spec.rb
 - spec/mangopay/preauthorization_spec.rb
+- spec/mangopay/recurring_payin_spec.rb
 - spec/mangopay/refund_spec.rb
 - spec/mangopay/report_spec.rb
 - spec/mangopay/report_wallets_spec.rb
@@ -198,6 +199,7 @@ test_files:
 - spec/mangopay/payin_preauthorized_direct_spec.rb
 - spec/mangopay/payout_bankwire_spec.rb
 - spec/mangopay/preauthorization_spec.rb
+- spec/mangopay/recurring_payin_spec.rb
 - spec/mangopay/refund_spec.rb
 - spec/mangopay/report_spec.rb
 - spec/mangopay/report_wallets_spec.rb