mangopay 3.4.0 → 3.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f3be9c170462d86c30e551361cb135196086b166a5b4da755002635e6dffa367
-  data.tar.gz: f6cba5c6f4a1f3eacaa4fed0ffb484dacbf71e3d8b8f6a8cc16deca7387188ec
+  metadata.gz: b84828fb11033157bfa54765cb99dc5e9ba1c0a00fe7b9351dd8bf4d747d29f2
+  data.tar.gz: 9f83683c46d13b2e6cf18532e4948ccd6daee09bdf4fdf590aee1d9da57e87f8
 SHA512:
-  metadata.gz: 50f20f836d5eb42c7122b2e5865d20dc6a566ad1433915eef235d9cc0dfef4d4cde39f949c050de0bfafa9510c8aa263d6091ebf7df126e77a222160db8250b2
-  data.tar.gz: 11a3cc3fb9ed24f8b791c331f2113bf35e388082f18f78063c3c2ded7c74d1d8cffe53016d0a4f4fc5ccb03f2a296b09fb73246801bf45b6a1011a065a78d2a0
+  metadata.gz: e593d8cbe199ef24f65ca3a4388015a5cfca4e8b71012fdc3960389ede99e6eef9ad7a424cd136162d581bdc81fb344becf1cced30a5300f09ad1d4aefc49830
+  data.tar.gz: 5d06c7d08de2d7fb8edb1d3ba28bd20643bc3f28c823e535af889b7b270316883134fe95af0fb573811173cbb311fde3ed716249f69269d7927d7350c19ff044

data/CHANGELOG.md

@@ -1,3 +1,23 @@
+## [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
 

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/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/ubo_declaration.rb

@@ -14,8 +14,10 @@ module MangoPay
         MangoPay.request(:post, url(user_id), {}, {}, idempotency_key)
       end
 
+      # Fetches the Ubo declaration belonging to the given +user_id+ if given, with the given +id+.
       def fetch(user_id, id, idempotency_key)
-        MangoPay.request(:get, url(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 = {}, idempotency_key)

data/lib/mangopay/version.rb

@@ -1,3 +1,3 @@
 module MangoPay
-  VERSION = '3.4.0'
+  VERSION = '3.5.0'
 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

@@ -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)

data/spec/mangopay/ubo_declaration_spec.rb

@@ -14,6 +14,17 @@ describe MangoPay::UboDeclaration do
       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
+    end
+
     describe 'UPDATE' do
       it 'can update a UBO declaration' do
         legal_user = new_legal_user

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mangopay
 version: !ruby/object:Gem::Version
-  version: 3.4.0
+  version: 3.5.0
 platform: ruby
 authors:
 - Geoffroy Lorieux
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-05-27 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