mangopay-v4 4.0.0

data/lib/mangopay/model/request/submit_document_request.rb

@@ -0,0 +1,14 @@
+require_relative '../../common/jsonifier'
+
+# Model object for body of a request to submit a document for approval
+class SubmitDocumentRequest
+  include MangoPay::Jsonifier
+
+  # [String] Custom data added with the request
+  attr_accessor :tag
+
+  def initialize(tag = nil)
+    self.tag = tag
+    @status = MangoModel::DocumentStatus::VALIDATION_ASKED
+  end
+end

data/lib/mangopay/model/request/submit_ubo_declaration_request.rb

@@ -0,0 +1,14 @@
+require_relative '../../common/jsonifier'
+
+# Model object for body of request to submit a UBO declaration for approval
+class SubmitUboDeclarationRequest
+  include MangoPay::Jsonifier
+
+  # [String] Custom data added with the request
+  attr_accessor :tag
+
+  def initialize(tag = nil)
+    self.tag = tag
+    @status = MangoModel::UboDeclarationStatus::VALIDATION_ASKED
+  end
+end

data/lib/mangopay/model/request/upload_file_request.rb

@@ -0,0 +1,9 @@
+require_relative '../../common/jsonifier'
+
+# Model object for body of request to upload a file
+class UploadFileRequest
+  include MangoPay::Jsonifier
+
+  # [String] Base64-encoded file to be uploaded
+  attr_accessor :file
+end

data/lib/mangopay/model/response_replica.rb

@@ -0,0 +1,27 @@
+require_relative '../common/jsonifier'
+
+module MangoModel
+
+  # Replication of a previous request's response
+  class ResponseReplica
+    include MangoPay::Jsonifier
+
+    # [String] Original response's status code
+    attr_accessor :status_code
+
+    # [String] Value of the original response's Content-Length header
+    attr_accessor :content_length
+
+    # [String] Value of the original response's Content-Type header
+    attr_accessor :content_type
+
+    # [DateTime] Time of request of the original response
+    attr_accessor :long_date
+
+    # [Object] The original response object
+    attr_accessor :resource
+
+    # [String] URL of the original request
+    attr_accessor :request_url
+  end
+end

data/lib/mangopay/util/custom_formatter.rb

@@ -0,0 +1,12 @@
+# Formatter for log messages
+class CustomFormatter < Logger::Formatter
+  def call(severity, time, progname, msg)
+    "[#{time}] #{five_chars(severity)} - #{progname}: #{msg2str(msg)}\n"
+  end
+
+  def five_chars(string)
+    result = ''
+    (5 - string.length).times { result << ' ' }
+    result + string
+  end
+end

data/lib/mangopay/util/custom_logger.rb

@@ -0,0 +1,34 @@
+require 'logger'
+
+# Custom Logger implementation which handles concatenation
+# of multiple provided arguments into the log message string,
+# allowing for much cleaner logging statements.
+class CustomLogger < Logger
+
+  def debug(message, *args)
+    super(format(message, args))
+  end
+
+  def info(message, *args)
+    super(format(message, args))
+  end
+
+  def warn(message, *args)
+    super(format(message, args))
+  end
+
+  def error(message, *args)
+    super(format(message, args))
+  end
+
+  def fatal(message, *args)
+    super(format(message, args))
+  end
+
+  def format(msg, msg_args)
+    msg_args.each do |arg|
+      msg.sub! '{}', arg.to_s
+    end
+    msg
+  end
+end

data/lib/mangopay/util/enum.rb

@@ -0,0 +1,52 @@
+# Extend in order to apply methods for Enum instantiation.
+module Enum
+
+  # Restrict enum instantiation to the +value+ method.
+  def self.extended(base)
+    base.class_eval do
+      disable_instantiation
+    end
+  end
+
+  def value_of(string)
+    value = nil
+    constants.each do |const|
+      value = const_get const if const.to_s == string
+    end
+    value
+  end
+
+  private
+
+  # Temporary self-called method which instantiates Enums.
+  # Assign returned values to accordingly-named constant variables.
+  #
+  # @param +enum_value+ Representation value for the Enum instance
+  def value(enum_value)
+    enable_instantiation
+    enum_instance = new
+    disable_instantiation
+    enum_instance.instance_variable_set :@value, enum_value
+    enum_instance.define_singleton_method :to_s do
+      enum_value.to_s
+    end
+    enum_instance
+  end
+
+  # Enables instantiation of extending class.
+  def enable_instantiation
+    class_eval do
+      define_method :initialize do
+      end
+    end
+  end
+
+  # Disables instantiation of extending class.
+  def disable_instantiation
+    class_eval do
+      define_method :initialize do
+        raise 'Use the Enum#value method to instantiate Enums.'
+      end
+    end
+  end
+end

data/lib/mangopay/util/file_encoder.rb

@@ -0,0 +1,16 @@
+require 'base64'
+
+# Encodes files
+module FileEncoder
+  class << self
+
+    # Encodes a file to a Base64 string.
+    #
+    # @param +path+ [String] path to the file to be encoded
+    # @return [String] the file as a Base64-encoded string
+    def encode_base64(path)
+      data = File.open(path, 'rb', &:read)
+      Base64.strict_encode64 data
+    end
+  end
+end

data/lib/mangopay/util/non_instantiable.rb

@@ -0,0 +1,6 @@
+# To be extended in order to render a class non-instantiable
+module NonInstantiable
+  def initialize(*_args)
+    raise "Cannot instantiate #{self.class.name.split('::').last}"
+  end
+end

data/lib/mangopay/util/storage_strategy.rb

@@ -0,0 +1,10 @@
+require_relative 'enum'
+
+# Storage strategy enumeration
+class StorageStrategy
+  extend Enum
+
+  MEMORY = value 'MEMORY'
+
+  FILE = value 'FILE'
+end

data/lib/mangopay/util/void_logger.rb

@@ -0,0 +1,6 @@
+# Logger implementation which will not print any messages.
+class VoidLogger < CustomLogger
+  def initialize(*_args); end
+
+  def add(*_args, &_block); end
+end

data/mangopay.gemspec

@@ -0,0 +1,32 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), 'lib'))
+
+require 'mangopay'
+
+Gem::Specification.new do |spec|
+  spec.name = 'mangopay-v4'
+  spec.version = MangoPay::VERSION
+  spec.summary = 'Ruby bindings for the version 2 of the MANGOPAY API'
+  spec.description = <<-EOF
+  The mangopay Gem makes interacting with MANGOPAY Services much easier.
+  For any questions regarding the use of MANGOPAY's Services feel free to contact us at http://www.mangopay.com/get-started-2/
+  You can find more documentation about MANGOPAY Services at http://docs.mangopay.com/
+  EOF
+  spec.authors = ['Paul Hristea']
+  spec.email = 'support@mangopay.com'
+  spec.homepage = 'http://docs.mangopay.com/'
+  spec.license = 'MIT'
+
+  spec.required_ruby_version = '>= 1.9.2'
+
+  spec.add_dependency('multi_json', '>= 1.7.7')
+
+  spec.add_development_dependency('rake', '>= 10.1.0')
+  spec.add_development_dependency('rspec', '>= 3.0.0')
+
+  spec.files = `git ls-files`.split("\n")
+  spec.test_files = `git ls-files -- spec/*`.split("\n")
+  spec.executables = `git ls-files -- bin/*`
+                     .split("\n")
+                     .map { |file| File.basename(file) }
+  spec.require_paths = ['lib']
+end

data/spec/context/address_context.rb

@@ -0,0 +1,25 @@
+shared_context 'address_context' do
+
+  let(:address_data) { build_address }
+end
+
+def build_address
+  address = MangoModel::Address.new
+  address.address_line1 = 'Test st., no. 18'
+  address.address_line2 = 'bl. 16, int. 32'
+  address.city = 'Brasov'
+  address.region = 'Tractoru'
+  address.postal_code = '505600'
+  address.country = MangoModel::CountryIso::RO
+  address
+end
+
+def its_the_same_address(address1, address2)
+  address1.address_line1 == address2.address_line1\
+    && address1.address_line2 == address2.address_line2\
+    && address1.city == address2.city\
+    && address1.region == address2.region\
+    && address1.region == address2.region\
+    && address1.postal_code == address2.postal_code\
+    && address1.country.eql?(address2.country)
+end

data/spec/context/bank_account_context.rb

@@ -0,0 +1,138 @@
+require_relative 'user_context'
+require_relative '../../lib/mangopay/model/entity/account/iban_bank_account'
+require_relative '../../lib/mangopay/model/entity/account/us_bank_account'
+require_relative '../../lib/mangopay/model/entity/account/ca_bank_account'
+require_relative '../../lib/mangopay/model/entity/account/gb_bank_account'
+require_relative '../../lib/mangopay/model/entity/account/other_bank_account'
+require_relative '../../lib/mangopay/api/service/bank_accounts'
+
+shared_context 'bank_account_context' do
+  include_context 'user_context'
+
+  IBAN_ACCOUNT_DATA ||= build_iban_account
+  US_CHECKING_ACCOUNT_DATA ||= build_us_checking_account
+  US_SAVINGS_ACCOUNT_DATA ||= build_us_savings_account
+  CA_ACCOUNT_DATA ||= build_ca_account
+  GB_ACCOUNT_DATA ||= build_gb_account
+  OTHER_ACCOUNT_DATA ||= build_other_account
+  IBAN_ACCOUNT_PERSISTED ||= persist_account IBAN_ACCOUNT_DATA
+  US_CHECKING_ACCOUNT_PERSISTED ||= persist_account US_CHECKING_ACCOUNT_DATA
+  US_SAVINGS_ACCOUNT_PERSISTED ||= persist_account US_SAVINGS_ACCOUNT_DATA
+  CA_ACCOUNT_PERSISTED ||= persist_account CA_ACCOUNT_DATA
+  GB_ACCOUNT_PERSISTED ||= persist_account GB_ACCOUNT_DATA
+  OTHER_ACCOUNT_PERSISTED ||= persist_account OTHER_ACCOUNT_DATA
+
+  let(:new_iban_account_persisted) { persist_account IBAN_ACCOUNT_DATA }
+  let(:new_us_checking_account_persisted) { persist_account US_CHECKING_ACCOUNT_DATA }
+  let(:new_us_savings_account_persisted) { persist_account US_SAVINGS_ACCOUNT_DATA }
+  let(:new_ca_account_persisted) { persist_account CA_ACCOUNT_DATA }
+  let(:new_gb_account_persisted) { persist_account GB_ACCOUNT_DATA }
+  let(:new_other_account_persisted) { persist_account OTHER_ACCOUNT_DATA }
+end
+
+def persist_account(account)
+  MangoApi::BankAccounts.create account
+end
+
+def build_iban_account
+  account = MangoModel::IbanBankAccount.new
+  add_user_details account
+  account.iban = 'FR7618829754160173622224154'
+  account.bic = 'CMBRFR2BCME'
+  account
+end
+
+def build_us_account
+  account = MangoModel::UsBankAccount.new
+  add_user_details account
+  account.account_number = '234234234234'
+  account.aba = '234334789'
+  account
+end
+
+def build_us_checking_account
+  account = build_us_account
+  account.deposit_account_type = MangoModel::DepositType::CHECKING
+  account
+end
+
+def build_us_savings_account
+  account = build_us_account
+  account.deposit_account_type = MangoModel::DepositType::SAVINGS
+  account
+end
+
+def build_ca_account
+  account = MangoModel::CaBankAccount.new
+  add_user_details account
+  account.institution_number = '123'
+  account.account_number = '234234234234'
+  account.branch_code = '12345'
+  account.bank_name = 'Mango Bank'
+  account
+end
+
+def build_gb_account
+  account = MangoModel::GbBankAccount.new
+  add_user_details account
+  account.sort_code = '200000'
+  account.account_number = '63956474'
+  account
+end
+
+def build_other_account
+  account = MangoModel::OtherBankAccount.new
+  add_user_details account
+  account.bic = 'BINAADADXXX'
+  account.account_number = '234234234234'
+  account.country = MangoModel::CountryIso::FR
+  account
+end
+
+def add_user_details(account)
+  user = NATURAL_USER_PERSISTED
+  account.user_id = user.id
+  account.owner_name = user.first_name + ' ' + user.last_name
+  account.owner_address = user.address
+end
+
+def its_the_same_iban(account1, account2)
+  return false unless its_the_same_account(account1, account2)
+  account1.iban == account2.iban\
+    && account1.bic == account2.bic
+end
+
+def its_the_same_us(account1, account2)
+  return false unless its_the_same_account(account1, account2)
+  account1.account_number == account2.account_number\
+    && account1.aba == account2.aba\
+    && account1.deposit_account_type.eql?(account2.deposit_account_type)
+end
+
+def its_the_same_ca(account1, account2)
+  return false unless its_the_same_account(account1, account2)
+  account1.institution_number == account2.institution_number\
+    && account1.account_number == account2.account_number\
+    && account1.branch_code == account2.branch_code\
+    && account1.bank_name == account2.bank_name
+end
+
+def its_the_same_gb(account1, account2)
+  return false unless its_the_same_account(account1, account2)
+  account1.sort_code == account2.sort_code\
+    && account1.account_number == account2.account_number
+end
+
+def its_the_same_other(account1, account2)
+  return false unless its_the_same_account(account1, account2)
+  account1.bic == account2.bic\
+    && account1.account_number == account2.account_number\
+    && account1.country.eql?(account2.country)
+end
+
+def its_the_same_account(account1, account2)
+  account1.user_id == account2.user_id\
+    && account1.type.eql?(account2.type)\
+    && account1.owner_name == account2.owner_name\
+    && its_the_same_address(account1.owner_address, account2.owner_address)
+end

data/spec/context/card_context.rb

@@ -0,0 +1,46 @@
+require_relative 'user_context'
+require_relative '../../lib/mangopay/model/entity/card_registration'
+require_relative '../../lib/mangopay/api/service/cards'
+
+shared_context 'card_context' do
+  include_context 'user_context'
+
+  CARD_REGISTRATION_DATA ||= build_card_registration
+  CARD_REGISTRATION_PERSISTED ||= persist_card_registration CARD_REGISTRATION_DATA
+  # MangoPay test data
+  CARD_NUMBER ||= '4970100000000154'
+  CARD_EXPIRATION ||= '1218'
+  CARD_CVX ||= '123'
+  CARD_REGISTRATION_COMPLETED ||= complete_card_registration CARD_REGISTRATION_PERSISTED
+  CARD ||= retrieve_card CARD_REGISTRATION_COMPLETED.card_id
+end
+
+def persist_card_registration(card_registration)
+  MangoApi::Cards.create_registration card_registration
+end
+
+def complete_card_registration(card_registration)
+  test_body = "data=#{card_registration.preregistration_data}" +
+         "&accessKeyRef=#{card_registration.access_key}" +
+         "&cardNumber=#{CARD_NUMBER}" +
+         "&cardExpirationDate=#{CARD_EXPIRATION}" +
+         "&cardCvx=#{CARD_CVX}"
+
+  uri = URI(card_registration.card_registration_url)
+  response = MangoApi::HttpClient.post_raw(uri) do |request|
+    request.body = test_body
+  end
+  MangoApi::Cards.complete_registration(CARD_REGISTRATION_PERSISTED.id, response.to_s)
+end
+
+def build_card_registration
+  registration = MangoModel::CardRegistration.new
+  registration.user_id = NATURAL_USER_PERSISTED.id
+  registration.card_type = MangoModel::CardType::CB_VISA_MASTERCARD
+  registration.currency = MangoModel::CurrencyIso::EUR
+  registration
+end
+
+def retrieve_card(id)
+  MangoApi::Cards.get id
+end