credomatic-payments 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 107083818dcedecd37e506e69402ec0091fd381a
+  data.tar.gz: f0cce75be8db234d0627ff06f5aac3f31149a0e1
+SHA512:
+  metadata.gz: 59bcf7de59b66a68c217ecbb952270e2996c1566c6e8bf7e8299f876b79d2e21ebdde38523741e937c3950032ef4a6f8ccaa22179976b03a1ccb69106d4b0b52
+  data.tar.gz: c9f84a74e280bab70235432b458791bfb1ae9932296f7844abf9892d4e1efcba7d5ea40f265ead0459d17c825e4c3ba5cf752a5284c77024df96b9b6004528fa

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,7 @@
+---
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.4.0
+before_install: gem install bundler -v 1.16.6

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in credomatic-payments.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,35 @@
+PATH
+  remote: .
+  specs:
+    credomatic-payments (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.3)
+    rake (10.5.0)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  credomatic-payments!
+  rake (~> 10.0)
+  rspec (~> 3.2)
+
+BUNDLED WITH
+   1.16.6

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 David Cortes
+
+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,122 @@
+# Credomatic Payments
+
+Gema para la conexion al servicio de pagos de Credomatic Costa Rica. Encapsula el endpoint de pagos de Credomatic, y permite crear ventas y autorizaciones.
+
+## Instalación
+
+Agregar la siguiente linea en su Gemfile:
+
+```ruby
+gem 'credomatic-payments'
+```
+
+Luego ejecute:
+
+    $ bundle
+
+O instalelo usted mismo:
+
+    $ gem install credomatic-payments
+
+## Uso
+
+Para poder utilizar la geme debe crear una instancia de la clase Transactions, dicha clase se encuentra dentro del modulo Credomatic::Payments
+
+```ruby
+transaction = Transactions.new(KEY_ID, KEY)
+```
+
+Una vez creada la instancia basta con llamar al metodo generate_transaction, con los parametros adecuados para recibir una respuesta por parte del servidor de Credomatic.
+
+```ruby
+transaction.generate_transaction(TRANSACTION_TYPE, REDIRECT_URL, CARD_NUMBER, CARD_EXPERATION, AMOUNT, ORDERID, CVV, ADDRESS, PROCESSOR_ID)
+```
+
+A continuacion se describen cada uno de los parametros:
+
+- TRANSACTION_TYPE: tipo de transaccion, actualmente se soportan el tipo "sale" y "auth"
+- REDIRECT_URL: opcional, si utiliza el redirect url, su pagina web debera tener un url que soporte get donde el servidor de credomatic, brindara la respuesta. Si no se pasa un redirect url, se activara el modo api, y el response sera procesado por la gema.
+- CARD_NUMBER: Número de tarjeta.
+- AMOUNT: valor de la venta.
+- ORDERID: valor opcional, es un id que se le quiera dar a la orden.
+- CVV: código de seguridad de la tarjeta.
+- ADDRESS: valor opcional, direccion del dueño de la tarjeta.
+- PROCESSOR_ID: valor opcional, Identificador de la terminal con la cual desea realizar la autorización, credomatic determinará si se debe pasar algun valor en este parámetro.
+
+### Respuesta modo API
+
+En caso de no utilizar un redirect url, la gema sera la encargada de procesar la respuesta del servidor, acontinuacion se detalla la respuesta.
+
+```ruby
+response = transaction.generate_transaction(TRANSACTION_TYPE, REDIRECT_URL, CARD_NUMBER, CARD_EXPERATION, AMOUNT, ORDERID, CVV, ADDRESS, PROCESSOR_ID)
+```
+
+La variable response es un hash, con las siguientes llaves:
+
+- response
+- responsetext
+- authcode
+- transactionid
+- avsresponse
+- cvvresponse
+- orderid
+- type
+- response_code
+
+Basándonos en la documentación de credomatic, los valores de dichas variables se resumen en la siguiente tabla:
+
+Response
+
+| Codigo 	|                         Valor                         	|
+|:------:	|:-----------------------------------------------------:	|
+|    1   	| Transacción Aprobada                                  	|
+|    2   	| Transacción Denegada                                  	|
+|    3   	| Error en datos de la transacción o error del sistema. 	 |
+
+Response Code
+
+| Codigo 	|                   Valor                   	|
+|:------:	|:-----------------------------------------:	|
+|   100  	| Transacción Aprobada                      	|
+|   200  	| Transacción declinada por el Autorizador. 	 |
+|   300  	| Transacción declinada por el Sistema.     	|
+
+CVV Response
+
+| Codigo 	|                                 Valor                                	|
+|:------:	|:--------------------------------------------------------------------:	|
+|    M   	| CVV2/CVC2 Match                                                      	|
+|    N   	| CVV2/CVC2 No Match                                                   	|
+|    P   	| Not Processed                                                        	|
+|    S   	| Merchant has indicated that CVV2/CVC2 is not present on card         	|
+|    U   	| Issuer is not certified and/or has not provided Visa encryption keys 	|
+
+AVS Response
+
+| Codigo 	|                 Valor                	|
+|:------:	|:------------------------------------:	|
+|    X   	| Exact match, 9-character numeric ZIP 	|
+|    Y   	| Exact match, 5-character numeric ZIP 	|
+|    D   	| "                                    	|
+|    M   	| "                                    	|
+|    A   	| Address match only                   	|
+|    B   	| "                                    	|
+|    W   	| 9-character numeric ZIP match only   	|
+|    Z   	| 5-character Zip match only           	|
+|    P   	| "                                    	|
+|    L   	| "                                    	|
+|    N   	| No address or ZIP match              	|
+|    C   	| "                                    	|
+|    U   	| Address unavailable                  	|
+|    G   	| Non-U.S. Issuer does not participate 	|
+|    I   	| "                                    	|
+|    R   	| Issuer system unavailable            	|
+|    E   	| Not a mail/phone order               	|
+|    S   	| Service not supported                	|
+|    0   	| AVS Not Available                    	|
+|    O   	| "                                    	|
+|    B   	| "                                    	|
+
+## Licencia
+
+Esta gema es open source bajo los estatutos de la licencia [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "credomatic/payments"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/credomatic-payments.gemspec

@@ -0,0 +1,31 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "credomatic/payments/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "credomatic-payments"
+  spec.version       = Credomatic::Payments::VERSION
+  spec.authors       = ["David Cortes"]
+  spec.email         = ["dcortes22@gmail.com"]
+
+  spec.summary       = %q{Manejo de pagos Credomatic Costa Rica}
+  spec.description   = %q{Realice pagos desde su sitio web con Credomatic Gateway.}
+  spec.homepage      = "https://github.com/dcortes22/credomatic-payments"
+  spec.license       = "MIT"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.2"
+
+  spec.files        = `git ls-files`.split("\n")
+end

data/lib/credomatic/payments.rb

@@ -0,0 +1,76 @@
+require "credomatic/payments/version"
+require 'digest'
+require "net/http"
+require "uri"
+require "json"
+require 'cgi'
+
+module Credomatic
+  module Payments
+    class Transactions
+
+      def initialize(key_id, key)
+        @key_id = key_id
+        @key = key
+        @redirect_url = "https://credomatic.compassmerchantsolutions.com/api/transact.php"
+        @api_url = "https://credomatic.compassmerchantsolutions.com/api/transact.php"
+      end
+
+      def input_hash(orderid, amount, time)
+        value =  "#{orderid}|#{'%.2f' % amount}|#{time}|#{@key}"
+        Digest::MD5.hexdigest(value)
+      end
+
+      def response_hash(orderid, amount, response, transactionid, avsresponse, cvvresponse, time)
+        value =  "#{orderid}|#{'%.2f' % amount}|#{response}|#{transactionid}|#{avsresponse}|#{cvvresponse}|#{time}|#{@key}"
+        Digest::MD5.hexdigest(value)
+      end
+
+
+      def generate_transaction(type, redirect_url, ccnumber, ccexp, amount, orderid, cvv, avs, processor_id)
+        @time = Time.now.getutc.to_i
+        if type == "sale"
+          @input_hash = input_hash("", amount, @time)
+        else
+          @input_hash = input_hash(orderid, amount, @time)
+        end
+        
+        if redirect_url == nil
+          uri = URI(@api_url)
+          params = {
+            type: type,
+            key_id: @key_id,
+            hash: @input_hash,
+            time: @time,
+            ccnumber: ccnumber,
+            ccexp: ccexp,
+            amount: "#{'%.2f' % amount}",
+            orderid: orderid,
+            cvv: cvv,
+            avs: avs,
+            processor_id: processor_id
+          }
+          response = Net::HTTP.post_form( uri, params )
+
+          if( response.is_a?( Net::HTTPSuccess ) )
+            # your request was successful
+            responseValue = CGI::parse(response.body)
+            responseValue = responseValue.each { |key, value| responseValue[key] = value.first}
+            responseValue
+          else
+            # your request failed
+            responseValue = CGI::parse(response.body)
+            responseValue = responseValue.each { |key, value| responseValue[key] = value.first}
+            responseValue
+          end
+        end
+
+      end
+      
+      def key_id
+        @key_id
+      end
+
+    end 
+  end
+end

data/lib/credomatic/payments/version.rb

@@ -0,0 +1,5 @@
+module Credomatic
+  module Payments
+    VERSION = "0.1.0"
+  end
+end

data/spec/credomatic/payments_spec.rb

@@ -0,0 +1,41 @@
+RSpec.describe Credomatic::Payments do
+  it "has a version number" do
+    expect(Credomatic::Payments::VERSION).not_to be nil
+  end
+
+  it "initializes a transaction with a key id" do
+    transaction = Credomatic::Payments::Transactions.new(123, 23232332222222222222222222222222)
+    expect(transaction.key_id).to  eq(123)
+  end
+
+  it "generates a correct input hash" do
+    transaction = Credomatic::Payments::Transactions.new(123, 23232332222222222222222222222222)
+
+    orderid = "test"
+    amount = 1.00
+    time = 1279302634
+
+    expect(transaction.input_hash(orderid, amount, time)).to  eq("416ed27036d4276a267818c530527acf")
+  end
+
+  it "generates a correct response hash" do
+    transaction = Credomatic::Payments::Transactions.new(123, 23232332222222222222222222222222)
+
+    orderid = "test" 
+    amount= 1.00 
+    response=1
+    transactionid = 273247169 
+    avsresponse="N" 
+    cvvresponse="N"
+    time = 1279302634
+
+    expect(transaction.response_hash(orderid, amount, response, transactionid, avsresponse, cvvresponse, time)).to  eq("2f4f1c087cfd908903647823064da9bc")
+  end
+
+  it "generates a sale but declined by system" do
+    transaction = Credomatic::Payments::Transactions.new(123, 23232332222222222222222222222222)
+    response = transaction.generate_transaction("sale", nil, "4012001011000771", 1022, 1.00, "", 4223, "Desamparados", "")
+    expect(response["response_code"]).to eq("200")
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+require "bundler/setup"
+require "credomatic/payments"
+
+RSpec.configure do |config|
+  # Enable flags like --only-failures and --next-failure
+  config.example_status_persistence_file_path = ".rspec_status"
+
+  # Disable RSpec exposing methods globally on `Module` and `main`
+  config.disable_monkey_patching!
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: credomatic-payments
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- David Cortes
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-10-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+description: Realice pagos desde su sitio web con Credomatic Gateway.
+email:
+- dcortes22@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- credomatic-payments.gemspec
+- lib/credomatic/payments.rb
+- lib/credomatic/payments/version.rb
+- spec/credomatic/payments_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/dcortes22/credomatic-payments
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.10
+signing_key: 
+specification_version: 4
+summary: Manejo de pagos Credomatic Costa Rica
+test_files: []