mundipagg 1.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: bbf3d7205f733e00f3692647442de84ff6416f4a
+  data.tar.gz: 7d10653f59d31e4579d6d132082e5fb838e80d91
+SHA512:
+  metadata.gz: a9dac6bc5d3b949c71aa863a46e59c582fa4adfddea857c4dc1bb3a9aa8a2b74e6346201644ac9497ea7becc71fe4aa4331db7752513e85f81c39d596f2d3cc5
+  data.tar.gz: afc809a2a9e9efa1a3cd226c72d550e031dad18d61d91c939830efa862add9c5ac69ab26ec78517aaa0ad8dc0827963177400b5e39e31adacb65e0a62d0a349c

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012-2013 MundiPagg Soluções em Pagamentos
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,59 @@
+MundiPagg Ruby Client Library
+====================
+
+[![Build Status](https://travis-ci.org/mundipagg/ruby-integration-api.png?branch=master)](https://travis-ci.org/mundipagg/ruby-integration-api)
+
+
+Ruby API for integration with MundiPagg payment web services.
+
+## Dependencies 
+* [Savon 2.3.0](http://savonrb.com/version2/)
+	* [Nori 2.3.0](https://github.com/savonrb/nori)
+
+Unit tests made with [Cucumber](https://github.com/cucumber/cucumber) and [RSpec](https://github.com/rspec/rspec)
+
+## Usage
+Below a simple exemple of an order with one credit card transaction.
+
+
+````Ruby
+require 'mundipagg'
+
+#Create the client instance
+client = MundiPaggClient.new :test #API test environment
+
+#Create the order
+order = CreateOrderRequest.new
+
+#Fill order information
+order.amountInCents = 1000 # R$ 10,00
+order.amountInCentsToConsiderPaid = 1000
+order.merchantKey = '00000000-0000-0000-0000-000000000000'
+order.orderReference = 'Custom Order 42'
+credit = CreditCardTransaction.new
+
+#Credit card transaction information
+credit.amountInCents = 1000; # R$ 10,00
+credit.creditCardBrandEnum = CreditCardTransaction.BrandEnum[:Visa]
+credit.creditCardOperationEnum = CreditCardTransaction.OperationEnum[:AuthAndCapture]
+credit.creditCardNumber = '4111111111111111'
+credit.holderName = 'Anthony Edward Stark'
+credit.installmentCount = 1
+credit.paymentMethodCode = 1 #Simulator
+credit.securityCode = 123
+credit.transactionReference = 'Custom Transaction Identifier'
+credit.expirationMonth = 5
+credit.expirationYear = 2020
+
+#Add transaction to order
+order.creditCardTransactionCollection << credit
+
+response = client.CreateOrder(order)
+````
+
+## More information
+
+[RubyDoc](http://rubydoc.info/github/mundipagg/mundipagg-ruby-api/)
+
+## LICENSE
+See the LICENSE file.

data/lib/mundipagg.rb

@@ -0,0 +1,8 @@
+require 'savon'
+require 'mundipagg/gateway'
+require 'mundipagg/CreateOrderRequest'
+require 'mundipagg/BoletoTransaction'
+require 'mundipagg/CreditCardTransaction'
+require 'mundipagg/Buyer'
+require 'mundipagg/QueryOrderRequest'
+require 'mundipagg/ManageOrderRequest'

data/lib/mundipagg/BoletoTransaction.rb

@@ -0,0 +1,31 @@
+module Mundipagg
+	class BoletoTransaction
+
+		# @return [Long] Transaction amount in cents
+		attr_accessor :amountInCents 
+		
+		# @return [Integer] Bank code
+		attr_accessor :bankNumber
+		
+		# @return [Integer] How many days after the creation the boleto will be valid.
+		# @param Default: 7 
+		attr_accessor :daysToAddInBoletoExpirationDate 
+		
+		# @return [Integer] Number used to identify the boleto	
+		attr_accessor :nossoNumero 
+		
+		# @return [Long] Text with payment instructions. Limit: 120 characters.
+		attr_accessor :instructions
+		
+		# @return [Long] Custom transaction identifier.
+		attr_accessor :transactionReference
+
+		# Initialize class with default values
+		def initialize
+			@amountInCents = 0
+			@daysToAddInBoletoExpirationDate = 7
+		end
+		
+		
+	end
+end

data/lib/mundipagg/Buyer.rb

@@ -0,0 +1,82 @@
+module Mundipagg
+	class Buyer
+
+		# @return [Guid] Buyer unique idenfitication. Generated by MundiPagg.
+		# param Default: 00000000-0000-0000-0000-000000000000 (Guid empty) 
+		attr_accessor :buyerKey
+		# @return [String] Buyer custom idenfitication. 
+		attr_accessor :buyerReference
+		# @return [String] Email address. 
+		attr_accessor :email
+		# @return [String] Facebook ID. 
+		attr_accessor :facebookId
+		# @return [String] Gender. 
+		attr_accessor :genderEnum 
+		# @return [String] Home phone.
+		attr_accessor :homePhone
+		# @return [String] IP Address.
+		attr_accessor :ipAddress 
+		# @return [String] Mobile phone.
+		attr_accessor :mobilePhone
+		# @return [String] Work phone. 
+		attr_accessor :workPhone
+		# @return [String] Buyer full name. 
+		attr_accessor :name
+		# <i>Person</i> for individual people information and <i>Company</i> for enterprise information
+		# @return [String] Type.
+		# @param Default: Person
+		attr_accessor :personTypeEnum 
+		# @return [String] Document number.
+		attr_accessor :taxDocumentNumber
+		#<i>CPF<i> for person document number or <i>CNPJ</i> for company document number.
+		# @return [String] Document type.
+		# @param Default: CPF
+		attr_accessor :taxDocumentTypeEnum 
+		# @return [String] Twitter ID.
+		attr_accessor :twitterId
+		# @return [Array] Array of addresses.
+		# @see BuyerAddress
+		attr_accessor :addressCollection
+
+		# Gender
+		@@Gender = {
+			:Male => 'M',
+			:Female => 'F'
+		}
+
+		# Person Type
+		@@PersonType = {
+			:Person => 'Person',
+			:Company => 'Company'
+		}
+
+		# Document Type
+		@@DocumentType = {
+			:CPF => 'CPF',
+			:CNPJ => 'CNPJ'
+		}
+
+		# Initialize class with properties
+		def initialize
+			@addressCollection = Array.new
+			@buyerKey = '00000000-0000-0000-0000-000000000000'
+			@personTypeEnum = Buyer.PersonTypeEnum[:Person]
+			@taxDocumentTypeEnum = Buyer.DocumentTypeEnum[:CPF]
+		end
+
+		# Gender enum
+		def self.GenderEnum
+			@@Gender
+		end
+
+		# Person type enum
+		def self.PersonTypeEnum
+			@@PersonType
+		end
+
+		# Document type enum
+		def self.DocumentTypeEnum
+			@@DocumentType
+		end
+	end
+end

data/lib/mundipagg/BuyerAddress.rb

@@ -0,0 +1,69 @@
+module Mundipagg
+	class BuyerAddress
+
+		# @return [String] Address Type.
+		# @see AddressTypeEnum
+		# @param Default: Residential
+		attr_accessor :addressTypeEnum 
+		# @return [String] City.
+		attr_accessor :city
+		# @return [String] Address complement.
+		attr_accessor :complement 
+		# @return [String] Address country.
+		# @param Default: Brazil
+		# @see CountryEnum
+		attr_accessor :countryEnum
+		# @return [String] District.
+		attr_accessor :district 
+		# @return [String] Address number.
+		attr_accessor :number 
+		# @return [String] Address state.
+		attr_accessor :state 
+		# @return [String] Street.
+		attr_accessor :street
+		# @return [String] Zip Code.
+		attr_accessor :zipCode
+
+
+		#Address Type Enum
+		@@ADDRESS_TYPE={
+			:Billing => 'Billing',
+			:Shipping => 'Shipping',
+			:Work => 'Comercial',
+			:Home => 'Residential'
+		}
+
+
+		# Country Enum
+		@@COUNTRY = {
+			:Brazil => 'Brazil',
+			:UnitedStates => 'USA',
+			:Argentina => 'Argentina',
+			:Bolivia => 'Bolivia',
+			:Chile => 'Chile',
+			:Colombia => 'Colombia',
+			:Uruguay => 'Uruguay',
+			:Mexico => 'Mexico',
+			:Paraguay => 'Paraguay'
+		}
+
+		#Initialize class with properties
+		def initialize
+			@addressTypeEnum = BuyerAddress.AddressTypeEnum[:Home]
+			@countryEnum = BuyerAddress.CountryEnum[:Brazil]
+		end
+
+		#Address Type Enum
+		# @see @@ADDRESS_TYPE
+		def self.AddressTypeEnum
+			@@ADDRESS_TYPE
+		end
+
+		# Country Enum
+		# @see @@COUNTRY
+		def self.CountryEnum
+			@@COUNTRY
+		end
+
+	end
+end

data/lib/mundipagg/CreateOrderRequest.rb

@@ -0,0 +1,62 @@
+module Mundipagg
+	class CreateOrderRequest
+		# @return [Long] Order amount in cents
+		attr_accessor :amountInCents
+
+		# @return [Long] Amount (in cents) to consider the order is paid
+		attr_accessor :amountInCentsToConsiderPaid
+		
+		# @return [String] Order amount currency.
+		# @param Default: BRL
+		# @see CurrencyIsoEnum
+		attr_accessor :currencyIsoEnum 
+		
+		# @return [Buyer] Buyer instance
+		# @see Buyer
+		attr_accessor :buyer 
+		
+		# @return [Guid] MundiPagg merchant identification 
+		attr_accessor :merchantKey 
+		
+		# If merchant not send OrderReference, Mundipagg will generate and return in the response.
+		# @return [String] Custom order identification.
+		attr_accessor :orderReference
+		
+		# @return [Array] Array with all credit card transactions 
+		attr_accessor :creditCardTransactionCollection 
+		
+		# @return [Array] Array with all boleto transactions
+		attr_accessor :boletoTransactionCollection
+		
+		# If not send, it will be generate automatically in the webservice and returned in response.
+		# Web service request identification, it is used for investigate problems with webservice requests.
+		# @return [Guid] Globally Unique Identifier. 
+		# @param Optional
+		# @param Default: 00000000-0000-0000-0000-000000000000
+		attr_accessor :requestKey
+
+		# Currency Enum
+		# @returns [Hash<Symbol, String>]
+		@@CURRENCY_ISO ={
+			:BrazillianReal => 'BRL',
+			:AmericanDollar => 'USD'
+		}
+
+		# Initialize class and properties
+	    def initialize
+			@creditCardTransactionCollection = Array.new;
+			@boletoTransactionCollection = Array.new;
+			@currencyIsoEnum = CreateOrderRequest.CurrencyIsoEnum[:BrazillianReal]
+			@requestKey = '00000000-0000-0000-0000-000000000000'
+
+		end
+
+		# Currency Enum
+		# @returns [Hash<Symbol, String>]
+		# @see @@CURRENCY_ISO
+		def self.CurrencyIsoEnum
+			@@CURRENCY_ISO
+		end
+
+	end
+end

data/lib/mundipagg/CreditCardTransaction.rb

@@ -0,0 +1,78 @@
+module Mundipagg
+	class CreditCardTransaction
+		
+		# @return [Long] Transaction amount in cents
+		attr_accessor :amountInCents
+		
+		# @return [String] Card brand. Use the static property <i>BrandEnum</i>.
+		# @see BrandEnum
+		attr_accessor :creditCardBrandEnum 
+		
+		# @return [String] Credit Card Number.
+		attr_accessor :creditCardNumber
+		
+		# @return [String] Type of operation. Use the static property <i>OperationEnum</i>.
+		# @see OperationEnum
+		attr_accessor :creditCardOperationEnum
+		
+		# @return [Integer] Credit card expiration month
+		attr_accessor :expirationMonth 
+		
+		# @return [Integer] Credit card expiration year
+		attr_accessor :expirationYear 
+		
+		# @return [Integer] Name in the credit card
+		attr_accessor :holderName
+		
+		# @return [Integer] Transaction installments count. 
+		attr_accessor :installmentCount 
+		
+		# @return [Integer] Card security code.
+		attr_accessor :securityCode
+		
+		# @return [Integer] Code to select the payment method. Can be <i>Cielo<i>, <i>Redecard<i> and others. 
+		attr_accessor :paymentMethodCode 
+		
+		# @return [String] Custom transaction identifier.
+		attr_accessor :transactionReference
+
+		# Fill this property when creating a recurrency transaction. 
+		# @return [Recurrency] Transaction recurrency information.
+		attr_accessor :recurrency
+
+		# Allowed card brands 
+		# @returns [Hash<Symbol, String>] 
+		@@CARD_BRAND = {
+			:Visa => 'Visa',
+			:Mastercard => 'Mastercard',
+			:AmericanExpress => 'Amex',
+			:Hipercard => 'Hipercard',
+			:Diners => 'Diners',
+			:Elo => 'Elo',
+			:Aura => 'Aura',
+			:Discover => 'Discover'
+		}
+
+		# Types of operation.
+		# @returns [Hash<Symbol, String>] 
+		@@OPERATION = {
+			:AuthOnly => 'AuthOnly',
+			:AuthAndCapture => 'AuthAndCapture',
+			:AuthAndCaptureWithDelay => 'AuthAndCaptureWithDelay'
+		}
+
+		# Allowed card brands 
+		# @returns [Hash<Symbol, String>] 
+		# @see @@CARD_BRAND
+		def self.BrandEnum
+			@@CARD_BRAND
+		end
+
+		# Allowed operations.
+		# @returns [Hash<Symbol, String>] 
+		# @see @@OPERATION
+		def self.OperationEnum
+			@@OPERATION
+		end
+	end
+end

data/lib/mundipagg/ManageOrderRequest.rb

@@ -0,0 +1,52 @@
+module Mundipagg
+	class ManageOrderRequest
+		
+		# @return [Array] Credit card transaction collection
+		attr_accessor :transactionCollection
+		
+		# @return [String] Operation enum
+		attr_accessor :manageOrderOperationEnum
+		
+		# @return [Guid] MundiPagg merchant identification 
+		attr_accessor :merchantKey
+		
+		# @return [Guid] Unique order identification. Generated by MundiPagg. 
+		attr_accessor :orderKey
+		
+		# @return [String] Order identification.
+		attr_accessor :orderReference
+
+		# If not send, it will be generate automatically in the webservice and returned in response.
+		# Web service request identification, it is used for investigate problems with webservice requests.
+		# @return [Guid] Globally Unique Identifier. 
+		# @param Optional
+		# @param Default: 00000000-0000-0000-0000-000000000000
+		attr_accessor :requestKey
+
+		# Initialize class and properties
+		def initialize
+			@transactionCollection = Array.new
+			@requestKey = '00000000-0000-0000-0000-000000000000'
+		end
+
+		# Operations allowed 
+		@@Operation = {
+			:Capture => 'Capture',
+			:Void => 'Void'
+		}
+
+		# Hash collection with operations allowed 
+		def self.OperationEnum
+			@@Operation
+		end
+	end
+
+	class ManageTransactionRequest
+		# @return [Long] Order amount in cents.
+		attr_accessor :amountInCents 
+		# @return [Guid] Unique transacion identifier generated by MundiPagg.
+		attr_accessor :transactionKey 
+		# @return [String] Custom transaction identifier.
+		attr_accessor :transactionReference
+	end
+end

data/lib/mundipagg/QueryOrderRequest.rb

@@ -0,0 +1,27 @@
+module Mundipagg
+	class QueryOrderRequest
+
+		# @return [Guid] MundiPagg merchant identification 
+		attr_accessor :merchantKey 
+		
+		# @return [Guid] Unique order identification. Generated by MundiPagg.
+		attr_accessor :orderKey
+
+		# @return [Guid] Custom order identification.
+		attr_accessor :orderReference 
+		
+		# If not send, it will be generate automatically in the webservice and returned in response.
+		# Web service request identification, it is used for investigate problems with webservice requests.
+		# @return [Guid] Globally Unique Identifier. 
+		# @param Optional
+		# @param Default: 00000000-0000-0000-0000-000000000000
+		attr_accessor :requestKey
+
+		# Initialize class and properties
+		def initialize()
+			@requestKey = '00000000-0000-0000-0000-000000000000'
+		end
+		
+		
+	end
+end

data/lib/mundipagg/Recurrency.rb

@@ -0,0 +1,37 @@
+module Mundipagg	
+	# Class that hold recurrency transaction information
+	class Recurrency
+
+		# @return [Date] Date the first recurrency will be charged.
+		attr_accessor :dateToStartBilling
+		
+		# @return [String] Indicating the recurrency frequency.
+		# @see FrequencyEnum
+		attr_accessor :frequencyEnum
+
+		# @return [Integer] Recurrency interval.
+		attr_accessor :interval
+		
+		# @return [Boolean] Indicates whether the One webservice will run an OneDollarAuth 
+		# to validate the credit card.
+		attr_accessor :oneDollarAuth
+		
+		# @return [Integer] Number of recurrencies.
+		attr_accessor :recurrences
+
+		# Allowed recurrency frequency
+		@@FREQUENCY = {
+			:Monthly => 'Monthly',
+			:Yearly => 'Yearly',
+			:Daily => 'Daily'
+		}
+
+		# Initialize class and properties
+		def initialize	
+		end
+
+		# Allowed recurrency frequency
+		def self.FrequencyEnum
+		end
+	end
+end

data/lib/mundipagg/gateway.rb

@@ -0,0 +1,309 @@
+module Mundipagg
+  # Class that handles all webservice calls
+  class Gateway
+
+    # @return [Nori] Nori class who handle the conversion of base XML to a hash collection 
+    # @see https://github.com/savonrb/nori
+  	attr_reader :parser
+
+    # <i>:test</i> = Simulator enviroment, fake transaction approval;
+    # <i>:production</i> = Real transaction, needs real credit card.  
+    # @return [Symbol] Webservice environment. 
+    attr_accessor :environment 
+
+    # @return [String] URL that points to the simulator WSDL 
+    @@WEBSERVICE_TEST_URL = 'http://simulator.mundipaggone.com/One/MundiPaggService.svc?wsdl'
+
+    # @return [String] URL that points to the production WSDL 
+    @@WEBSERVICE_PRODUCTION_URL = ''
+
+    # Initialize a class with an environment
+    #
+    # @param environment [Symbol] Sets the MundiPagg environment will be used by the client.
+    def initialize(environment=:test)
+    	@parser = Nori.new(:convert_tags_to => lambda { |tag| tag })
+      @environment = environment
+    end
+
+    # This method makes requests to the webservice method ManageOrder.
+    # 
+    # @param request [CreateOrderRequest] A ManagerOrderRequest instance containing information to capture or void a transaction or order.
+    # @return [Hash<Symbol, Object>] A hash collection containing the response data
+    def ManageOrder(request)
+
+  	hash = @parser.parse('<tns:manageOrderRequest>
+  							<mun:ManageCreditCardTransactionCollection>
+  							</mun:ManageCreditCardTransactionCollection>
+  							<mun:ManageOrderOperationEnum>?</mun:ManageOrderOperationEnum>
+  							<mun:MerchantKey>?</mun:MerchantKey>
+  							<mun:OrderKey>?</mun:OrderKey>
+  							<mun:OrderReference>?</mun:OrderReference>
+  							<mun:RequestKey>?</mun:RequestKey>
+  						</tns:manageOrderRequest>')
+
+  	xml_hash = hash['tns:manageOrderRequest'];
+
+  	xml_hash['mun:ManageCreditCardTransactionCollection'] = {'mun:ManageCreditCardTransactionRequest'=>Array.new}
+
+  	if request.transactionCollection.nil? == false and request.transactionCollection.count > 0
+  		
+  		request.transactionCollection.each do |transaction|
+  			
+  			xml_hash['mun:ManageCreditCardTransactionCollection']['mun:ManageCreditCardTransactionRequest'] << {
+  				'mun:AmountInCents' => transaction.amountInCents, 
+  				'mun:TransactionKey' => transaction.transactionKey, 
+  				'mun:TransactionReference' => transaction.transactionReference 
+  			}
+  		end 
+  	end
+
+  	xml_hash['mun:ManageOrderOperationEnum'] = request.manageOrderOperationEnum
+  	xml_hash['mun:MerchantKey'] = request.merchantKey
+  	xml_hash['mun:OrderKey'] = request.orderKey
+  	xml_hash['mun:OrderReference'] = request.orderReference
+  	xml_hash['mun:RequestKey'] = request.requestKey
+
+  	response = SendToService(hash, :manage_order)
+
+  	return response
+
+  	end
+
+    # This method makes requests to the webservice method QueryOrder.
+    #
+    # @param request [QueryOrderRequest] A QueryOrderRequest instance containing information to request more information about an order or transaction.
+    # @return [Hash<Symbol, Object>]
+    def QueryOrder(request)
+
+      hash = @parser.parse('<tns:queryOrderRequest>
+  				<mun:MerchantKey>?</mun:MerchantKey>
+  				<mun:OrderKey>?</mun:OrderKey>
+  				<mun:OrderReference>?</mun:OrderReference>
+  				<mun:RequestKey>?</mun:RequestKey>
+  			</tns:queryOrderRequest>')
+
+      xml_hash = hash['tns:queryOrderRequest'];
+
+      xml_hash['mun:MerchantKey'] = request.merchantKey
+      xml_hash['mun:OrderKey'] = request.orderKey
+      xml_hash['mun:OrderReference'] = request.orderReference
+      xml_hash['mun:RequestKey'] = request.requestKey
+
+      response = SendToService(hash, :query_order)
+
+      return response
+    end
+
+    # This method makes requests to the webservice method CreateOrder.
+    #
+    # @param request [CreateOrderRequest] A CreateOrderRequest instance containing information to create a order.
+    # @return [Hash<Symbol, Object>] A hash collection containing the response data
+    def CreateOrder(request)
+
+      hash = @parser.parse('
+  		         <tns:createOrderRequest>
+  		            <mun:AmountInCents>?</mun:AmountInCents>
+  		            <mun:AmountInCentsToConsiderPaid>?</mun:AmountInCentsToConsiderPaid>		            
+  		            <mun:CurrencyIsoEnum>?</mun:CurrencyIsoEnum>		            
+  		            <mun:MerchantKey>?</mun:MerchantKey>		            
+  		            <mun:OrderReference>?</mun:OrderReference>
+  		            <mun:RequestKey>?</mun:RequestKey>
+        					<mun:Buyer>
+        				  </mun:Buyer>
+  		            <mun:CreditCardTransactionCollection>
+  		            </mun:CreditCardTransactionCollection>		            
+  		            <mun:BoletoTransactionCollection>
+  		            </mun:BoletoTransactionCollection>
+  		         </tns:createOrderRequest>')
+
+      xml_hash = hash['tns:createOrderRequest'];
+
+      xml_hash['mun:AmountInCents'] = request.amountInCents
+      xml_hash['mun:AmountInCentsToConsiderPaid'] = request.amountInCentsToConsiderPaid
+      xml_hash['mun:CurrencyIsoEnum'] = request.currencyIsoEnum
+      xml_hash['mun:MerchantKey'] = request.merchantKey
+      xml_hash['mun:OrderReference'] = request.orderReference
+      xml_hash['mun:RequestKey'] = request.requestKey
+
+      if request.buyer.nil? == false
+        xml_hash['mun:Buyer'] = CreateBuyer(request)
+      end
+
+      if not request.creditCardTransactionCollection.nil? and request.creditCardTransactionCollection.count > 0
+        #Create credit card transaction array and assing to the contract hash
+        creditCardTransactionCollection = CreateCreditCardTransaction(request)
+        xml_hash['mun:CreditCardTransactionCollection'] = creditCardTransactionCollection
+      else
+        xml_hash['mun:CreditCardTransactionCollection'] = nil
+      end
+
+      if request.boletoTransactionCollection.nil? == false and request.boletoTransactionCollection.count > 0
+        #Create boleto transaction array and assing to the contract hash
+        boletoTransactionCollection = CreateBoletoTransactionRequest(request);
+        xml_hash['mun:BoletoTransactionCollection'] = boletoTransactionCollection
+      end
+
+      response = SendToService(hash, :create_order)
+
+
+      return response
+
+    end
+
+
+    # This method create a hash collection with all buyer information. 
+    # The hash collection is a part of the data send to the webservice.
+    # 
+    # @param request [CreateOrderRequest]
+    # @return [Hash<Symbol, Object>] Hash collection with buyer information.
+    # @!visibility private
+    def CreateBuyer(request)
+
+      buyer = {
+        'mun:BuyerKey' => request.buyer.buyerKey,
+        'mun:BuyerReference' => request.buyer.buyerReference,
+        'mun:Email' => request.buyer.email,
+        'mun:GenderEnum' => request.buyer.genderEnum,
+        'mun:FacebookId' => request.buyer.facebookId,
+        'mun:GenderEnum' => request.buyer.genderEnum,
+        'mun:HomePhone' => request.buyer.homePhone,
+        'mun:IpAddress' => request.buyer.ipAddress,
+        'mun:MobilePhone' => request.buyer.mobilePhone,
+        'mun:Name' => request.buyer.name,
+        'mun:PersonTypeEnum' => request.buyer.personTypeEnum,
+        'mun:TaxDocumentNumber' => request.buyer.taxDocumentNumber,
+        'mun:TaxDocumentNumberTypeEnum' => request.buyer.taxDocumentTypeEnum,
+        'mun:TwitterId' => request.buyer.twitterId,
+        'mun:WorkPhone' => request.buyer.workPhone,
+        'mun:BuyerAddressCollection' => nil
+
+      }
+
+      if request.buyer.addressCollection.count > 0
+
+      	buyer['mun:BuyerAddressCollection'] = {'mun:BuyerAddress'=>Array.new}
+
+     	    request.buyer.addressCollection.each do |address|
+
+     	    	buyer['mun:BuyerAddressCollection']['mun:BuyerAddress'] << {
+     	    		'mun:AddressTypeEnum' => address.addressTypeEnum,
+     	    		'mun:City' => address.city,
+     	    		'mun:Complement' => address.complement,
+     	    		'mun:CountryEnum' => address.countryEnum,
+     	    		'mun:District' => address.district,
+     	    		'mun:Number' => address.number,
+     	    		'mun:State' => address.state,
+     	    		'mun:Street' => address.street,
+     	    		'mun:ZipCode' => address.zipCode
+     	    	}
+
+     	    end
+      end
+
+      return buyer
+    end
+
+    # This method create a hash collection with all boleto transactions information. 
+    # The hash collection is a part of the data send to the webservice.
+    # 
+    # @param boletoRequest [Array<BoletoTransaction>] CreateOrderRequest instance
+    # @return [Hash<Symbol, Object>] Hash collection with one or more boleto transactions.
+    # @!visibility private
+    def CreateBoletoTransactionRequest(boletoRequest)
+
+      transactionCollection = {'mun:BoletoTransaction' => Array.new}
+
+      boletoRequest.boletoTransactionCollection.each do |boleto|
+
+        transactionCollection['mun:BoletoTransaction'] << {
+          'mun:AmountInCents' => boleto.amountInCents,
+          'mun:BankNumber' => boleto.bankNumber,
+          'mun:DaysToAddInBoletoExpirationDate' => boleto.daysToAddInBoletoExpirationDate,
+          'mun:Instructions' => boleto.instructions,
+          'mun:NossoNumero' => boleto.nossoNumero,
+          'mun:TransactionReference' => boleto.transactionReference,
+
+        }
+
+      end
+
+      return transactionCollection
+    end
+
+    # This method create a hash collection with all credit card transactions information. 
+    # The hash collection is a part of the data send to the webservice.
+    # 
+    # @param creditCardRequest [Array<CreditCardTransaction>] CreateOrderRequest instance
+    # @return [Hash<Symbol, Object>] Hash collection with one or more credit card transactions.
+    # @!visibility private
+    def CreateCreditCardTransaction(creditCardRequest)
+
+      transactionCollection = {'mun:CreditCardTransaction' => Array.new}
+
+      creditCardRequest.creditCardTransactionCollection.each do |transaction|
+
+        transaction_hash = {
+          'mun:AmountInCents' => transaction.amountInCents,
+          'mun:CreditCardBrandEnum' => transaction.creditCardBrandEnum.to_s,
+          'mun:CreditCardNumber' => transaction.creditCardNumber,
+          'mun:CreditCardOperationEnum' => transaction.creditCardOperationEnum.to_s,
+          'mun:ExpMonth' => transaction.expirationMonth,
+          'mun:ExpYear' => transaction.expirationYear,
+          'mun:HolderName' => transaction.holderName,
+          'mun:InstallmentCount' => transaction.installmentCount,
+          'mun:PaymentMethodCode' => transaction.paymentMethodCode,
+          'mun:SecurityCode' => transaction.securityCode,
+          'mun:TransactionReference' => transaction.transactionReference
+        }
+
+        if transaction.recurrency.nil? == false
+          
+          transaction_hash['mun:Recurrency'] = {
+            'mun:DateToStartBilling' => transaction.recurrency.dateToStartBilling,
+            'mun:FrequencyEnum' => transaction.recurrency.frequencyEnum,
+            'mun:Interval' => transaction.recurrency.interval,
+            'mun:OneDollarAuth' => transaction.recurrency.oneDollarAuth,
+            'mun:Recurrences' => transaction.recurrency.recurrences
+          }
+        end
+
+        transactionCollection['mun:CreditCardTransaction'] << transaction_hash
+      end
+
+      return transactionCollection
+    end
+
+
+    # This method send the hash collectin created in this client and send it to the webservice.
+    # 
+    # == Parameters:
+    # @param hash [Hash<Symbol, Object] Hash collection generated by Nori using the base SOAP XML.
+    # @param service_method [Symbol] A Symbol declaring the method that will be called. Can be <i>:create_order</i>, <i>:manage_order<i/> or <i>:query_order</i>.
+    # @return [Hash<Symbol, Object>] A hash collection with the service method response.
+    # @!visibility private
+    def SendToService(hash, service_method)
+
+      url = nil
+
+      if @environment == :production
+        url = @@WEBSERVICE_PRODUCTION_URL
+      else
+        url = @@WEBSERVICE_TEST_URL
+      end
+
+      client = Savon.client do
+        wsdl url
+        log_level :error
+        namespaces 'xmlns:mun' => 'http://schemas.datacontract.org/2004/07/MundiPagg.One.Service.DataContracts'
+      end
+
+      response = client.call(service_method) do
+        message hash
+      end
+
+      return response.to_hash
+    end
+
+    private :CreateBoletoTransactionRequest, :CreateCreditCardTransaction, :CreateBuyer, :SendToService
+  end
+end

data/lib/mundipagg/version.rb

@@ -0,0 +1,9 @@
+module Mundipagg
+  module Version
+    Major = 1
+    Minor = 1
+    Revision = 0
+
+    String = "#{Major}.#{Minor}.#{Revision}"
+  end
+end

data/mundipagg.gemspec

@@ -0,0 +1,16 @@
+$:.push File.expand_path("../lib", __FILE__)
+require "mundipagg/version"
+
+Gem::Specification.new do |s|
+  s.name = "mundipagg"
+  s.summary = "MundiPagg Ruby Client Library"
+  s.description = "Ruby library for integrating with the MundiPagg payment web services"
+  s.version = Mundipagg::Version::String
+  s.author = "MundiPagg"
+  s.email = "github@mundipagg.com"
+  s.homepage = "http://www.mundipagg.com/"
+  s.files = Dir.glob ["README.md", "LICENSE", "lib/**/*.{rb}", "tests/**/*", "*.gemspec"]
+  s.add_dependency "savon", "2.3.0"
+  s.required_ruby_version = '>= 1.9.2'
+
+end

data/tests/features/boleto.feature

@@ -0,0 +1,9 @@
+Feature: Boleto transaction
+	I want to create a order with one boleto transaction.
+
+	Scenario: Send a Boleto Transaction to One
+		Given I have purchase two products with a total cost of BRL 50.00
+		And I will pay using Boleto with 15 days to expire
+		And I will send to Mundipagg 
+		Then The order amount in cents should be 5000 
+		And The boleto status should be Generated

data/tests/features/credit_card.feature

@@ -0,0 +1,16 @@
+Feature: Credit Card Transaction
+	I want to create a order with one credit card transaction.
+
+	Scenario: Pay a order using credit card and installment 
+		Given I have purchase three products with a total cost of BRL 250
+		And I will pay using a Visa credit card in 3 installments
+		And I will send to Mundipagg 
+		Then the order amount in cents should be 25000 
+		And the transaction status should be Captured
+
+	Scenario: Pay a order using credit card without installment
+		Given I have purchase three products with a total cost of BRL 100,29
+		And I will pay using a Visa credit card without installment
+		And I will send to Mundipagg 
+		Then the order amount in cents should be 10029
+		And the transaction status should be Captured

data/tests/features/step_definitions/boleto_steps.rb

@@ -0,0 +1,54 @@
+# encoding: UTF-8
+begin require 'rspec/expectations'; rescue LoadError; require 'spec/expectations'; end
+$:.unshift(File.dirname(__FILE__) + '/../../../lib') 
+require 'bigdecimal'
+require 'mundipagg'
+
+Before do 
+	@client = Mundipagg::Gateway.new :test
+	@order = Mundipagg::CreateOrderRequest.new
+	@boleto = Mundipagg::BoletoTransaction.new
+	@response = Hash.new
+	@order.merchantKey = '73611285-C8F7-45A4-8F50-579182627242'
+end
+
+
+Given(/^I have purchase two products with a total cost of (\w+) (\d+)\.(\d+)$/) do |currency,amount,cents|
+	amount = amount+'.'+cents
+	amount = BigDecimal.new(amount.gsub(',', '.'))
+	@order.amountInCents = (amount * 100).to_i
+	@order.amountInCentsToConsiderPaid = (amount * 100).to_i
+	@order.currencyIsoEnum = 'BRL'
+end
+
+Given(/^I will pay using (\w+) with (\d+) days to expire$/) do |type,daysToExpire|
+  if type.downcase == 'boleto'
+  	
+  	@boleto.amountInCents = @order.amountInCents
+  	@boleto.bankNumber = 1
+  	@boleto.nossoNumero = 989790
+  	@boleto.transactionReference = rand(389546232)
+  	@boleto.daysToAddInBoletoExpirationDate = daysToExpire
+  	@boleto.instructions = 'Não receber após o vencimento'
+
+  	@order.boletoTransactionCollection << @boleto
+  	@order.creditCardTransactionCollection = nil
+
+  end
+end
+
+Given(/^I send to Mundipagg$/) do
+	@response = @client.CreateOrder(@order)
+end
+
+
+Then(/^The order amount in cents should be (\d+)$/) do |amountInCents|
+	transaction = @response[:create_order_response][:create_order_result][:boleto_transaction_result_collection][:boleto_transaction_result]
+	transaction[:amount_in_cents].to_s.should == amountInCents
+end
+
+Then(/^The boleto status should be (\w+)$/) do |status|
+	transaction = @response[:create_order_response][:create_order_result][:boleto_transaction_result_collection][:boleto_transaction_result]
+	transaction[:boleto_transaction_status_enum].to_s == status
+end
+

data/tests/features/step_definitions/credit_card_steps.rb

@@ -0,0 +1,76 @@
+begin require 'rspec/expectations'; rescue LoadError; require 'spec/expectations'; end
+$:.unshift(File.dirname(__FILE__) + '/../../../lib') 
+require 'bigdecimal'
+require 'mundipagg'
+
+#Scenario 1: 
+Before do 
+	@client = Mundipagg::Gateway.new :test
+	@order = Mundipagg::CreateOrderRequest.new
+	@order.merchantKey = '73611285-C8F7-45A4-8F50-579182627242'
+	@transaction = Mundipagg::CreditCardTransaction.new
+	@order.creditCardTransactionCollection << @transaction
+	@response = Hash.new
+end
+
+
+Given(/^I have purchase three products with a total cost of (\w+) (\d+)$/) do |currency,amount|
+	amount = BigDecimal.new(amount.gsub(',', '.'))
+	@order.amountInCents = (amount * 100).to_i
+	@order.amountInCentsToConsiderPaid = (amount * 100).to_i
+	@order.currencyIsoEnum = 'BRL'
+end
+
+Given(/^I will pay using a (\w+) credit card in (\d+) installments$/) do |brand,installments|
+	@transaction.creditCardBrandEnum = brand
+	@transaction.installmentCount = installments
+	@transaction.paymentMethodCode = 1
+	@transaction.amountInCents = @order.amountInCents
+	@transaction.holderName = 'Ruby Unit Test'
+	@transaction.creditCardNumber = '41111111111111111'
+	@transaction.securityCode = '123'
+	@transaction.expirationMonth = 5
+	@transaction.expirationYear = 2018
+	@transaction.creditCardOperationEnum = Mundipagg::CreditCardTransaction.OperationEnum[:AuthAndCapture]
+end
+
+Given(/^I will send to Mundipagg$/) do
+	@response = @client.CreateOrder(@order)
+end
+
+Then(/^the order amount in cents should be (\d+)$/) do |amountInCents|
+	transaction = @response[:create_order_response][:create_order_result][:credit_card_transaction_result_collection][:credit_card_transaction_result]
+	transaction[:amount_in_cents].to_s.should == amountInCents
+end
+
+Then(/^the transaction status should be (\w+)$/) do |status| 
+	transaction = @response[:create_order_response][:create_order_result][:credit_card_transaction_result_collection][:credit_card_transaction_result]
+	transaction[:credit_card_transaction_status_enum].to_s.downcase.should == status.downcase
+end
+
+
+#Scenario 2:
+
+Given(/^I have purchase three products with a total cost of (\w+) (\d+),(\d+)$/) do |currency, amount, cents|
+	amount = amount+'.'+cents
+	amount = BigDecimal.new(amount.gsub(',', '.'))
+	@order.amountInCents = (amount * 100).to_i
+	@order.amountInCentsToConsiderPaid = (amount * 100).to_i
+	@order.currencyIsoEnum = currency
+
+end
+
+Given(/^I will pay using a (\w+) credit card without installment$/) do |brand|
+	@transaction.creditCardBrandEnum = brand
+	@transaction.installmentCount = 1
+	@transaction.paymentMethodCode = 1
+	@transaction.amountInCents = @order.amountInCents
+	@transaction.holderName = 'Ruby Unit Test'
+	@transaction.creditCardNumber = '41111111111111111'
+	@transaction.securityCode = '123'
+	@transaction.expirationMonth = 5
+	@transaction.expirationYear = 2018
+	@transaction.creditCardOperationEnum = Mundipagg::CreditCardTransaction.OperationEnum[:AuthAndCapture]
+
+end
+

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: mundipagg
+version: !ruby/object:Gem::Version
+  version: 1.1.0
+platform: ruby
+authors:
+- MundiPagg
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: savon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+description: Ruby library for integrating with the MundiPagg payment web services
+email: github@mundipagg.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- LICENSE
+- lib/mundipagg/BoletoTransaction.rb
+- lib/mundipagg/Buyer.rb
+- lib/mundipagg/BuyerAddress.rb
+- lib/mundipagg/CreateOrderRequest.rb
+- lib/mundipagg/CreditCardTransaction.rb
+- lib/mundipagg/gateway.rb
+- lib/mundipagg/ManageOrderRequest.rb
+- lib/mundipagg/QueryOrderRequest.rb
+- lib/mundipagg/Recurrency.rb
+- lib/mundipagg/version.rb
+- lib/mundipagg.rb
+- tests/features/boleto.feature
+- tests/features/credit_card.feature
+- tests/features/step_definitions/boleto_steps.rb
+- tests/features/step_definitions/credit_card_steps.rb
+- tests/features/support/env.rb
+- mundipagg.gemspec
+homepage: http://www.mundipagg.com/
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.6
+signing_key: 
+specification_version: 4
+summary: MundiPagg Ruby Client Library
+test_files: []
+has_rdoc: