mangopay 3.26.1 → 3.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cea2df4d903ca0809a7f7ef9bc42b0263ee2df6ff5ba71fdd37a99c081b96ca3
-  data.tar.gz: 4abceca571bd69f5a47c0597b674ed6869c91f16ddb9408da6b28d23ff24e04e
+  metadata.gz: 9aacfa6dd021ce341e9f435dcca6b77eed14b6a85d9c9e4907bad599f4bcb313
+  data.tar.gz: 22ad8f7d5179689c6841537d73729a4dd3430fb9cf42b9d9caca55658ef31be0
 SHA512:
-  metadata.gz: 73bec6513fa3016b23164e62680c12f5a030b2e150b02fbf01fb4a93973b8e5071dd72e17a92e4de188e6492c70404561062235563038d60c077853c02beb83c
-  data.tar.gz: 807e1c583b1114fa34b750500de47b9ea827a6975d06652bac235ffd1139a161e088e48afda6c1a103788cc6cfb60e1689c7f20d762fa713772f1b266aecb9ac
+  metadata.gz: da2fa47b3367011d9c7ead37af5646aea23ef4b2fab2fb6859ce770a913774d601e7b9b22877ede7709735a502667f626e154aeb10d3637e4dd650fe46029b2d
+  data.tar.gz: afb180e3d2040d91e9827cce7eba960332d6132a316924dcbea3e6aafa990ab7139262abaad98ea9d53c70ada3d43e865b6b91afc849443ef6c319b05fd3345b

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [3.27.0] - 2024-10-29
+### Added
+
+New endpoints for The Virtual Account object:
+- [Create a Virtual Account]()
+- [Deactivate a Virtual Account]()
+- [View a Virtual Account]()
+- [List Virtual Accounts for a Wallet]()
+- [View Client Availabilities]()
+
 ## [3.26.1] - 2024-10-03
 ### Fixed
 

data/lib/mangopay/version.rb

@@ -1,3 +1,3 @@
 module MangoPay
-  VERSION = '3.26.1'
+  VERSION = '3.27.0'
 end

data/lib/mangopay/virtual_account.rb

@@ -0,0 +1,44 @@
+module MangoPay
+
+  class VirtualAccount < Resource
+    class << self
+      # Creates a new virtual account
+      def create(wallet_id, params, idempotency_key = nil)
+        url = "#{MangoPay.api_path}/wallets/#{wallet_id}/virtual-accounts"
+        MangoPay.request(:post, url, params, {}, idempotency_key)
+      end
+
+      # Updates:
+      # - irreversibly deactivates a virtual account with +virtual_account_id+
+      # see https://docs.mangopay.com/api-reference/virtual-accounts/deactivate-virtual-account
+      def deactivate(wallet_id, virtual_account_id, idempotency_key = nil)
+        url = "#{MangoPay.api_path}/wallets/#{wallet_id}/virtual-accounts/#{virtual_account_id}"
+        MangoPay.request(:put, url, {}, {}, idempotency_key)
+      end
+
+      # Fetches:
+      # - view a virtual account with +virtual_account_id+
+      # see https://docs.mangopay.com/api-reference/virtual-accounts/view-virtual-account
+      def fetch(wallet_id, virtual_account_id)
+        url = "#{MangoPay.api_path}/wallets/#{wallet_id}/virtual-accounts/#{virtual_account_id}"
+        MangoPay.request(:get, url, {})
+      end
+
+      # Fetches:
+      # - view virtual accounts for given +wallet_id+
+      # see https://docs.mangopay.com/api-reference/virtual-accounts/list-virtual-accounts-wallet
+      def fetch_all(wallet_id, filters = {})
+        url = "#{MangoPay.api_path}/wallets/#{wallet_id}/virtual-accounts"
+        MangoPay.request(:get, url, {}, filters)
+      end
+
+      # Fetches:
+      # Allows to check which account countries and currencies are available
+      # see https://docs.mangopay.com/api-reference/virtual-accounts/view-virtual-account-availabilities
+      def fetch_availabilities(filters = {})
+        url = "#{MangoPay.api_path}/virtual-accounts/availability"
+        MangoPay.request(:get, url, {}, filters)
+      end
+    end
+  end
+end

data/lib/mangopay.rb

@@ -47,6 +47,7 @@ module MangoPay
   autoload :Deposit, 'mangopay/deposit'
   autoload :Conversion, 'mangopay/conversion'
   autoload :PaymentMethodMetadata, 'mangopay/payment_method_metadata'
+  autoload :VirtualAccount, 'mangopay/virtual_account'
 
   # temporary
   autoload :Temp, 'mangopay/temp'

data/spec/mangopay/shared_resources.rb

@@ -998,4 +998,21 @@ shared_context 'payment_method_metadata' do
       Bin: pay_in['CardInfo']['BIN']
     )
   end
+end
+
+###############################################
+shared_context 'virtual_account' do
+  ###############################################
+  include_context 'users'
+  include_context 'wallets'
+
+  def new_virtual_account(wallet_id)
+    create_virtual_account = {
+      Country: 'FR',
+      VirtualAccountPurpose: 'Collection',
+      Tag: 'create virtual account tag'
+    }
+
+    MangoPay::VirtualAccount.create(wallet_id, create_virtual_account)
+  end
 end

data/spec/mangopay/virtual_account_spec.rb

@@ -0,0 +1,52 @@
+describe MangoPay::VirtualAccount do
+  include_context 'virtual_account'
+  include_context 'wallets'
+
+  describe 'CREATE' do
+    it 'can create a Virtual Account' do
+      wallet = new_wallet
+      virtual_account = new_virtual_account(wallet['Id'])
+      expect(virtual_account).not_to be_nil
+    end
+  end
+
+  describe 'DEACTIVATE' do
+    it 'deactivates a Virtual Account' do
+      wallet = new_wallet
+      virtual_account = new_virtual_account(wallet['Id'])
+      deactivated = MangoPay::VirtualAccount.deactivate(wallet['Id'], virtual_account['Id'])
+      expect(deactivated).not_to be_nil
+      expect(deactivated['Status']).to eq 'CLOSED'
+      expect(deactivated['Id']).to eq(virtual_account['Id'])
+    end
+  end
+
+  describe 'FETCH' do
+    it 'can get a Virtual Account' do
+      wallet = new_wallet
+      virtual_account = new_virtual_account(wallet['Id'])
+      fetched = MangoPay::VirtualAccount.fetch(wallet['Id'], virtual_account['Id'])
+      expect(fetched).not_to be_nil
+      expect(fetched['Id']).to eq(virtual_account['Id'])
+    end
+  end
+
+  describe 'FETCH ALL' do
+    it 'can get all Virtual Accounts for a wallet' do
+      wallet = new_wallet
+      virtual_account = new_virtual_account(wallet['Id'])
+      fetched_list = MangoPay::VirtualAccount.fetch_all(wallet['Id'])
+      expect(fetched_list).not_to be_nil
+      expect(fetched_list[0]['Id']).to eq(virtual_account['Id'])
+    end
+  end
+
+  describe 'FETCH AVAILABILITIES' do
+    it 'get availabilities' do
+      availabilities = MangoPay::VirtualAccount.fetch_availabilities
+      expect(availabilities).not_to be_nil
+      expect(availabilities['Collection']).not_to be_nil
+      expect(availabilities['UserOwned']).not_to be_nil
+    end
+  end
+end

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: mangopay
 version: !ruby/object:Gem::Version
-  version: 3.26.1
+  version: 3.27.0
 platform: ruby
 authors:
 - Geoffroy Lorieux
 - Sergiusz Woznicki
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-03 00:00:00.000000000 Z
+date: 2024-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -109,6 +109,7 @@ files:
 - lib/mangopay/ubo_declaration.rb
 - lib/mangopay/user.rb
 - lib/mangopay/version.rb
+- lib/mangopay/virtual_account.rb
 - lib/mangopay/wallet.rb
 - mangopay.gemspec
 - spec/mangopay/authorization_token_spec.rb
@@ -163,6 +164,7 @@ files:
 - spec/mangopay/ubo_declaration_spec.rb
 - spec/mangopay/ubo_spec.rb
 - spec/mangopay/user_spec.rb
+- spec/mangopay/virtual_account_spec.rb
 - spec/mangopay/wallet_spec.rb
 - spec/spec_helper.rb
 - spec/tmp/.keep
@@ -170,7 +172,7 @@ homepage: http://docs.mangopay.com/
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -186,7 +188,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.0.3.1
-signing_key:
+signing_key: 
 specification_version: 4
 summary: Ruby bindings for the version 2 of the MANGOPAY API
 test_files:
@@ -242,6 +244,7 @@ test_files:
 - spec/mangopay/ubo_declaration_spec.rb
 - spec/mangopay/ubo_spec.rb
 - spec/mangopay/user_spec.rb
+- spec/mangopay/virtual_account_spec.rb
 - spec/mangopay/wallet_spec.rb
 - spec/spec_helper.rb
 - spec/tmp/.keep