transbank-sdk 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 89626d07ac2ab60c173d5559dbf0f80354f50a8d48ae376c49ed501c62bf2665
+  data.tar.gz: f06c90d4fda0552b151b386ac51ae8459a320200e71f99e31d09c9964153b51a
+SHA512:
+  metadata.gz: a05375ec1dd0bf1add539335e9ea9adc74a86b52241ddfe25504aaaee53fe5d12402665045939ac3eb34c04ffeb158add6c1841eba115d7c33414cf5c8c0ae89
+  data.tar.gz: 85810e803d04a8c12d15cbcd7cdca8814cd897cc4e2f5e5ee515d08a927fca3d894fbb0cc0a13241c20d62e943330a4c33043536d7d7c99bfccfb606cb4474b3

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+.idea
+*.gem
+Gemfile.lock
+.built
+.bundled
+

data/.travis.yml

@@ -0,0 +1,8 @@
+deploy:
+  provider: rubygems
+  api_key:
+    secure: DrUEm8pAjKtSekGBZz9/dMK92CSj2J+Zi1KOMLdDMckD4UCifusmbyqsp+RWAYBX1fWREyjMW0VvaPgj2eYOEaQrr6+TmygQMel1sFKSC6pOMVHQ3NMPwacVG5rGlNlK5+1PuNyR/ZGwtIdWkHe8+g9CvlvliNdY5KYtVs0pnwGUOMeQAwuIgM/w7uSm67zL7M3pYqEArU73EoX9puUS+k6aQ+KtxBckpqi7GtA5+42F8kTvEg+Y0h385qOvnQhjwepYh6YvfTeyzxc5fqFiBlO4TZp4rCoCpEeY1XO1VBCip+aGe5FVoWJrWkYONWdKV4GGzQd0Kd2Jmis4ieBDoi1julUK+uudy3CcjT3pSvSl6NyEpkUDJrJLZ9vn5P5SRJrUsWPDpkun5TptOnc1W1lgyJRypM47BbJ/qRzSr279iQmbvkEMci132Vp3v1Q17zDzBAyI13jirxNN4aw/PB0UCG7XRxqfEhnN391p1QVjB5u24G8r+gxABrJQA0WroKvQACstHd160wFWHxb57kSTaD32j3dzIbT+IdylF0ENmGQCohhUjwZt9ldv5cdQOyq0Jhsu9j8T/VzSRc52n1by1JQgl4nu4b7pmmNbfsEL6P13+m93TyKQiK0tr4CgdzF2XrY/bBJxoMvUTd2To4X77IRMayjkoZWEOT2RzrA=
+  gem: transbank-sdk
+  on:
+    tags: true
+    repo: TransbankDevelopers/transbank-sdk-ruby

data/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+Todos los cambios notables a este proyecto serán documentados en este archivo.
+
+El formato está basado en [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
+y este proyecto adhiere a [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+
+## [1.0.1]
+### Fixed
+- Cambios para subir automáticamente la gema a RubyGems cuando se hace un nuevo release
+
+## [1.0.0] - 2018-10-23
+### Added
+- Primer lanzamiento del SDK

data/Dockerfile

@@ -0,0 +1,6 @@
+FROM ruby:2.2-jessie
+RUN apt-get update && apt-get install
+RUN gem install bundler
+RUN mkdir -p /sdk
+WORKDIR /sdk
+COPY . /sdk

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 transbank-sdk.gemspec
+gemspec

data/LICENSE.md

@@ -0,0 +1,11 @@
+Copyright 2018 Transbank
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+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.
+
+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/Makefile

@@ -0,0 +1,24 @@
+SHELL := /bin/bash
+
+all: build run
+
+run: build
+	docker-compose run --rm web
+
+build: .built .bundled
+
+.built: Dockerfile
+	docker-compose build
+	touch .built
+
+.bundled: Gemfile Gemfile.lock
+	docker-compose run --rm web bundle install
+	touch .bundled
+
+logs:
+	docker-compose logs
+
+clean:
+	docker-compose rm
+	rm .built
+	rm .bundled

data/README.md

@@ -0,0 +1,87 @@
+# Transbank SDK Ruby
+
+SDK Oficial de Transbank
+
+## Requisitos:
+
+- Ruby 2.2+
+
+# Instalación
+
+Puedes instalar el SDK directamente
+```bash
+gem install transbank-sdk
+```
+
+o añadirlo a tu `Gemfile`
+```ruby
+gem 'transbank-sdk'
+```
+y luego ejecutar
+```bash
+bundle install
+```
+## Documentación 
+
+Puedes encontrar toda la documentación de cómo usar este SDK en el sitio https://www.transbankdevelopers.cl.
+
+Actualmente este SDK contiene sólo Onepay.
+
+La documentación relevante para usar este SDK es:
+
+- Documentación general sobre [Onepay](https://www.transbankdevelopers.cl/producto/onepay).
+- Documentación sobre [ambientes, deberes del comercio, puesta en producción,
+  etc](https://www.transbankdevelopers.cl/documentacion/como_empezar#ambientes).
+- Referencia detallada sobre [Onepay](https://www.transbankdevelopers.cl/referencia/onepay).
+
+## Información para contribuir y desarrollar este SDK
+
+### Requerimientos
+- Docker
+- Make
+- Plugin de editorconfig para tu editor favorito.
+
+### Standares
+
+- Para los commits respetamos las siguientes normas: https://chris.beams.io/posts/git-commit/
+- Usamos ingles, para los mensajes de commit.
+- Se pueden usar tokens como WIP, en el subject de un commit, separando el token con `:`, por ejemplo:
+`WIP: This is a useful commit message`
+- Para los nombres de ramas también usamos ingles.
+- Se asume, que una rama de feature no mezclada, es un feature no terminado.
+- El nombre de las ramas va en minúsculas.
+- Las palabras se separan con `-`.
+- Las ramas comienzan con alguno de los short lead tokens definidos, por ejemplo: `feat/tokens-configuration`
+
+#### Short lead tokens
+##### Commits
+- WIP = Trabajo en progreso.
+##### Ramas
+- feat = Nuevos features
+- chore = Tareas, que no son visibles al usuario.
+- bug = Resolución de bugs.
+
+### Todas las mezclas a master se hacen mediante Pull Request.
+
+### Test
+Primero y solamente una vez para instalar gemas debes usar el siguiente comando en una terminal.
+```bash
+make build
+```
+
+Para ejecutar los test localmente debes usar el siguiente comando en una terminal.
+```bash
+make
+```
+
+### Deploy de una nueva versión.
+Para generar una nueva versión, se debe crear un PR (con un título "Prepare release X.Y.Z" con los valores que correspondan para X, Y y Z). Se debe seguir el estándar semver para determinar si se incrementa el valor de X (si hay cambios no retrocompatibles), Y (para mejoras retrocompatibles) o Z (si sólo hubo correcciones a bugs).
+
+En ese PR deben incluirse los siguientes cambios:
+
+Modificar el archivo CHANGELOG.md para incluir una nueva entrada (al comienzo) para X.Y.Z que explique en español los cambios de cara al usuario del SDK.
+Modificar este README.md para que los ejemplos usen la nueva versión X.Y.Z
+
+Luego de obtener aprobación del pull request, debe mezclarse a master e inmediatamente generar un release en GitHub con el tag vX.Y.Z. En la descripción del release debes poner lo mismo que agregaste al changelog.
+
+Con eso Travis CI generará automáticamente una nueva versión de la librería y la publicará en RubyGems.

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "transbank/sdk"
+
+# 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/docker-compose.yml

@@ -0,0 +1,20 @@
+version: '2'
+services:
+  web: &web
+    tty: true
+    stdin_open: true
+    build:
+      context: .
+      dockerfile: Dockerfile
+    command: rake test
+    volumes:
+    - .:/sdk
+    volumes_from:
+      - bundle_cache
+    ports:
+    - "8000:8000"
+
+  bundle_cache:
+    image: ruby:2.2-jessie # Should be the same as the app Dockerfile.dev base image
+    volumes:
+    - /usr/local/bundle

data/lib/transbank/sdk.rb

@@ -0,0 +1,23 @@
+require 'uri'
+require 'net/http'
+require 'json'
+require 'openssl'
+require 'base64'
+
+
+require "transbank/sdk/version"
+
+require 'transbank/sdk/onepay/errors/errors'
+
+require 'transbank/sdk/onepay/utils/utils'
+
+require 'transbank/sdk/onepay/requests/requests'
+require 'transbank/sdk/onepay/responses/responses'
+
+require 'transbank/sdk/onepay/models/models'
+require 'transbank/sdk/onepay/base'
+
+module Transbank
+  module Onepay
+  end
+end

data/lib/transbank/sdk/onepay/base.rb

@@ -0,0 +1,115 @@
+module Transbank
+  module Onepay
+    class Base
+      #  The base class for Transbank Onepay
+      DEFAULT_CALLBACK = "http://no.callback.has/been.set".freeze
+      DEFAULT_API_KEY = 'dKVhq1WGt_XapIYirTXNyUKoWTDFfxaEV63-O5jcsdw'.freeze
+      DEFAULT_SHARED_SECRET = '?XW#WOLG##FBAGEAYSNQ5APD#JF@$AYZ'.freeze
+
+      @app_keys = {TEST: '1a0c0639-bd2f-4846-8d26-81f43187e797',
+                   LIVE: '2B571C49-C1B6-4AD1-9806-592AC68023B7',
+                   MOCK: '04533c31-fe7e-43ed-bbc4-1c8ab1538afp'}.freeze
+      @integration_types = {TEST: 'https://onepay.ionix.cl'.freeze,
+                            LIVE: 'https://www.onepay.cl'.freeze,
+                            MOCK: 'https://transbank-onepay-ewallet-mock.herokuapp.com'.freeze}.freeze
+      @callback_url = self::DEFAULT_CALLBACK
+      @api_key = ENV['ONEPAY_API_KEY'].nil? ? DEFAULT_API_KEY : ENV['ONEPAY_API_KEY']
+      @shared_secret = ENV['ONEPAY_SHARED_SECRET'].nil? ? DEFAULT_SHARED_SECRET : ENV['ONEPAY_SHARED_SECRET']
+
+      @integration_type = :TEST
+      @app_scheme = nil
+      @default_channel = Transbank::Onepay::Channel::WEB
+
+      class << self
+        # Contains all valid integration types
+        # @return [Hash<String, String>]
+        attr_reader :integration_types
+
+        # Your Api key, given by Transbank
+        # @return [String]
+        attr_writer :api_key
+
+        # Your callback URL, used to resume the payment process after validating with
+        # Transbank when paying on Channel::MOBILE
+        # @param [String]
+        # @return [String]
+        attr_accessor :callback_url
+
+        # Your shared secret, given by Transbank
+        # @param [String]
+        # @return [String]
+        attr_writer :shared_secret
+
+        # The current integration type
+        # @param [String, Symbol]
+        # @return [Symbol]
+        attr_reader :integration_type
+
+        # The URI for the app (eg the Android Intent that starts the app/the iOS
+        # equivalent)
+        # @param [String]
+        # @return [String]
+        attr_writer :app_scheme
+
+        # The default channel. Value must be in Channel.values
+        # @return [String] One of the values from Channel.values
+        attr_reader :default_channel
+
+        # @return [String] the URL that is used by the current integration type
+        def current_integration_type_url
+          @integration_types[@integration_type]
+        end
+
+        # @return [String] the app key used by the current integration type
+        def current_integration_type_app_key
+          @app_keys[@integration_type]
+        end
+
+        # Sets the current integration type
+        # @param type [String] Type of integration to be set. Must be included one
+        # of the keys of self.integration_types
+        # @raise [IntegrationTypeError] if the given type is not valid
+        def integration_type=(type)
+          return @integration_type = type.to_sym unless @integration_types[type.to_sym].nil?
+          valid_values = @integration_types.keys.join(', ')
+          raise Transbank::Onepay::Errors::IntegrationTypeError, "Invalid integration type, valid values are #{valid_values}"
+        end
+
+        # Returns the app_scheme
+        # @return [String] the app scheme, either the one set on @app_scheme or,
+        # failing that, the value of ENV['ONEPAY_APP_SCHEME'] (your env variable)
+        def app_scheme
+          return ENV['ONEPAY_APP_SCHEME'] unless @app_scheme
+          @app_scheme
+        end
+
+        def api_key
+          return ENV['ONEPAY_API_KEY'] if @api_key.nil?
+          @api_key
+        end
+
+        # Returns the 'ONEPAY_API_KEY' env variable, or, if ONEPAY_API_KEY
+        # doesn't exist, returns a default api key
+        # @return [String] ENV['ONEPAY_API_KEY] or DEFAULT_API_KEY
+        def default_api_key
+          env_api_key = ENV['ONEPAY_API_KEY']
+          env_api_key.nil? ? DEFAULT_API_KEY : env_api_key
+        end
+
+        def shared_secret
+          return ENV['ONEPAY_SHARED_SECRET'] if @shared_secret.nil?
+          @shared_secret
+        end
+
+        # Returns the 'ONEPAY_SHARED_SECRET' env variable, or, if ONEPAY_SHARED_SECRET
+        # doesn't exist, returns a default shared secret
+        # @return [String] ENV['ONEPAY_SHARED_SECRET'] or DEFAULT_SHARED_SECRET
+        def default_shared_secret
+          env_shared_secret = ENV['ONEPAY_SHARED_SECRET']
+          env_shared_secret.nil? ? DEFAULT_SHARED_SECRET : env_shared_secret
+        end
+      end
+
+    end
+  end
+end

data/lib/transbank/sdk/onepay/errors/errors.rb

@@ -0,0 +1,17 @@
+require 'transbank/sdk/onepay/errors/transbank_error'
+require 'transbank/sdk/onepay/errors/integration_type_error'
+require 'transbank/sdk/onepay/errors/invalid_options_error'
+require 'transbank/sdk/onepay/errors/item_error'
+require 'transbank/sdk/onepay/errors/refund_create_error'
+require 'transbank/sdk/onepay/errors/response_error'
+require 'transbank/sdk/onepay/errors/shopping_cart_error'
+require 'transbank/sdk/onepay/errors/signature_error'
+require 'transbank/sdk/onepay/errors/transaction_commit_error'
+require 'transbank/sdk/onepay/errors/transaction_create_error'
+
+module Transbank
+  module Onepay
+    module Errors
+    end
+  end
+end

data/lib/transbank/sdk/onepay/errors/integration_type_error.rb

@@ -0,0 +1,8 @@
+module Transbank
+  module Onepay
+    module Errors
+      class IntegrationTypeError < TransbankError
+      end
+    end
+  end
+end

data/lib/transbank/sdk/onepay/errors/invalid_options_error.rb

@@ -0,0 +1,8 @@
+module Transbank
+  module Onepay
+    module Errors
+      class InvalidOptionsError < TransbankError
+      end
+    end
+  end
+end

data/lib/transbank/sdk/onepay/errors/item_error.rb

@@ -0,0 +1,8 @@
+module Transbank
+  module Onepay
+    module Errors
+      class ItemError < TransbankError
+      end
+    end
+  end
+end

data/lib/transbank/sdk/onepay/errors/refund_create_error.rb

@@ -0,0 +1,8 @@
+module Transbank
+  module Onepay
+    module Errors
+      class RefundCreateError < TransbankError
+      end
+    end
+  end
+end