khipu 1.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: bbdd3f10aea423ebab6c1e4801ae8cd3dd0da2f1
+  data.tar.gz: ee8f254750eef7c4e1beb041adc251a872bbd0c2
+SHA512:
+  metadata.gz: d4da9dff3275f4eca53ff9d835d166b26672a0dc65b5f7f71b1b35c2cf50e0774b1ea905d3c494e57dd7d2733d40a3eb71207f16f71438f060f1c801ca8a3f21
+  data.tar.gz: e8aeca81768df4f5519c30f466349ba3cd25d4d97dd0b084754ab6bf372712eb4b58ebe08c55f2b1ff050f55db033a0a23e77f1143fbfdf50ae11a53d567c6da

data/.gitignore

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

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,29 @@
+Copyright (c) 2014, khipu SpA
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+1. Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+contributors may be used to endorse or promote products derived from
+this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,229 @@
+# khipu
+
+[khipu - Yo pago, Yo cobro](https://khipu.com)
+
+Gema Ruby para utilizar los servicios de Khipu.com
+
+Versión Biblioteca: 1.3.0
+
+Versión API Khipu: 1.3
+Versión API de notificación: 1.2
+
+La documentación de Khipu.com se puede ver desde aquí: [https://khipu.com/page/api](https://khipu.com/page/api)
+
+## Uso
+
+Primero instalar la gema ruby
+
+```Bash
+    $ gem install khipu
+```
+
+Luego debes incluir la gema desde tus scripts Ruby usando _require 'khipu'_
+
+## Operaciones
+
+Esta biblioteca implementa los siguientes servicios de khipu:
+
+1. Obtener listado de bancos
+2. Crear cobros y enviarlos por mail. 
+3. Crear una página de Pago.
+4. Crear una página de Pago (autenticado).
+5. Crear un pago y obtener us URL.
+6. Crear un pago y obtener us URL (autenticado).
+7. Recibir y validar la notificación de un pago.
+8. Verificar el estado de una cuenta de cobro.
+9. Verificar el estado de un pago.
+10. Marcar un pago como pagado.
+11. Marcar un cobro como expirado.
+12. Marcar un pago como rechazado.
+
+
+### 1) Obtener listado de bancos.
+
+Este servicio entrega un mapa con el listado de los bancos disponibles para efectuar un pago a un cobrador determinado.
+Cada banco tiene su identificador, un nombre, el monto mínimo que se puede transferir desde él y un mensaje con
+información importante.
+
+```Ruby
+    begin 
+        banks = Khipu.create_khipu_api(ID_DEL_COBRADOR, 'SECRET_DEL_COBRADOR').receiver_banks
+    rescue Khipu::ApiError  => error
+        puts error.type
+        puts error.message
+    end
+```
+
+### 2) Crear cobros y enviarlos por mail.
+
+Este servicio entrega un mapa que contiene el identificador del cobro generado así como una lista de los pagos asociados
+a este cobro. Por cada pago se tiene el ID, el correo asociado y la URL en khipu para pagar.
+
+```Ruby
+    begin 
+        service = Khipu.create_khipu_api(ID_DEL_COBRADOR, SECRET_DEL_COBRADOR)
+        map = service.create_email({subject: 'Un cobro desde Ruby', amount: '10', destinataries: [ {name: "John Doe", email: "john.doe@gmail.com", amount: "1000"}, {name: "Jane Dow", email: "jane.dow@gmail.com", amount: "1000"}], pay_directly: true, send_emails: true})
+    rescue Khipu::ApiError => error
+        puts error.type
+        puts error.message
+    end
+```
+*Importante*: El parámetro _destinataries_ es un mapa Ruby y no un string. Internamente es convertido a un string JSON
+
+### 3) Crear una página de Pago.
+
+Este ejemplo genera un archivo .html con un formulario de pago en khipu.
+
+```Ruby
+    File.open('form.html', 'w') { |file|
+        service = Khipu.create_html_helper(2, 'e40ac9591200b2ec9277cd1c795af82d618cf78e')
+        form = service.create_payment_form({subject: 'Un cobro desde Ruby', body: 'El cuerpo del cobro', amount: "1000", email: 'john.doe@gmail.com'})
+        file.write(form)
+    }
+```
+
+### 4) Crear una página de Pago (autenticado).
+
+Para crear una página de pago que solo permita pagar usando una cuenta asociada a un RUT en particular debes usar el
+mismo servicio del punto anterior indicando el RUT en el parámetro _payer_username_
+
+```Ruby
+    File.open('form.html', 'w') { |file|
+        service = Khipu.create_html_helper(2, 'e40ac9591200b2ec9277cd1c795af82d618cf78e')
+        form = service.create_payment_form({subject: 'Un cobro desde Ruby', body: 'El cuerpo del cobro', amount: "1000", email: 'john.doe@gmail.com', payer_username: '128723463'})
+        file.write(form)
+    }
+```
+
+### 5) Crear un pago y obtener su URL.
+
+Este servicio entrega un mapa que contiene el identificador de un pago generado, su URL en khipu y la URL para iniciar
+el pago desde un dispositivo móvil.
+
+```Ruby
+    begin 
+        service = Khipu.create_khipu_api(ID_DEL_COBRADOR, SECRET_DEL_COBRADOR)
+        map = service.create_payment_url({subject: 'Un cobro desde Ruby', body: 'El cuerpo del cobro', amount: "1000", email: 'john.doe@gmail.com'})
+    rescue Khipu::ApiError => error
+        puts error.type
+        puts error.message
+    end
+```
+### 6) Crear un pago y obtener su URL (autenticado).
+
+Este servicio es idéntico al anterior pero usando el parámetro _payer_username_ se fuerza que la cuenta corriente usada
+para pagar debe estar asociada al RUT indicado.
+
+```Ruby
+    begin
+        service = Khipu.create_khipu_api(ID_DEL_COBRADOR, SECRET_DEL_COBRADOR)
+        map = service.create_authenticated_payment_url({subject: 'Un cobro desde Ruby', body: 'El cuerpo del cobro', amount: "1000", email: 'john.doe@gmail.com', payer_username: '128723463'})
+    rescue Khipu::ApiError => error
+        puts error.type
+        puts error.message
+    end
+```
+Se puede obtener una
+### 7) Validar la notificación de un pago.
+
+Este ejemplo contacta a khipu para validar los datos de una transacción. Para usar
+este servicio no es necesario configurar el SECRET del cobrador. Se retorna true si la información del la notificación
+es válida. En este ejemplo los parámetros se configuran a mano, pero en producción los datos deben obtenerse desde
+el _request html_.
+
+```Ruby
+    begin 
+        service = Khipu.create_khipu_api(ID_DEL_COBRADOR, SECRET_DEL_COBRADOR)
+        params = {api_version: '1.2', 
+                notification_id: 'aq1td2jl2uen', 
+                subject: 'Motivo de prueba', 
+                amount: 12575,
+                currency: 'CLP', 
+                transaction_id: 'FTEEE5SWWO', 
+                payer_email: 'john.doe@gmail.com',
+                custom: 'Custom info', 
+                notification_signature: 'j8kPBHaPNy3PkCh...hhLvQbenpGjA=='
+        }
+        valid = service.verify_payment_notification(params)
+    rescue Khipu::ApiError => error
+        puts error.type
+        puts error.message
+    end
+```
+
+
+### 8) Verificar el estado de una cuenta de cobro.
+
+Este servicio permite consultar el estado de una cuenta khipu. Se devuelve un mapa que indica si esta cuenta está
+habilitada para cobrar y el tipo de cuenta (desarrollo o producción).
+
+```Ruby
+    begin 
+        service = Khipu.create_khipu_api(ID_DEL_COBRADOR, SECRET_DEL_COBRADOR)
+        map = service.receiver_status; 
+    rescue Khipu::ApiError => error
+        puts error.type
+        puts error.message
+    end
+```
+ 
+### 9) Verificar el estado de un pago.
+
+Este servició sirve para verificar el estado de un pago.
+
+```Ruby
+    begin 
+        service = Khipu.create_khipu_api(ID_DEL_COBRADOR, SECRET_DEL_COBRADOR)
+        map = service.payment_status({payment_id: '9fnsggqqi8ho'})
+    rescue Khipu::ApiError  => error
+        puts error.type
+        puts error.message
+    end
+```
+
+### 10) Marcar un cobro como pagado.
+
+Este servicio permite marcar un cobro como pagado. Si el pagador paga por un método alternativo a khipu, el cobrador
+puede marcar este cobro como saldado.
+
+```Ruby
+    begin 
+        service = Khipu.create_khipu_api(ID_DEL_COBRADOR, SECRET_DEL_COBRADOR)
+        service.set_paid_by_receiver({payment_id: '54dhfsch6avd'});
+    rescue Khipu::ApiError => error
+        puts error.type
+        puts error.message
+    end
+```
+
+### 11) Marcar un cobro como expirado.
+
+Este servicio permite adelantar la expiración del cobro. Se puede adjuntar un texto que será desplegado a la gente que
+trate de ir a pagar.
+
+
+```Ruby
+    begin 
+        service = Khipu.create_khipu_api(ID_DEL_COBRADOR, SECRET_DEL_COBRADOR)
+        service.set_bill_expired({bill_id: 'udmEe', text: 'Plazo vencido'})
+    rescue Khipu::ApiError => error
+        puts error.type
+        puts error.message
+    end
+```
+
+### 12) Marcar un cobro como rechazado.
+
+Este servicio permite rechazar pago con el fin de inhabilitarlo. Permite indicar la razón por la que el pagador rechaza
+saldar este pago:
+
+
+```Ruby
+    begin 
+        service = Khipu.create_khipu_api(ID_DEL_COBRADOR, SECRET_DEL_COBRADOR)
+        service.set_rejected_by_payer({payment_id: '0pk7xfgocry4', text: 'El pago no corresponde'});
+    rescue Khipu::ApiError => error
+        puts error.type
+        puts error.message
+    end
+```

data/Rakefile

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

data/khipu.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'khipu/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "khipu"
+  spec.version       = Khipu::VERSION
+  spec.authors       = ["Alex Lorca"]
+  spec.email         = ["alex.lorca@khipu.com"]
+  spec.description   = "A wrapper for khipu's web API"
+  spec.summary       = "A wrapper for khipu's web API"
+  spec.homepage      = "https://github.com/khipu/lib-ruby"
+  spec.license       = "BSD"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = ">= 1.9"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+end

data/lib/khipu/api_error.rb

@@ -0,0 +1,10 @@
+module Khipu
+  class ApiError < StandardError
+    attr_accessor :type, :message
+
+    def initialize(type, message)
+      @type = type
+      @message = message
+    end
+  end
+end

data/lib/khipu/const.rb

@@ -0,0 +1,59 @@
+module Khipu
+  CERT_PROD = %q{-----BEGIN CERTIFICATE-----
+MIIFuDCCBSGgAwIBAgIQHCWU8WfzVpZq9iYPMgYpVzANBgkqhkiG9w0BAQUFADCB
+0DEUMBIGA1UEChMLRS1TaWduIFMuQS4xHzAdBgNVBAsTFlZlcmlTaWduIFRydXN0
+IE5ldHdvcmsxODA2BgNVBAsTL1Rlcm1zIG9mIHVzZSBhdCBodHRwczovL3d3dy5l
+LXNpZ24uY2wvcnBhIChjKTA1MTwwOgYDVQQDEzNFLVNpZ24gU0MgQ2xhc3MgMiBD
+b25zdW1lciBJbmRpdmlkdWFsIFN1YnNjcmliZXIgQ0ExHzAdBgkqhkiG9w0BCQEW
+EGUtc2lnbkBlLXNpZ24uY2wwHhcNMTIxMTA3MDAwMDAwWhcNMTMxMTA3MjM1OTU5
+WjCCAQgxMDAuBgNVBAsTJ1Rlcm1zIG9mIHVzZSBhdCB3d3cuZS1zaWduLmNsL3Jw
+YSBDKDA0KTElMCMGA1UECxMcQXV0aGVudGljYXRlZCBieSBFLVNpZ24gUy5BLjEn
+MCUGA1UECxMeTWVtYmVyLCBWZXJpU2lnbiBUcnVzdCBOZXR3b3JrMRswGQYDVQQL
+ExJEaWdpdGFsIElEIENsYXNzIDIxGDAWBgNVBAsUD1JVVCAtIDkxMjM4NDUtNDEl
+MCMGA1UEAxMcUm9iZXJ0byBBbmRyZXMgT3Bhem8gR2F6bXVyaTEmMCQGCSqGSIb3
+DQEJARYXcm9iZXJ0by5vcGF6b0BraGlwdS5jb20wggEiMA0GCSqGSIb3DQEBAQUA
+A4IBDwAwggEKAoIBAQC4xI/f6C/5V/KsIAQY3G2ExoqIb8NoM7czRw9UNdx/OEiL
+QJfqJjx1gVkcZxHqcWT6DENuf7H2LyYvzXOfeQgN5Zw8FCdIxjoF00AOIf3YDLdG
+0IXoiRuZWPh9JkbGyl/tSd/fJWSh12GQAUE0m0YYMNHGiNPqiZ3jJEUgNWKjfO2D
+xMqTGrujDnA3qF/2SiBrWRj5XyZCIYumrHWKGQnvmd6uaH4SOyaPc1Jl8byqfzg6
+GlHX2hWyVJ2Tc+GHxAiSm8RzUfSAfgCbUm+/8gX0uDlGA7dqaa9FIZh7RWBdN4Nn
+Dd9XHEOtXnBVL6mFzut57eAwEHz+a6tv2E2yy/GJAgMBAAGjggHSMIIBzjAiBgNV
+HREEGzAZoBcGCCsGAQQBwQEBoAsWCTkxMjM4NDUtNDAJBgNVHRMEAjAAMAsGA1Ud
+DwQEAwIFoDCBmQYDVR0gBIGRMIGOMIGLBgtghkgBhvhFAQcXAjB8MDEGCCsGAQUF
+BwIBFiVodHRwczovL3d3dy5lLXNpZ24uY2wvcmVwb3NpdG9yaW8uaHRtMEcGCCsG
+AQUFBwICMDsaOUNlcnRpZmljYWRvIHBhcmEgdXNvIFRyaWJ1dGFyaW8sIENvbWVy
+Y2lvLCBQYWdvcyB5IE90cm9zLjAjBgNVHRIEHDAaoBgGCCsGAQQBwQECoAwWCjk5
+NTUxNzQwLUswTQYDVR0fBEYwRDBCoECgPoY8aHR0cDovL29uc2l0ZWNybC52ZXJp
+c2lnbi5jb20vRVNpZ25TQUNTQ0NsYXNzMi9MYXRlc3RDUkwuY3JsMDsGCCsGAQUF
+BwEBBC8wLTArBggrBgEFBQcwAYYfaHR0cDovL29uc2l0ZS1vY3NwLnZlcmlzaWdu
+LmNvbTAdBgNVHSUEFjAUBggrBgEFBQcDAgYIKwYBBQUHAwQwEQYJYIZIAYb4QgEB
+BAQDAgeAMBEGCmCGSAGG+EUBBgkEAwEB/zANBgkqhkiG9w0BAQUFAAOBgQAFiXQz
+K9TrKWkJH3is2H/QI8gynHQV71kvmSUnRgPk5TdXzd6EDhbaQMC3pCdwhpKKUfFo
+0Ky8wtkagE8jdCRkpDfGpnhINfJZW9HH3gKe2zFckynPZcV5fsVM1tQzWQNBPaFf
+scJQlyZrC17dCDWkJ2op67BRjp97skB1SUWtRw==
+-----END CERTIFICATE-----}
+
+  CERT_DEV = %q{-----BEGIN CERTIFICATE-----
+MIIDszCCApsCBFA88VcwDQYJKoZIhvcNAQEFBQAwgZ0xIDAeBgkqhkiG9w0BCQEW
+EXJvYmVydG9Acm9wYXpvLmNsMQswCQYDVQQGEwJDTDERMA8GA1UECAwIU2FudGlh
+Z28xCzAJBgNVBAcMAlJNMRIwEAYDVQQKDAlLaGlwdS5jb20xGDAWBgNVBAsMD0dl
+cmVudGUgR2VuZXJhbDEeMBwGA1UEAwwVUm9iZXJ0byBPcGF6byBHYXptdXJpMB4X
+DTEyMDgyODE2MjcwM1oXDTEzMDgyODE2MjcwM1owgZ0xIDAeBgkqhkiG9w0BCQEW
+EXJvYmVydG9Acm9wYXpvLmNsMQswCQYDVQQGEwJDTDERMA8GA1UECAwIU2FudGlh
+Z28xCzAJBgNVBAcMAlJNMRIwEAYDVQQKDAlLaGlwdS5jb20xGDAWBgNVBAsMD0dl
+cmVudGUgR2VuZXJhbDEeMBwGA1UEAwwVUm9iZXJ0byBPcGF6byBHYXptdXJpMIIB
+IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAk+0IYrfbAPSRSX8u3+js786J
+QTMXGS52LUFHOKXokQbqfcbPs9qwBDr4NeRbM3GQ8CRLLM9PKenHbd93ErpY4GDC
+CWZPU9RA4nFgJa/pJzFEf74dR0tQOnEdEDwCdlAp7EkVFIUnweSDG0QG9Dedvn/J
+tlHMRM0NXQSq6NxFPzjTyK4/J5g86V9LPEt6h+TpQACKxGxKa9cDdt6n8wDhskwV
+V6xiwkq+j+tNh5+DIdKstceG8UulgdpgTt9r7kr9FVwL1L3ugJ4zK1fGYbTwPQRu
+H9C0y7vZ/Mjm/osv9BAm0r57ywVgPU6af2yrTMhMkuCkMrIq4qW0XDiCTiso8QID
+AQABMA0GCSqGSIb3DQEBBQUAA4IBAQCO6do2tYvE5/nLYnPXQbpUhhJLvZbJd+Nl
+jLUlju2yzgNLFA3g19t9uKxKRG497//WdxHoa3lAPnY8IO+DgKp5dOMcKLopz+AX
+jsElzCQxcPNqlYwGQgEDDm9q0WXs1Dg22y0Af1oR5Lx9XR1xWsw4z/6YEDUJRa7D
+fAUIip+ocbMykuUvnrNU/wUDRv8VbsIoMr+1CK3pKACSUuB8ZhYfRUjgHEXKh4O5
+I/hKy49jGW/9i5GOTEGGzOvHm2CIrpBPFWfKSJLjvLtYWbBuCyKK5+FsP4wuN8Rv
+yLM1MDg00bd5M5MmTA1FFNGiGUqpfo7z+kcqRFOJqWm7bmaDvZVJ
+-----END CERTIFICATE-----}
+
+end

data/lib/khipu/html_helper.rb

@@ -0,0 +1,53 @@
+module Khipu
+  class HtmlHelper < KhipuService
+
+    def initialize(receiver_id, secret)
+      super(receiver_id, secret)
+    end
+
+    def create_payment_form(args, button = Khipu::FORM_BUTTONS['50x25'])
+      endpoint_url = Khipu::API_URL + 'createPaymentPage'
+      check_arguments(args, [:subject, :amount])
+      params = {
+          receiver_id: @receiver_id,
+          subject: args[:subject],
+          body: args[:body] || '',
+          amount: args[:amount]
+      }
+      payer_username = ''
+      if args[:payer_username]
+        payer_username = %Q{\n<input type="hidden" name="payer_username" value="#{args[:payer_username]}"/>}
+        params[:payer_username] = args[:payer_username]
+      end
+      params.merge!({
+          payer_email: args[:payer_email] || '',
+          bank_id: args[:bank_id] || '',
+          expires_date: args[:expires_date] || '',
+          transaction_id: args[:transaction_id] || '',
+          custom: args[:custom] || '',
+          notify_url: args[:notify_url] || '',
+          return_url: args[:return_url] || '',
+          cancel_url: args[:cancel_url] || '',
+          picture_url: args[:picture_url] || '',
+      })
+      params[:hash] = hmac_sha256(@secret, concatenated(params))
+      %Q{<form action="#{endpoint_url}" method="post">
+<input type="hidden" name="receiver_id" value="#{params[:receiver_id]}">
+<input type="hidden" name="subject" value="#{params[:subject]}"/>
+<input type="hidden" name="body" value="#{params[:body]}">
+<input type="hidden" name="amount" value="#{params[:amount]}">#{payer_username}
+<input type="hidden" name="notify_url" value="#{params[:notify_url]}"/>
+<input type="hidden" name="return_url" value="#{params[:return_url]}"/>
+<input type="hidden" name="cancel_url" value="#{params[:cancel_url]}"/>
+<input type="hidden" name="custom" value="#{params[:custom]}">
+<input type="hidden" name="transaction_id" value="#{params[:transaction_id]}">
+<input type="hidden" name="payer_email" value="#{params[:payer_email]}">
+<input type="hidden" name="expires_date" value="#{params[:expires_date]}">
+<input type="hidden" name="bank_id" value="#{params[:bank_id]}">
+<input type="hidden" name="picture_url" value="#{params[:picture_url]}">
+<input type="hidden" name="hash" value="#{params[:hash]}">
+<input type="image" name="submit" src="#{button}">
+</form>}
+    end
+  end
+end

data/lib/khipu/khipu_api_endpoint.rb

@@ -0,0 +1,184 @@
+require 'json'
+
+module Khipu
+  class KhipuApiEndpoint < KhipuService
+
+    def initialize(receiver_id, secret)
+      super(receiver_id, secret)
+    end
+
+    def execute(endpoint, params, add_hash = true, json_response = true)
+      post_params = params.clone
+      if add_hash
+        post_params['hash'] = hmac_sha256(@secret, concatenated(params))
+      end
+      post(endpoint, post_params, json_response)
+    end
+
+    def payment_status(args)
+      endpoint = 'paymentStatus'
+      check_arguments(args, [:payment_id])
+      params = {
+          receiver_id: @receiver_id,
+          payment_id: args[:payment_id]
+      }
+      execute(endpoint, params)
+    end
+
+    def create_payment_url(args)
+      endpoint = 'createPaymentURL'
+      check_arguments(args, [:subject, :amount])
+      params = {
+          receiver_id: @receiver_id,
+          subject: args[:subject],
+          body: args[:body] || '',
+          amount: args[:amount],
+          payer_email: args[:payer_email] || '',
+          bank_id: args[:bank_id] || '',
+          expires_date: args[:expires_date] || '',
+          transaction_id: args[:transaction_id] || '',
+          custom: args[:custom] || '',
+          notify_url: args[:notify_url] || '',
+          return_url: args[:return_url] || '',
+          cancel_url: args[:cancel_url] || '',
+          picture_url: args[:picture_url] || ''
+      }
+      resp = execute(endpoint, params)
+      resp_items = %w(id url mobile-url)
+      resp.select{|key, value| resp_items.include?(key)}
+    end
+
+    def create_authenticated_payment_url(args)
+      endpoint = 'createAuthenticatedPaymentURL'
+      check_arguments(args, [:subject, :amount, :payer_username])
+      params = {
+          receiver_id: @receiver_id,
+          subject: args[:subject],
+          body: args[:body] || '',
+          amount: args[:amount],
+          payer_username: args[:payer_username],
+          payer_email: args[:payer_email] || '',
+          bank_id: args[:bank_id] || '',
+          expires_date: args[:expires_date] || '',
+          transaction_id: args[:transaction_id] || '',
+          custom: args[:custom] || '',
+          notify_url: args[:notify_url] || '',
+          return_url: args[:return_url] || '',
+          cancel_url: args[:cancel_url] || '',
+          picture_url: args[:picture_url] || ''
+      }
+      resp = execute(endpoint, params)
+      resp_items = %w(id url mobile-url)
+      resp.select{|key, value| resp_items.include?(key)}
+    end
+
+    def create_email(args)
+      endpoint = 'createEmail'
+      check_arguments(args, [:subject, :destinataries, :pay_directly, :send_emails])
+      params = {
+          receiver_id: @receiver_id,
+          subject: args[:subject],
+          body: args[:body] || '',
+          destinataries: args[:destinataries].to_json,
+          pay_directly: args[:pay_directly],
+          send_emails: args[:send_emails],
+          expires_date: args[:expires_date] || '',
+          transaction_id: args[:transaction_id] || '',
+          custom: args[:custom] || '',
+          notify_url: args[:notify_url] || '',
+          return_url: args[:return_url] || '',
+          cancel_url: args[:cancel_url] || '',
+          picture_url: args[:picture_url] || ''
+      }
+      execute(endpoint, params)
+    end
+
+    def receiver_banks
+      endpoint = 'receiverBanks'
+      params = {
+          receiver_id: @receiver_id
+      }
+      resp = execute(endpoint, params)
+      resp_items = %w(id name message min-amount)
+      resp['banks'].map{|item| item.select{|key, value| resp_items.include?(key)} }
+    end
+
+    def receiver_status
+      endpoint = 'receiverStatus'
+      params = {
+          receiver_id: @receiver_id,
+      }
+      execute(endpoint, params)
+    end
+
+    def set_bill_expired(args)
+      endpoint = 'setBillExpired'
+      check_arguments(args, [:bill_id])
+      params = {
+          receiver_id: @receiver_id,
+          bill_id: args[:bill_id],
+          text: args[:text] || ''
+      }
+      execute(endpoint, params)
+    end
+
+    def set_paid_by_receiver(args)
+      endpoint = 'setPaidByReceiver'
+      check_arguments(args, [:payment_id])
+      params = {
+          receiver_id: @receiver_id,
+          payment_id: args[:payment_id],
+      }
+      execute(endpoint, params)
+    end
+
+    def set_rejected_by_payer(args)
+      endpoint = 'setRejectedByPayer'
+      check_arguments(args, [:payment_id])
+      params = {
+          receiver_id: @receiver_id,
+          payment_id: args[:payment_id],
+          text: args[:text] || ''
+      }
+      execute(endpoint, params)
+    end
+
+    def verify_payment_notification(args)
+      endpoint = 'verifyPaymentNotification'
+      check_arguments(args, [:api_version, :notification_id, :subject, :amount, :payer_email, :notification_signature])
+      params = {
+          api_version: args[:api_version],
+          receiver_id: @receiver_id,
+          notification_id: args[:notification_id],
+          subject: args[:subject],
+          amount: args[:amount],
+          currency: args[:currency] || 'CLP',
+          transaction_id: args[:transaction_id] || '',
+          payer_email: args[:payer_email] || '',
+          custom: args[:custom] || '',
+          notification_signature: args[:notification_signature]
+      }
+      resp = execute(endpoint, params, false, false)
+      resp == 'VERIFIED'
+    end
+
+    def verify_payment_notification_local(args)
+      check_arguments(args, [:api_version, :notification_id, :subject, :amount, :payer_email, :notification_signature])
+      params = {
+          api_version: args[:api_version],
+          receiver_id: @receiver_id,
+          notification_id: args[:notification_id],
+          subject: args[:subject],
+          amount: args[:amount],
+          currency: args[:currency] || 'CLP',
+          transaction_id: args[:transaction_id] || '',
+          payer_email: args[:payer_email] || '',
+          custom: args[:custom] || '',
+      }
+      verify_signature(params, args[:notification_signature])
+    end
+
+
+
+  end
+end

data/lib/khipu/khipu_service.rb

@@ -0,0 +1,76 @@
+require 'net/http'
+require 'openssl'
+require 'base64'
+
+module Khipu
+  class KhipuService
+
+    attr_accessor :receiver_id, :secret, :agent
+
+    def initialize(receiver_id, secret)
+      @receiver_id = receiver_id
+      @secret = secret
+    end
+
+    def post(endpoint, params, json_response = true)
+      uri = URI(Khipu::API_URL + endpoint)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+      if Khipu::DEBUG
+        http.set_debug_output(Khipu::debug_stream)
+      end
+
+      params['agent'] = "lib-ruby-#{Khipu::VERSION} - #{@agent}" if @agent
+
+      req = Net::HTTP::Post.new(uri.request_uri, {'User-Agent' => "khipu-ruby-#{Khipu::VERSION}"})
+      req.set_form_data(params)
+      res = http.request(req)
+      if res.code == '400'
+        begin
+          error = JSON.parse(res.body)
+          raise ApiError.new(error['error']['type'], error['error']['message'])
+        rescue JSON::ParserError
+          raise "Invalid response from endpoint #{uri}"
+        end
+      elsif res.code != '200'
+        raise "Invalid response code #{res.code} endpoint #{uri}"
+      end
+      if Khipu::DEBUG
+        Khipu::debug_stream.puts res.body
+      end
+      if json_response
+        begin
+          JSON.parse(res.body)
+        rescue JSON::ParserError
+          raise "Invalid response from endpoint #{uri}"
+        end
+      else
+        res.body
+      end
+    end
+
+    def check_arguments(args, mandatory_args)
+      mandatory_args.each do |arg|
+        if (!args.has_key? arg)
+          raise(ArgumentError, "#{arg} not present")
+        end
+      end
+    end
+
+    def hmac_sha256(secret, data)
+      OpenSSL::HMAC.digest(OpenSSL::Digest::Digest.new('sha256'), secret, data).unpack('H*').first
+    end
+
+    def concatenated(params)
+      params.collect { |k, v| k.to_s + '=' + v.to_s }.join('&')
+    end
+
+    def verify_signature(params, signature)
+      cert_data = Khipu::dev_env? ? Khipu::CERT_DEV : Khipu::CERT_PROD
+      cert = OpenSSL::X509::Certificate.new(cert_data)
+      pkey = cert.public_key
+      pkey.verify(OpenSSL::Digest::SHA1.new, Base64.decode64(signature), concatenated(params))
+    end
+
+  end
+end

data/lib/khipu/version.rb

@@ -0,0 +1,3 @@
+module Khipu
+    VERSION = "1.3.0"
+end

data/lib/khipu.rb

@@ -0,0 +1,45 @@
+require 'khipu/version'
+require 'khipu/khipu_service'
+require 'khipu/khipu_api_endpoint'
+require 'khipu/html_helper'
+require 'khipu/api_error'
+require 'khipu/const'
+
+module Khipu
+
+  API_URL = 'https://khipu.com/api/1.3/'
+  DEBUG = ENV['KHIPU_DEBUG'] || false
+  FORM_BUTTONS = {
+      '50x25'       => '50x25.png',
+      '100x25'      => '100x25.png',
+      '100x25white' => '100x25-w.png',
+      '100x50'      => '100x50.png',
+      '100x50white' => '100x50-w.png',
+      '150x25'      => '150x25.png',
+      '150x25white' => '150x25-w.png',
+      '150x50'      => '150x50.png',
+      '150x50white' => '150x50-w.png',
+      '150x75'      => '150x75.png',
+      '150x75white' => '150x75-w.png',
+      '200x50'      => '200x50.png',
+      '200x50white' => '200x50-w.png',
+      '200x75'      => '200x75.png',
+      '200x75white' => '200x75-w.png',
+  }.inject({}) { |h, (k, v)| h[k] = 'htps://s3.amazonaws.com/static.khipu.com/buttons/' + v; h }
+
+  def self.create_khipu_api(receiver_id, secret = '')
+    KhipuApiEndpoint.new(receiver_id, secret)
+  end
+
+  def self.create_html_helper(receiver_id, secret)
+    HtmlHelper.new(receiver_id, secret)
+  end
+
+  def self.debug_stream
+    $stdout
+  end
+
+  def self.dev_env?
+    ENV['KHIPU_ENV'] == 'DEV'
+  end
+end

data/spec/khipu_service_spec.rb

@@ -0,0 +1,17 @@
+require "spec_helper"
+
+describe 'KhipuService' do
+
+  it 'should calculate hmac' do
+    service = Khipu::KhipuService.new(1234, '1234')
+    hex_hmac = service.hmac_sha256('abcd', '1234')
+    expect(hex_hmac).to eq('d219a3dd877f943be0ee65ef6a34129778d2fd0568ce2d9a8f37fea9d7fcaca3')
+  end
+
+  it 'should concatenate parameters' do
+    service = Khipu::KhipuService.new(1234, '1234')
+    params = service.concatenated(a: 1, b: 'foo', c: nil)
+    expect(params).to eq('a=1&b=foo&c=')
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require "khipu"

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: khipu
+version: !ruby/object:Gem::Version
+  version: 1.3.0
+platform: ruby
+authors:
+- Alex Lorca
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-04-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A wrapper for khipu's web API
+email:
+- alex.lorca@khipu.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- khipu.gemspec
+- lib/khipu.rb
+- lib/khipu/api_error.rb
+- lib/khipu/const.rb
+- lib/khipu/html_helper.rb
+- lib/khipu/khipu_api_endpoint.rb
+- lib/khipu/khipu_service.rb
+- lib/khipu/version.rb
+- spec/khipu_service_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/khipu/lib-ruby
+licenses:
+- BSD
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '1.9'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.7
+signing_key: 
+specification_version: 4
+summary: A wrapper for khipu's web API
+test_files:
+- spec/khipu_service_spec.rb
+- spec/spec_helper.rb