mundipagg_api 1.0.0

data/lib/mundipagg/CreditCardTransaction/credit_card_transaction.rb

@@ -0,0 +1,32 @@
+class CreditCardTransaction
+
+  attr_accessor :CreditCard
+
+  attr_accessor :Options
+
+  attr_accessor :Recurrency
+
+  attr_accessor :AmountInCents
+
+  attr_accessor :InstallmentCount
+
+  attr_accessor :CreditCardOperation
+
+  attr_accessor :TransactionReference
+
+  attr_accessor :TransactionDateInMerchant
+
+
+  def initialize
+    @Options = CreditCardTransactionOptions.new
+    @Recurrency = Recurrency.new
+    @CreditCard = CreditCard.new
+  end
+
+  def to_json
+    hash = {}
+    instance_variables.each {|var| hash[var.to_s.delete('@')] = instance_variable_get(var) }
+    hash
+  end
+
+end

data/lib/mundipagg/CreditCardTransaction/credit_card_transaction_data.rb

@@ -0,0 +1,104 @@
+require_relative '../../mundipagg/InstantBuy/credit_card_data'
+class CreditCardTransactionData
+  # Dados do cart�o de cr�dito
+  attr_accessor :CreditCard
+
+  # Status da transa��o de cart�o de cr�dito
+  attr_accessor :CreditCardTransactionStatus
+
+  @@CreditCardTransactionStatusEnum = {
+      :AuthorizedPendingCapture => '1',
+      :NotAuthorized => '2',
+      :ChargebackPreview => '3',
+      :RefundPreview => '4',
+      :DepositPreview => '5',
+      :Captured => '6',
+      :PartialCapture => '7',
+      :Refunded => '8',
+      :Voided => '9',
+      :Deposited => '10',
+      :Chargeback => '12',
+      :PendingVoid => '13',
+      :Invalid => '14',
+      :PartialAlthorize => '15',
+      :PartialRefunded => '16',
+      :OverCapture => '17',
+      :PartialVoid => '18',
+      :PendingRefund => '19',
+      :UnScheduled => '20',
+      :Created => '21',
+      :PartialAuthorized => '22',
+      :NotFoundInAcquirer => '23',
+      :PendingAuthorize => '24',
+      :WithError => '99'
+  }
+
+  # Chave da transa��o. Utilizada para identificar a transa��o de cart�o de cr�dito no gateway
+  attr_accessor :TransactionKey
+
+  # Identificador da transa��o gerado pela loja.
+  attr_accessor :TransactionIdentifier
+
+  # C�digo de autoriza��o retornado pela adquirente
+  attr_accessor :AcquirerAuthorizationCode
+
+  # Identificador �nico retornado pela adquirente
+  attr_accessor :UniqueSequentialNumber
+
+  # Valor original da transa��o em centavos
+  attr_accessor :AmountInCents
+
+  # Valor autorizado em centavos
+  attr_accessor :AuthorizedAmountInCents
+
+  # Valor capturado em centavos
+  attr_accessor :CapturedAmountInCents
+
+  # Valor estornado em centavos
+  attr_accessor :RefundedAmountInCents
+
+  # Valor cancelado em centavos
+  attr_accessor :VoidedAmountInCents
+
+  # Data da recorr�ncia (poder� ser futura)
+  attr_accessor :DueDate
+
+  # Identificador da transa��o no sistema da loja
+  attr_accessor :TransactionReference
+
+  # Data de cria��o da transa��o no gatewaya
+  attr_accessor :CreateDate
+
+  # Nome da adquirente que processou a transa��o
+  attr_accessor :AcquirerName
+
+  # Indica se � uma recorr�ncia
+  attr_accessor :IsRecurrency
+
+  # Total de parcelas na transa��o
+  attr_accessor :InstallmentCount
+
+  # C�digo de filia��o da loja na adquirente
+  attr_accessor :AffiliationCode
+
+  # C�digo do m�todo de pagamento
+  attr_accessor :PaymentMethodName
+
+  # Chave da transa��o na adquirente, enviada pelo gateway
+  attr_accessor :TransactionKeyToAcquirer
+
+  # Data limite para a captura da transa��o na adquirente
+  attr_accessor :CaptureExpirationDate
+
+  def initialize
+    @CreditCard = CreditCardData.new
+    @CreditCardTransactionStatus = self.CreditCardTransactionStatusEnum
+  end
+
+  def to_json
+    hash = {}
+    instance_variables.each {|var| hash[var.to_s.delete('@')] = instance_variable_get(var) }
+    hash
+  end
+
+end

data/lib/mundipagg/CreditCardTransaction/credit_card_transaction_options.rb

@@ -0,0 +1,27 @@
+class CreditCardTransactionOptions
+
+  attr_accessor :PaymentMethodCode
+
+  attr_accessor :CurrencyIso
+
+  attr_accessor :IataAmountInCents
+
+  attr_accessor :CaptureDelayInMinutes
+
+  attr_accessor :MerchantCategoryCode
+
+  attr_accessor :SoftDescriptorText
+
+  attr_accessor :InterestRate
+
+  attr_accessor :ExtendedLimitEnabled
+
+  attr_accessor :ExtendedLimitCode
+
+  def to_json
+    hash = {}
+    instance_variables.each {|var| hash[var.to_s.delete('@')] = instance_variable_get(var) }
+    hash
+  end
+
+end

data/lib/mundipagg/CreditCardTransaction/credit_card_transaction_report_file.rb

@@ -0,0 +1,29 @@
+class CreditCardTransactionReportFile
+  attr_accessor :Order
+  attr_accessor :TransactionKey
+  attr_accessor :TransactionKeyToAcquirer
+  attr_accessor :CreditCardTransactionReference
+  attr_accessor :CreditCardBrand
+  attr_accessor :CreditCardNumber
+  attr_accessor :InstallmentCount
+  attr_accessor :AcquirerName
+  attr_accessor :Status
+  attr_accessor :AmountInCents
+  attr_accessor :IataAmountInCents
+  attr_accessor :AuthorizationCode
+  attr_accessor :TransactionIdentifier
+  attr_accessor :UniqueSequentialNumber
+  attr_accessor :AuthorizedAmountInCents
+  attr_accessor :CapturedAmountInCents
+  attr_accessor :VoidedAmountInCents
+  attr_accessor :RefundedAmountInCents
+  attr_accessor :AcquirerAuthorizationReturnCode
+  attr_accessor :AuthorizedDate
+  attr_accessor :CapturedDate
+  attr_accessor :VoidedDate
+  attr_accessor :LastProbeDate
+
+  def initialize
+    @Order = OrderTransactionReportFile.new
+  end
+end

data/lib/mundipagg/CreditCardTransaction/manage_credit_card_transaction.rb

@@ -0,0 +1,12 @@
+# classe para usar nos metodos de cancel e capture
+class ManageCreditCardTransaction
+  attr_accessor :AmountInCents
+  attr_accessor :TransactionKey
+  attr_accessor :TransactionReference
+
+  def to_json
+    hash = {}
+    instance_variables.each {|var| hash[var.to_s.delete('@')] = instance_variable_get(var) }
+    hash
+  end
+end

data/lib/mundipagg/CreditCardTransaction/retry_sale_credit_card_transaction.rb

@@ -0,0 +1,13 @@
+class RetrySaleCreditCardTransaction
+
+  attr_accessor :TransactionKey
+
+  attr_accessor :SecurityCode
+
+  def to_json
+    hash = {}
+    instance_variables.each {|var| hash[var.to_s.delete('@')] = instance_variable_get(var) }
+    hash
+  end
+
+end

data/lib/mundipagg/ErrorItem.rb

@@ -0,0 +1,17 @@
+class ErrorItem
+
+  attr_accessor :ErrorCode
+
+  attr_accessor :ErrorField
+
+  attr_accessor :Description
+
+  attr_accessor :SeverityCode
+
+  def to_json
+    hash = {}
+    instance_variables.each {|var| hash[var.to_s.delete('@')] = instance_variable_get(var) }
+    hash
+  end
+  
+end

data/lib/mundipagg/ErrorReport.rb

@@ -0,0 +1,18 @@
+class ErrorReport
+
+  attr_accessor :Category
+
+  attr_accessor :ErrorItemCollection
+
+
+  def initialize
+    @ErrorItemCollection = Array.new;
+  end
+
+  def to_json
+    hash = {}
+    instance_variables.each {|var| hash[var.to_s.delete('@')] = instance_variable_get(var) }
+    hash
+  end
+
+end

data/lib/mundipagg/InstantBuy/credit_card_data.rb

@@ -0,0 +1,41 @@
+class CreditCardData
+  # N�mero mascardo do cart�o de cr�dito
+  attr_accessor :MaskedCreditCardNumber
+
+  # Bandeira do cart�o de cr�dito
+  attr_accessor :CreditCardBrand
+
+  @@CreditCardBrandEnum = {
+      :Visa => '1',
+      :MasterCard => '2',
+      :HiperCard => '3',
+      :Amex => '4',
+      :Diners => '5',
+      :Elo => '6',
+      :Aura => '7',
+      :Discover => '8',
+      :CasaShow => '9',
+      :Havan => '10',
+      :HugCard => '11',
+      :AndarAki => '12',
+      :LeaderCard => '13',
+      :Submarino => '14'
+  }
+
+  # Chave do cart�o de cr�dito. Utilizada para identificar um cart�o de cr�dito no gateway
+  attr_accessor :InstantBuyerKey
+
+  # Informa se o cart�o de cr�dito expirou
+  attr_accessor :IsExpiredCreditCard
+
+  def initialize
+    @CreditCardBrand = self.CreditCardBrandEnum
+  end
+
+  def to_json
+    hash = {}
+    instance_variables.each {|var| hash[var.to_s.delete('@')] = instance_variable_get(var) }
+    hash
+  end
+
+end

data/lib/mundipagg/InstantBuy/get_instant_buy_data_response.rb

@@ -0,0 +1,18 @@
+class GetInstantBuyDataResponse
+  # Lista de cart�es de cr�dito
+  attr_accessor :CreditCardDataCollection
+
+  # Total de cart�es de cr�dito retornados
+  attr_accessor :CreditCardDataCount
+
+  def initialize
+    @CreditCardDataCollection = Array.new
+  end
+
+  def to_json
+    hash = {}
+    instance_variables.each {|var| hash[var.to_s.delete('@')] = instance_variable_get(var) }
+    hash
+  end
+
+end

data/lib/mundipagg/Merchant/merchant.rb

@@ -0,0 +1,11 @@
+class Merchant
+  # Identificador da loja na plataforma
+  attr_accessor :MerchantReference
+
+  def to_json
+    hash = {}
+    instance_variables.each {|var| hash[var.to_s.delete('@')] = instance_variable_get(var) }
+    hash
+  end
+
+end

data/lib/mundipagg/MundipaggApi.rb

@@ -0,0 +1,336 @@
+require_relative '../../lib/mundipagg_api'
+
+class MundipaggApi
+
+  attr_reader :serviceEnvironment
+
+  attr_reader :merchantKey
+
+  def initialize(environment=:staging, merchantKey)
+    @serviceEnvironment = environment
+    @merchantKey = merchantKey
+    @@SERVICE_HEADERS = {:MerchantKey => "#{@merchantKey}", :Accept => 'application/json', :"Content-Type" => 'application/json'}
+  end
+
+  # URL de production
+  @@SERVICE_URL_PRODUCTION = 'https://transactionv2.mundipaggone.com/Sale/'
+
+  # URL de homologation
+  @@SERVICE_URL_STAGING = 'https://stagingv2.mundipaggone.com/Sale/'
+
+  # permite que o integrador adicione uma busca por transacoes utilizando alguns criterios
+  def Query(querySaleRequestEnum, key)
+    # try, tenta fazer o request
+    begin
+
+      # se for homologacao faz a chamada por aqui
+      if @serviceEnvironment == :staging
+        response = RestClient.get @@SERVICE_URL_STAGING + '/Query/' + querySaleRequestEnum + '=' + key, headers=@@SERVICE_HEADERS
+
+        # se for producao, faz a chamada por aqui
+      elsif @serviceEnvironment == :production
+        response = RestClient.get @@SERVICE_URL_PRODUCTION + '/Query/' + querySaleRequestEnum + '=' + key, headers=@@SERVICE_HEADERS
+      end
+
+        # se der algum erro, trata aqui
+    rescue RestClient::ExceptionWithResponse => err
+      return err.response
+    end
+
+    # se n�o houver erros, trata o json e retorna o objeto
+    querySaleResponse = JSON.load response
+    querySaleResponse
+  end
+
+  # criar uma transacao na plataforma One utilizando um ou mais meios de pagamento
+  def CreateSale(createSaleRequest)
+
+    saleHash = createSaleRequest.to_json
+
+    saleHash['BoletoTransactionCollection'] = []
+
+    saleHash['CreditCardTransactionCollection'] = []
+
+    saleHash['ShoppingCartCollection'] = []
+
+    begin
+      # transforma a colecao de boleto em json
+      if createSaleRequest.BoletoTransactionCollection.any? == false || createSaleRequest.BoletoTransactionCollection.nil?
+        saleHash['BoletoTransactionCollection'] = nil
+
+      else
+        createSaleRequest.BoletoTransactionCollection.each_with_index do |boleto, index|
+          b = boleto.to_json
+          saleHash['BoletoTransactionCollection'] << b
+
+          if boleto.Options.to_json.any?
+            boleto_options = boleto.Options.to_json
+            saleHash['BoletoTransactionCollection'][index]['Options'] = boleto_options
+          else
+            saleHash['BoletoTransactionCollection'][index]['Options'] = nil
+          end
+
+          if boleto.BillingAddress.to_json.any?
+            boleto_billing_address = boleto.BillingAddress.to_json
+            saleHash['BoletoTransactionCollection'][index]['BillingAddress'] = boleto_billing_address
+          else
+            saleHash['BoletoTransactionCollection'][index]['BillingAddress'] = nil
+          end
+        end
+      end
+
+      # transforma a colecao de cartao de credito em json
+      if createSaleRequest.CreditCardTransactionCollection.any? == false || createSaleRequest.CreditCardTransactionCollection.nil?
+        saleHash['CreditCardTransactionCollection'] = nil
+      else
+        createSaleRequest.CreditCardTransactionCollection.each_with_index do |creditCard, index|
+          c = creditCard.to_json
+          saleHash['CreditCardTransactionCollection'] << c
+
+          if creditCard.Options.to_json.any?
+            credit_card_options = creditCard.Options.to_json
+            saleHash['CreditCardTransactionCollection'][index]['Options'] = credit_card_options
+          else
+            saleHash['CreditCardTransactionCollection'][index]['Options'] = nil
+          end
+
+          if creditCard.Recurrency.to_json.any?
+            credit_card_recurrency = creditCard.Recurrency.to_json
+            saleHash['CreditCardTransactionCollection'][index]['Recurrency'] = credit_card_recurrency
+          else
+            saleHash['CreditCardTransactionCollection'][index]['Recurrency'] = nil
+          end
+
+          if creditCard.CreditCard.to_json.any?
+            credit_card_item = creditCard.CreditCard.to_json
+            saleHash['CreditCardTransactionCollection'][index]['CreditCard'] = credit_card_item
+
+            if creditCard.CreditCard.BillingAddress.to_json.any?
+              credit_card_billing_address = creditCard.CreditCard.BillingAddress.to_json
+              saleHash['CreditCardTransactionCollection'][index]['CreditCard']['BillingAddress'] = credit_card_billing_address
+            else
+              saleHash['CreditCardTransactionCollection'][index]['CreditCard']['BillingAddress'] = nil
+            end
+
+          else
+            saleHash['CreditCardTransactionCollection'][index]['CreditCard'] = nil
+          end
+        end
+      end
+
+      # transforma a colecao de shoppingcart em json
+      if createSaleRequest.ShoppingCartCollection.any? == false || createSaleRequest.ShoppingCartCollection.nil?
+        saleHash['ShoppingCartCollection'] = nil
+      else
+        createSaleRequest.ShoppingCartCollection.each_with_index do |shoppingCart, index|
+          s = shoppingCart.to_json
+          saleHash['ShoppingCartCollection'] << s
+
+          if shoppingCart.DeliveryAddress.to_json.any?
+            delivery_address = shoppingCart.DeliveryAddress.to_json
+            saleHash['ShoppingCartCollection'][index]['DeliveryAddress'] = delivery_address
+          else
+            saleHash['ShoppingCartCollection'][index]['DeliveryAddress'] = nil
+          end
+
+          if shoppingCart.ShoppingCartItemCollection.any?
+            shoppingCart.ShoppingCartItemCollection.each do |cartItem|
+              item = cartItem.to_json
+              saleHash['ShoppingCartCollection'][index]['ShoppingCartItemCollection'] << item
+            end
+          else
+            saleHash['ShoppingCartCollection'][index]['ShoppingCartItemCollection'] = nil
+          end
+        end
+      end
+
+      # transforma objeto options em json
+      if createSaleRequest.Options.to_json.any?
+        o = createSaleRequest.Options.to_json
+        saleHash['Options'] = o
+      else
+        saleHash['Options'] = nil
+      end
+
+      # transforma objeto order em json
+      if createSaleRequest.Order.to_json.any?
+        order = createSaleRequest.Order.to_json
+        saleHash['Order'] = order
+      else
+        saleHash['Order'] = nil
+      end
+
+      # transforma objeto merchant em json
+      if createSaleRequest.Merchant.to_json.any?
+        merchant = createSaleRequest.Merchant.to_json
+        saleHash['Merchant'] = merchant
+      else
+        saleHash['Merchant'] = nil
+      end
+
+      # transforma objeto request data em json
+      if createSaleRequest.RequestData.to_json.any?
+        request_data = createSaleRequest.RequestData.to_json
+        saleHash['RequestData'] = request_data
+      else
+        saleHash['RequestData'] = nil
+      end
+
+      # transforma o objeto Buyer em json
+      if createSaleRequest.Buyer.to_json.any? && createSaleRequest.Buyer.AddressCollection.any?
+        b = createSaleRequest.Buyer.to_json
+        saleHash['Buyer'] = b
+
+        if createSaleRequest.Buyer.AddressCollection.any?
+          saleHash['Buyer']['AddressCollection'] = []
+          createSaleRequest.Buyer.AddressCollection.each do |address|
+            a = address.to_json
+            saleHash['Buyer']['AddressCollection'] << a
+          end
+        else
+          saleHash['Buyer']['AddressCollection'] = nil
+        end
+      else
+        saleHash['Buyer'] = nil
+      end
+    rescue Exception => e
+      puts e.message
+    end
+
+    if @serviceEnvironment == :staging
+      url = @@SERVICE_URL_STAGING
+    elsif @serviceEnvironment == :production
+      url = @@SERVICE_URL_PRODUCTION
+    end
+    postRequest(saleHash.to_json, url)
+  end
+
+  # permite forcar a retentativa manualmente de uma transacao (podendo ser tambem uma recorrencia) nao autorizada
+  def Retry(retrySaleRequest)
+    saleHash = retrySaleRequest.to_json
+    saleHash['RetrySaleCreditCardTransactionCollection'] = []
+
+    begin
+      if retrySaleRequest.RetrySaleCreditCardTransactionCollection != nil
+        retrySaleRequest.RetrySaleCreditCardTransactionCollection.each do |retrySale|
+          r = retrySale.to_json
+          saleHash['RetrySaleCreditCardTransactionCollection'] << r
+
+          if retrySaleRequest.Options.to_json.any?
+            retry_options = retrySaleRequest.Options.to_json
+            saleHash['Options'] = retry_options
+          else
+            saleHash['Options'] = nil
+          end
+        end
+      end
+    rescue Exception => e
+      puts e.message
+    end
+    if @serviceEnvironment == :staging
+      url = @@SERVICE_URL_STAGING + '/Retry'
+    elsif @serviceEnvironment == :production
+      url = @@SERVICE_URL_PRODUCTION + '/Retry'
+    end
+    postRequest(saleHash.to_json, url)
+  end
+
+  # eh uma forma de desfazer uma transação com cartao de credito mesmo a transacao sendo capturada
+  def Cancel(cancelSaleRequest)
+    saleHash = cancelSaleRequest.to_json
+    saleHash['CreditCardTransactionCollection'] = []
+
+    begin
+      if cancelSaleRequest.CreditCardTransactionCollection != nil
+        cancelSaleRequest.CreditCardTransactionCollection.each do |creditCard|
+          c = creditCard.to_json
+          saleHash['CreditCardTransactionCollection'] << c
+        end
+      end
+    rescue Exception => e
+      puts e.message
+    end
+    if @serviceEnvironment == :staging
+      url = @@SERVICE_URL_STAGING + '/Cancel'
+    elsif @serviceEnvironment == :production
+      url = @@SERVICE_URL_PRODUCTION + '/Cancel'
+    end
+    postRequest(saleHash.to_json, url)
+  end
+
+  # confirmacao de uma transacao de cartao de credito que ja fora autorizada
+  def Capture(captureRequest)
+    saleHash = captureRequest.to_json
+    saleHash['CreditCardTransactionCollection'] = []
+
+    begin
+      if captureRequest.CreditCardTransactionCollection != nil
+        captureRequest.CreditCardTransactionCollection.each do |creditCard|
+          c = creditCard.to_json
+          saleHash['CreditCardTransactionCollection'] << c
+        end
+      end
+    rescue Exception => e
+      puts e.message
+    end
+    if @serviceEnvironment == :staging
+      url = @@SERVICE_URL_STAGING + '/Capture'
+    elsif @serviceEnvironment == :production
+      url = @@SERVICE_URL_PRODUCTION + '/Capture'
+    end
+    postRequest(saleHash.to_json, url)
+  end
+
+  # faz um parse do xml de post notificaton
+  def ParseXmlToNotification(xml)
+    begin
+      response = PostNotification.ParseNotification(xml)
+    rescue Exception => err
+      return err.response
+    end
+
+    return response
+  end
+
+  # faz uma requisicao e retorna uma string com o transaction report file
+  def TransactionReportFile(date)
+    begin
+      response = RestClient.get('https://api.mundipaggone.com/TransactionReportFile/GetStream?fileDate=' + date.strftime("%Y%m%d"), headers={:MerchantKey => "#{@merchantKey}"})
+    rescue RestClient::ExceptionWithResponse => err
+      return err.response
+    end
+    return response
+  end
+
+  def TransactionReportFileDownloader(date, file_name, path)
+    begin
+      path = path + file_name + '.txt'
+      response = RestClient.get('https://api.mundipaggone.com/TransactionReportFile/GetStream?fileDate=' + date.strftime("%Y%m%d"), headers={:MerchantKey => "#{@merchantKey}"})
+      File.write(path, response)
+    rescue RestClient::ExceptionWithResponse => err
+      return err.response
+    end
+  end
+
+  # faz o parse da string recebida do transaction report file e retorna um hash
+  def TransactionReportFileParser(file_to_parse)
+    transaction_report_file = TransactionReportFile.new
+    begin
+      response = transaction_report_file.TransactionReportFileParser(file_to_parse)
+    rescue Exception=>err
+      return err
+    end
+    return response
+  end
+
+  def postRequest(payload, url)
+    response = nil
+    begin
+      response = RestClient.post(url, payload, headers=@@SERVICE_HEADERS)
+    rescue RestClient::ExceptionWithResponse => err
+      return err.response #err.response
+    end
+    json_response = JSON.load response
+    json_response
+  end
+end