mangopay 3.26.1 → 3.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cea2df4d903ca0809a7f7ef9bc42b0263ee2df6ff5ba71fdd37a99c081b96ca3
-  data.tar.gz: 4abceca571bd69f5a47c0597b674ed6869c91f16ddb9408da6b28d23ff24e04e
+  metadata.gz: cc9a455fb7af8971bada1a74b9bd9b95e1eeffcb0c564ff8730e545328a176e5
+  data.tar.gz: 988e0bcd0efcdf4b606fd5702b14b057e20e074629bb131b6bd0a9ba3bf8e7db
 SHA512:
-  metadata.gz: 73bec6513fa3016b23164e62680c12f5a030b2e150b02fbf01fb4a93973b8e5071dd72e17a92e4de188e6492c70404561062235563038d60c077853c02beb83c
-  data.tar.gz: 807e1c583b1114fa34b750500de47b9ea827a6975d06652bac235ffd1139a161e088e48afda6c1a103788cc6cfb60e1689c7f20d762fa713772f1b266aecb9ac
+  metadata.gz: 0a12f03e94a555fec121e7eadc4d594a49d9a0398c78629fee555c8e9361569a33f9eed5998b0872474cf92ffcd617a6f0ac7d5412e4d934208480baf4c17c0d
+  data.tar.gz: 6cdbbc86797db65b537fd839015e4c7cfec85e5cea26c42a53bfe8856dbbc3b6857dc78aa0d6a43a47a0010eb587597ca32c7288a529d51a8ef5419df2b624ac

data/CHANGELOG.md

@@ -1,3 +1,24 @@
+## [3.28.0] - 2024-11-15
+### Added
+
+New endpoint for [The TWINT PayIn object](https://docs.mangopay.com/api-reference/twint/twint-payin-object#the-twint-payin-object):
+- [Create a TWINT PayIn](https://docs.mangopay.com/api-reference/twint/create-twint-payin)
+- [View a PayIn (TWINT)](https://docs.mangopay.com/api-reference/twint/view-payin-twint)
+
+New endpoint for [The Swish PayIn object](https://docs.mangopay.com/api-reference/swish/swish-payin-object):
+- [Create a Swish PayIn](https://docs.mangopay.com/api-reference/swish/create-swish-payin)
+- [View a PayIn (Swish)](https://docs.mangopay.com/api-reference/swish/view-payin-swish)
+
+## [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/pay_in.rb

@@ -243,6 +243,26 @@ module MangoPay
       end
     end
 
+    module Twint
+      class Web < Resource
+        include HTTPCalls::Create
+
+        def self.url(*)
+          "#{MangoPay.api_path}/payins/payment-methods/twint"
+        end
+      end
+    end
+
+    module Swish
+      class Web < Resource
+        include HTTPCalls::Create
+
+        def self.url(*)
+          "#{MangoPay.api_path}/payins/payment-methods/swish"
+        end
+      end
+    end
+
     module RecurringPayments
       class Recurring < Resource
         include HTTPCalls::Create

data/lib/mangopay/version.rb

@@ -1,3 +1,3 @@
 module MangoPay
-  VERSION = '3.26.1'
+  VERSION = '3.28.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/payin_swish_web_spec.rb

@@ -0,0 +1,30 @@
+describe MangoPay::PayIn::Swish::Web, type: :feature do
+  include_context 'wallets'
+  include_context 'payins'
+
+  def check_type_and_status(payin)
+    expect(payin['Type']).to eq('PAYIN')
+    expect(payin['Nature']).to eq('REGULAR')
+    expect(payin['PaymentType']).to eq('SWISH')
+    expect(payin['ExecutionType']).to eq('WEB')
+    expect(payin['Status']).to eq('CREATED')
+  end
+
+  describe 'CREATE' do
+    it 'creates a swish web payin' do
+      created = new_payin_swish_web
+      expect(created['Id']).not_to be_nil
+      check_type_and_status(created)
+    end
+  end
+
+  describe 'FETCH' do
+    it 'fetches a payin' do
+      created = new_payin_swish_web
+      fetched = MangoPay::PayIn.fetch(created['Id'])
+      expect(fetched['Id']).to eq(created['Id'])
+      check_type_and_status(created)
+      check_type_and_status(fetched)
+    end
+  end
+end

data/spec/mangopay/payin_twint_web_spec.rb

@@ -0,0 +1,30 @@
+describe MangoPay::PayIn::Twint::Web, type: :feature do
+  include_context 'wallets'
+  include_context 'payins'
+
+  def check_type_and_status(payin)
+    expect(payin['Type']).to eq('PAYIN')
+    expect(payin['Nature']).to eq('REGULAR')
+    expect(payin['PaymentType']).to eq('TWINT')
+    expect(payin['ExecutionType']).to eq('WEB')
+    expect(payin['Status']).to eq('CREATED')
+  end
+
+  describe 'CREATE' do
+    it 'creates a twint web payin' do
+      created = new_payin_twint_web
+      expect(created['Id']).not_to be_nil
+      check_type_and_status(created)
+    end
+  end
+
+  describe 'FETCH' do
+    it 'fetches a payin' do
+      created = new_payin_twint_web
+      fetched = MangoPay::PayIn.fetch(created['Id'])
+      expect(fetched['Id']).to eq(created['Id'])
+      check_type_and_status(created)
+      check_type_and_status(fetched)
+    end
+  end
+end

data/spec/mangopay/shared_resources.rb

@@ -83,6 +83,15 @@ shared_context 'wallets' do
     )
   end
 
+  def create_new_custom_wallet(user, currency)
+    MangoPay::Wallet.create(
+      Owners: [user['Id']],
+      Description: 'A test wallet',
+      Currency: currency,
+      Tag: 'Test wallet'
+    )
+  end
+
   def wallets_check_amounts(wlt1, amnt1, wlt2 = nil, amnt2 = nil)
     expect(wlt1['Balance']['Amount']).to eq amnt1
     expect(wlt2['Balance']['Amount']).to eq amnt2 if wlt2
@@ -570,6 +579,36 @@ shared_context 'payins' do
     )
   end
 
+  ###############################################
+  # Twint/web
+  ###############################################
+  let(:new_payin_twint_web) do
+    MangoPay::PayIn::Twint::Web.create(
+      AuthorId: new_natural_user['Id'],
+      CreditedWalletId: create_new_custom_wallet(new_natural_user, 'CHF')['Id'],
+      DebitedFunds: { Currency: 'CHF', Amount: 50 },
+      Fees: { Currency: 'CHF', Amount: 10 },
+      ReturnURL: 'http://www.my-site.com/returnURL',
+      StatementDescriptor: "test",
+      Tag: 'Test PayIn/Twint/Web'
+    )
+  end
+
+  ###############################################
+  # Swish/web
+  ###############################################
+  let(:new_payin_swish_web) do
+    MangoPay::PayIn::Swish::Web.create(
+      AuthorId: new_natural_user['Id'],
+      CreditedWalletId: create_new_custom_wallet(new_natural_user, 'SEK')['Id'],
+      DebitedFunds: { Currency: 'SEK', Amount: 400 },
+      Fees: { Currency: 'SEK', Amount: 10 },
+      ReturnURL: 'http://www.my-site.com/returnURL',
+      StatementDescriptor: "test",
+      Tag: 'Test PayIn/Swish/Web'
+    )
+  end
+
   ###############################################
   # PAYPAL/web V2
   ###############################################
@@ -998,4 +1037,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.28.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-11-15 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
@@ -149,6 +150,8 @@ files:
 - spec/mangopay/payin_paypal_web_spec.rb
 - spec/mangopay/payin_preauthorized_direct_spec.rb
 - spec/mangopay/payin_satispay_web_spec.rb
+- spec/mangopay/payin_swish_web_spec.rb
+- spec/mangopay/payin_twint_web_spec.rb
 - spec/mangopay/payment_method_metadata_spec.rb
 - spec/mangopay/payout_bankwire_spec.rb
 - spec/mangopay/preauthorization_spec.rb
@@ -163,6 +166,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 +174,7 @@ homepage: http://docs.mangopay.com/
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -186,7 +190,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:
@@ -228,6 +232,8 @@ test_files:
 - spec/mangopay/payin_paypal_web_spec.rb
 - spec/mangopay/payin_preauthorized_direct_spec.rb
 - spec/mangopay/payin_satispay_web_spec.rb
+- spec/mangopay/payin_swish_web_spec.rb
+- spec/mangopay/payin_twint_web_spec.rb
 - spec/mangopay/payment_method_metadata_spec.rb
 - spec/mangopay/payout_bankwire_spec.rb
 - spec/mangopay/preauthorization_spec.rb
@@ -242,6 +248,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