dinero_mail 0.0.1

data/.gitignore

@@ -0,0 +1,24 @@
+*.gem
+*.rbc
+.bundle
+.config
+
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+
+# YARD artifacts
+_yardoc
+doc/
+

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in dinero_mail.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Abraham Kuri
+
+MIT License
+
+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,117 @@
+# DineroMail Gem
+
+Dinero Mail is a client which communicates with the provider API, and
+interact with it.
+
+It was developed for usage in Ruby on Rails web applications, but it
+also works as a standalone library
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'dinero_mail'
+
+Living on the edge
+  
+    gem 'dinero_mail', git: 'git@github.com:IcaliaLabs/dinero_mail.git'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install dinero_mail
+
+## Configuration
+
+If you are on development you are ready to go!
+Yeeiii
+
+For those who are on production:
+
+    DineroMail.configure do |config|
+      config.environment = :production
+      config.username = '<username>'
+      config.password = '<password>'
+    end
+
+## Creating a client
+
+    DM_CLIENT = DineroMail::Client.new
+
+## Methods
+
+	 DM_CLIENT.get_balance unique_message_id: '1', merchant_transaction_id: '1'
+   
+	 DM_CLIENT.get_operations unique_message_id: '1', merchant_transaction_id: '1', operation_id: '1', 
+	 start_date: '2012-10-6', end_date: '2012-10-10'
+   
+	 DM_CLIENT.send_money currency: 'MXN', amount: '100.00', to_email: 'example@example.com', pay_off: 'Producto', 
+	 subject: 'Pago de servicio', message: 'Hola mundo', merchant_transaction_id: '1', unique_message_id: '1'
+	 
+	 DM_CLIENT.do_payment_with_reference merchant_transaction_id: '1', unique_message_id: '1', subject: 'hola', message: 'mensaje', 		
+	 					provider: 'oxxo', items: [{amount: '100.00', code: 'abc', currency: 'MXN', description: 'descricion', name: 'nombre', 
+	 					quantity: '1'}], buyer: {name: 'abraham', last_name: 'kuri', email: 'a@a.com'}
+	 
+	 DM_CLIENT.do_with_draw merchant_transaction_id: '1', method: 'POSTAL', currency: 'MXN', amount: '100.00', 
+	 					address_detail: {street: 'mordor', number: '666', floor: '1', appartment: '5', zip: '666', city: 'inferno', 
+	 					state: 'mordorTown'}, bank_account_detail: {bank:'Banco Santander', bank_number: '300', type: 'CC', 
+	 					name: 'Abraham', last_name: 'Kuri', document_type: 'RFC', document_number: '2019029', branch: '1'}, 
+	 					unique_message_id: '1'
+	 
+	 DM_CLIENT.do_payment_with_credit_card merchant_transaction_id: '1', items: [{amount: '100.00', code: 'abc', currency: 'MXN', 	
+	 					description: 'descricion', name: 'nombre', quantity: '1'}], buyer: {name: 'abraham', last_name: 'kuri', 
+	 					email: 'a@a.com'}, provider: 'MX_BANORTE_TD', credit_card: {installment: '2', credit_card_number: '123456', 
+	 					holder: 'adrian', expiration_date: '12/16', security_code: '1234', document_number: '1'}, unique_message_id: '1'
+	 
+	 DM_CLIENT.get_payment_ticket currency: "MXN", amount: "100.0", provider: "oxxo", 
+							merchant_transaction_id: "1", unique_message_id: "1"
+		
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## Changelog
+<ul>
+  <li>Current gem version 0.0.1</li>
+	<li>Full integration with Rails</li>
+	<li></li>
+</ul>
+
+
+## Contributors & Patches & Forks
+<ul>
+  <li>Abraham Kuri Vargas (@kurenn)</li>
+	<li>Adrián González Francke (@Adrian2112)</li>
+</ul>
+
+## Future
+<ul>
+	<li>Writing tests (not implemented yet)</li>
+  <li>Add support to communicate with the IPN</li>
+  <li>Add button helpers</li>
+</ul>
+
+
+## Credits
+Icalia Labs - weare@icalialabs.com
+
+[Follow us](http://twitter.com/icalialabs "Follow us")
+
+
+[Like us on Facebook](https://www.facebook.com/icalialab "Like us on Facebook")
+
+## License
+Copyright (c) 2011 Abraham Kuri Vargas
+
+This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/gpl.html.

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/dinero_mail.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/dinero_mail/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Abraham Kuri", "Adrian Gonzalez"]
+  gem.email         = ["weare@icalialabs.com"]
+  gem.description   = %q{Integrate Dinero Mail as PaymentOption to Rails}
+  gem.summary       = %q{Dinero Mail Rails Integration}
+  gem.homepage      = "https://github.com/kurenn/dinero_mail"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "dinero_mail"
+  gem.require_paths = ["lib"]
+  gem.version       = DineroMail::VERSION
+  gem.platform      = Gem::Platform::RUBY
+  gem.rubyforge_project = 'dinero_mail'
+
+  gem.add_dependency "savon"
+end

data/lib/dinero_mail.rb

@@ -0,0 +1,12 @@
+require "dinero_mail/version"
+require "dinero_mail/configuration"
+require 'dinero_mail/client'
+
+module DineroMail
+  self.configure do |config|
+    config.environment = :test
+    config.username = 'test'
+    config.password = 'test'
+    config.secret = Digest::SHA2.hexdigest(Time.now.to_s)
+  end
+end

data/lib/dinero_mail/client.rb

@@ -0,0 +1,18 @@
+require 'savon'
+require File.dirname(__FILE__) + '/operations'
+require File.dirname(__FILE__) + '/../support_ext/hash'
+
+module DineroMail
+  class Client
+    include DineroMail::Operations
+
+    attr_reader :client, :credential, :response, :secret
+
+    def initialize(credentials = {}, secret = nil)
+      url = DineroMail.configuration.test? ? 'https://sandboxapi.dineromail.com/DMAPI.asmx?WSDL' : 'https://api.dineromail.com/dmapi.asmx?WSDL'
+      @credential = { 'APIUserName' => DineroMail.configuration.username, 'APIPassword' => DineroMail.configuration.password  }
+      @secret = DineroMail.configuration.secret || Digest::SHA2.hexdigest(Time.now.to_s)
+      @client = Savon::Client.new(url)
+    end
+  end
+end

data/lib/dinero_mail/configuration.rb

@@ -0,0 +1,22 @@
+module DineroMail
+  class Configuration
+    attr_accessor :environment, :username, :password, :secret
+
+    def test?
+      self.environment == :test
+    end
+
+    def production?
+      self.environment == :production
+    end
+
+  end
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.configure
+    self.configuration ||= Configuration.new
+    yield configuration
+  end
+end

data/lib/dinero_mail/operations.rb

@@ -0,0 +1,177 @@
+require File.dirname(__FILE__) + '/security'
+require File.dirname(__FILE__) + '/response'
+
+module DineroMail
+  module Operations
+    include DineroMail::Security
+
+    KEYS_FOR_ACTION = {
+      get_balance: [:merchant_transaction_id, :unique_message_id],
+      get_operations: [:merchant_transaction_id, :unique_message_id, :operation_id, :start_date, :end_date],
+      send_money: [:merchant_transaction_id, :unique_message_id, :currency, :amount, :to_email, :pay_off, :subject, :message],
+      get_payment_ticket: [:merchant_transaction_id, :unique_message_id, :currency, :amount, :provider]
+    }
+
+    attr_reader :response
+
+    # client.get_balance unique_message_id: '1', merchant_transaction_id: '1'
+    # Methods: currency, status, transaction_id, merchant_transaction_id, message, amount
+     def get_balance(options = {})    
+       response_for :get_balance, { 
+         'Credential' => self.credential, 
+         'Crypt' => 'false', 
+         'UniqueMessageID' => options[:unique_message_id], 
+         'MerchantTransactionId' => options[:merchant_transaction_id], 
+         'Hash' => build_hash_for(:get_balance, options) 
+       }
+     end
+
+     # client.get_operations unique_message_id: '1', merchant_transaction_id: '1', operation_id: '1', start_date: '2012-10-6', end_date: '2012-10-10'
+     # Methods: operations, status, merchant_transaciont_id, message
+     def get_operations(options = {})
+          response_for :get_operations, { 
+            'Credential' => self.credential,
+            'Crypt' => 'false',  
+            'UniqueMessageID' => options[:unique_message_id], 
+            'MerchantTransactionId' => options[:merchant_transaction_id], 
+            'OperationId' => options[:operation_id], 
+            'StartDate' => options[:start_date], 
+            'EndDate' => options[:end_date], 
+            'Hash' => build_hash_for(:get_operations, options) 
+          }
+     end
+
+     #client.send_money currency: 'MXN', amount: '100.00', to_email: 'abraham.kuri@gmail.com', pay_off: 'Producto', subject: 'Pago becalia', message: 'Hola mundo', merchant_transaction_id: '1', unique_message_id: '1'
+     #Methods: transaction_id, status, merchant_transaction_id, message
+     def send_money(options = {})
+       response_for :send_money, {
+         'Credential' => self.credential,
+         'Crypt' => 'false',
+         'Currency' => options[:currency],
+         'Amount' => options[:amount],
+         'ToEmail' => options[:to_email],
+         'PayOff' => options[:pay_off],
+         'Subject' => options[:subject],
+         'Message' => options[:message],
+         'MerchantTransactionId' => options[:merchant_transaction_id],
+         'UniqueMessageID' => options[:unique_message_id],
+         'Hash' => build_hash_for(:send_money, options)
+       }
+     end
+     
+     #client.do_payment_with_reference merchant_transaction_id: '1', unique_message_id: '1', subject: 'hola', message: 'mensaje', provider: 'oxxo', items: [{amount: '100.00', code: 'abc', currency: 'MXN', description: 'descricion', name: 'nombre', quantity: '1'}], buyer: {name: 'abraham', last_name: 'kuri', email: 'a@a.com'}
+     def do_payment_with_reference(options = {})
+       response_for :do_payment_with_reference, {
+        'Credential' => self.credential,
+        'Crypt' => 'false',
+        'MerchantTransactionId' => options[:merchant_transaction_id],
+        'Items' => options[:items],
+        'Buyer' => options[:buyer],
+        'Provider' => options[:provider],
+        'Subject' => options[:subject],
+        'Message' => options[:message],
+        'UniqueMessageID' => options[:unique_message_id],
+        'Hash' => do_payment_with_reference_hash(options)
+       }
+     end
+
+     #c.do_with_draw merchant_transaction_id: '1', method: 'POSTAL', currency: 'MXN', amount: '100.00', address_detail: {street: 'mordor', number: '666', floor: '1', appartment: '5', zip: '666', city: 'inferno', state: 'mordorTown'}, bank_account_detail: {bank:'Banco Santander', bank_number: '300', type: 'CC', name: 'Abraham', last_name: 'Kuri', document_type: 'RFC', document_number: '2019029', branch: '1'}, unique_message_id: '1'
+     #Methods: transaction_id, status, merchant_transaction_id, message
+     def do_with_draw(options = {})
+       response_for :do_with_draw, {
+         'Credential' => self.credential,
+         'Crypt' => 'false',
+         'MerchantTransactionId' => options[:merchant_transaction_id],
+         'Method' => options[:method],
+         'Currency' => options[:currency],
+         'Amount' => options[:amount],
+         'AddressDetail' => options[:address_detail],
+         'BankAccountDetail' => options[:bank_account_detail],
+         'UniqueMessageID' => options[:unique_message_id],
+         'Hash' => do_with_draw_hash(options)
+       }
+     end
+
+     #c.do_payment_with_credit_card merchant_transaction_id: '1', items: [{amount: '100.00', code: 'abc', currency: 'MXN', description: 'descricion', name: 'nombre', quantity: '1'}], buyer: {name: 'abraham', last_name: 'kuri', email: 'a@a.com'}, provider: 'MX_BANORTE_TD', credit_card: {installment: '2', credit_card_number: '123456', holder: 'adrian', expiration_date: '12/16', security_code: '1234', document_number: '1'}, unique_message_id: '1'
+     def do_payment_with_credit_card(options = {})
+       response_for :do_payment_with_credit_card, {
+         'Credential' => self.credential,
+         'Crypt' => 'false',
+         'MerchantTransactionId' => options[:merchant_transaction_id],
+         'Items' => options[:items],
+         'Buyer' => options[:buyer],
+         'Provider' => options[:provider],
+         'CreditCard' => options[:credit_card],
+         'Subject' => options[:subject],
+         'Message' => options[:message],
+         'UniqueMessageID' => options[:unique_message_id],
+         'Hash' => do_payment_with_credit_card_hash(options)
+       } 
+     end
+
+     #c.get_payment_ticket currency: "MXN", amount: "100.0", provider: "oxxo", merchant_transaction_id: "1", unique_message_id: "1"
+     def get_payment_ticket(options = {})
+       response_for :get_payment_ticket, {
+         'Credential' => self.credential,
+         'Crypt' => 'false',
+         'Currency' => options[:currency],
+         'Amount' => options[:amount],
+         'MerchantTransactionId' => options[:merchant_transaction_id],
+         'Provider' => options[:provider],
+         'UniqueMessageID' => options[:unique_message_id],
+         'Hash' => build_hash_for(:get_payment_ticket, options)
+       } 
+     end
+
+     private
+
+       def build_hash(options = {}, *keys)
+         encrypt_with :md5, options.get_values_for_keys(*keys).join + self.secret
+       end
+       
+       def build_hash_for(action, options = {})
+         build_hash options, *KEYS_FOR_ACTION[action]
+       end
+
+       def response_for(action, body = {})
+         response = client.request action, body: body 
+         DineroMail::Response.new(response.to_array.first)
+       end
+
+       def do_payment_with_reference_hash(options = {})
+          itemsConcat = options[:items].map do |item| 
+            item.get_values_for_keys(:amount, :code, :currency, :description, :name, :quantity).join
+          end.join
+
+          buyerConcat = options[:buyer].get_values_for_keys(:name, :last_name,  :email, :address, :phone, :country, :city).join
+          options.merge!({items_concat: itemsConcat, buyer_concat: buyerConcat})
+
+          build_hash options, :merchant_transaction_id, :unique_message_id, :items_concat, :buyer_concat, :provider, :subject, :message
+       end
+
+       def do_with_draw_hash(options ={})
+         addressConcat = options[:address_detail].get_values_for_keys(:street, :number, :floor, :appartment, :zip, :city, :state).join
+         bankAccountConcat = options[:bank_account_detail].get_values_for_keys(:bank, :bank_number, :type, :name, :last_name, :document_type, :document_number, :branch).join
+
+         options.merge!({address_concat: addressConcat, bank_account_concat: bankAccountConcat })
+
+         build_hash options, :merchant_transaction_id, :unique_message_id, :method, :currency, :amount, :address_concat, :bank_account_concat
+       end
+
+       def do_payment_with_credit_card_hash(options = {}) 
+         itemsConcat = options[:items].map do |item|
+           item.get_values_for_keys(:amount, :code, :currency, :description, :name, :quantity).join
+         end.join
+
+         buyerConcat = options[:buyer].get_values_for_keys(:name, :last_name,  :email, :address, :phone, :country, :city).join
+
+         creditcardConcat = options[:credit_card].get_values_for_keys(:installment, :credit_card_number, :holder, :expiration_date,
+                                                                      :security_code, :document_number, :address, :address_number, :address_complement, :zip_code, :neighborhodd, :city, :state, :country)
+
+         options.merge!({items_concat: itemsConcat, buyer_concat: buyerConcat, credit_card_concat: creditcardConcat})
+
+         build_hash options, :merchant_transaction_id, :unique_message_id, :items_concat, :buyer_concat, :credit_card_concat, :provider, :subject, :message
+       end
+
+  end
+end

data/lib/dinero_mail/response.rb

@@ -0,0 +1,52 @@
+module DineroMail
+  class Response
+    attr_reader :attributes
+
+    def initialize(attr = {})
+      @attributes = attr
+    end
+
+    def method_missing(name, *args, &block)
+      nested_value  = nested_hash_value(@attributes, name)
+      if args.empty? && block.nil? && !nested_value.nil?
+        nested_value
+      else
+        super
+      end
+    end
+
+    def success?
+      self.status == "OK" or self.status == "COMPLETED"
+    end
+
+    def error?
+      self.status == "ERROR"
+    end
+    
+    def denied?
+      self.status == "DENIED"
+    end
+
+    def completed?
+      self.status == "COMPLETED" or self.status == "OK"
+    end
+
+    def pending?
+      self.status == "PENDING"
+    end
+
+    def procesing?
+      self.status == "PROCESING" 
+    end
+
+    def nested_hash_value(obj,key)
+      if obj.respond_to?(:key?) && obj.key?(key)
+        obj[key]
+      elsif obj.respond_to?(:each)
+        r = nil
+        obj.find{ |*a| r=nested_hash_value(a.last,key)  }
+        r
+      end
+    end
+  end
+end

data/lib/dinero_mail/security.rb

@@ -0,0 +1,14 @@
+require 'digest/md5'
+
+module DineroMail
+  module Security
+    def encrypt_with(method, string)
+     send(method.to_sym, string) 
+    end
+
+    def md5(string)
+      Digest::MD5.hexdigest(string) 
+    end
+
+  end
+end

data/lib/dinero_mail/version.rb

@@ -0,0 +1,3 @@
+module DineroMail
+  VERSION = "0.0.1"
+end

data/lib/support_ext/hash.rb

@@ -0,0 +1,7 @@
+class Hash
+  def get_values_for_keys(*keys)
+    keys.each_with_object([]) do |key, array|
+      array << self[key].to_s
+    end
+  end
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: dinero_mail
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Abraham Kuri
+- Adrian Gonzalez
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-10-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: savon
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Integrate Dinero Mail as PaymentOption to Rails
+email:
+- weare@icalialabs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- dinero_mail.gemspec
+- lib/dinero_mail.rb
+- lib/dinero_mail/client.rb
+- lib/dinero_mail/configuration.rb
+- lib/dinero_mail/operations.rb
+- lib/dinero_mail/response.rb
+- lib/dinero_mail/security.rb
+- lib/dinero_mail/version.rb
+- lib/support_ext/hash.rb
+homepage: https://github.com/kurenn/dinero_mail
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: dinero_mail
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Dinero Mail Rails Integration
+test_files: []