transbank-sdk 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 33b621b2e0a716808e5c98f3a76188d3816c094188e8e094f6b8b097b842687f
-  data.tar.gz: a88d80d79d4723224d988ccc258642efa8a4902c95535b2d1b3f8ead77948c2a
+  metadata.gz: 9c8e254a610d8744915cc56245533ad60f94a1c1a37c786c9eaefe458deaedb4
+  data.tar.gz: '029809591bbd27cdefc7a1dad7f5411f592387dddc430fc81c819fcde135031a'
 SHA512:
-  metadata.gz: 370f178eace68097e53e81dc271178235480213460d0ca7c81df213c4d3d6b705cfd143af4930fb8cf602069ac18a96317dd91e30400b88795689405b2ab6964
-  data.tar.gz: 2f6bc945ee3620294d750661ad91632f19bdbbb624d2182c34290ed6bf9662ed5f2bd8bfaf42037ac2e9da828a2b95254bafd756e5f213dbc5ba5072974f3399
+  metadata.gz: a0756ef91caee98a6d29c144c779650c788b31653758f0190a96746e6d63cdb4946fddbaf66bca329c4feb34f63288e0fd255d3bb2ba99b3c8f6fed61d5b445f
+  data.tar.gz: 33ffe901ec9592015658878761eed5b263cc6b955a7870c964092dae68f62f7965d062ea0a3415c0ee4306dd641eeb95f862748c506bdf77ca8583e8515084bb

data/.github/ISSUE_TEMPLATE/reporte-de-error.md

@@ -0,0 +1,40 @@
+---
+name: Reporte de Error
+about: Crea un reporte para ayudarnos a mejorar
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Describe el bug**
+
+Una descripción concisa sobre el bug.
+ 
+**Para reproducir**
+
+1. Configura '...'
+2. Crea un objeto '...'
+3. Ejecuta el método '...'
+4. Se ve el error en '...'
+
+**Comportamiento observado**
+
+Describe de forma concisa lo que observaste siguiendo los pasos para reproducir el error.
+
+**Comportamiento esperado**
+
+Una explicación concisa y clara de qué es lo que esperas que ocurra.
+
+**Capturas de pantalla**
+
+Si aplica, agrega aquí capturas de pantalla que ayuden a explicar tu problema.
+
+**Versiones (por favor agrega aquí la siguiente información):**
+- SDK: [e.g. 1.1.0]
+- Ruby: [e.g. 2.5.2]
+- Bundler: [e.g. 2.0.1]
+
+**Contexto adicional**
+
+Agrega cualquier otro información sobre el problema aquí.

data/.gitignore

@@ -6,9 +6,11 @@
 /pkg/
 /spec/reports/
 /tmp/
+/.DS_Store/
 .idea
 *.gem
 Gemfile.lock
 .built
 .bundled
-
+.rakeTasks
+.DS_Store

data/.travis.yml

@@ -6,3 +6,5 @@ deploy:
   on:
     tags: true
     repo: TransbankDevelopers/transbank-sdk-ruby
+rvm:
+  - 2.4.1

data/CHANGELOG.md

@@ -4,6 +4,10 @@ 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.2.0] - 2019-12-26
+### Added
+- Se agrega soporte para Oneclick Mall y Transacción Completa en sus versiones REST.
+
 ## [1.1.0] - 2018-04-08
 ### Added
 - Se agregaron los parámetros `qr_width_height` y `commerce_logo_url` a Options, para definir el tamaño del QR generado para la transacción, y especificar la ubicación del logo de comercio para ser mostrado en la aplicación móvil de Onepay. Puedes configurar estos parámetros globalmente o por transacción.

data/Makefile

@@ -12,7 +12,7 @@ build: .built .bundled
 	touch .built
 
 .bundled: Gemfile
-	docker-compose run --rm web bundle install
+	docker-compose run web bundle install
 	touch .bundled
 
 logs:

data/lib/transbank/sdk.rb

@@ -7,9 +7,10 @@ require 'base64'
 
 require "transbank/sdk/version"
 
+require 'transbank/sdk/transbank_error'
 require 'transbank/sdk/onepay/errors/errors'
 
-require 'transbank/sdk/onepay/utils/utils'
+require 'transbank/sdk/utils/utils'
 
 require 'transbank/sdk/onepay/requests/requests'
 require 'transbank/sdk/onepay/responses/responses'
@@ -17,7 +18,6 @@ require 'transbank/sdk/onepay/responses/responses'
 require 'transbank/sdk/onepay/models/models'
 require 'transbank/sdk/onepay/base'
 
-module Transbank
-  module Onepay
-  end
-end
+require 'transbank/sdk/oneclick/oneclick'
+
+require 'transbank/sdk/transaccion_completa/transaccion_completa'

data/lib/transbank/sdk/oneclick/errors/oneclick_error.rb

@@ -0,0 +1,16 @@
+module Transbank
+  module Webpay
+    module Oneclick
+      module Errors
+        class OneclickError < StandardError
+          attr_accessor :code, :message
+          def initialize(message, code)
+            @code = code
+            @message = message
+            super(message)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/transbank/sdk/oneclick/inscription/errors/mall_inscription_delete_error.rb

@@ -0,0 +1,16 @@
+module Transbank
+  module Webpay
+    module Oneclick
+      module Errors
+        class MallInscriptionDeleteError < OneclickError
+          attr_accessor :code, :message
+          def initialize(message, code)
+            @code = code
+            @message = message
+            super(message, code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/transbank/sdk/oneclick/inscription/errors/mall_inscription_finish_error.rb

@@ -0,0 +1,16 @@
+module Transbank
+  module Webpay
+    module Oneclick
+      module Errors
+        class MallInscriptionFinishError < OneclickError
+          attr_accessor :code, :message
+          def initialize(message, code)
+            @code = code
+            @message = message
+            super(message, code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/transbank/sdk/oneclick/inscription/errors/mall_inscription_start_error.rb

@@ -0,0 +1,16 @@
+module Transbank
+  module Webpay
+    module Oneclick
+      module Errors
+        class MallInscriptionStartError < OneclickError
+          attr_accessor :code, :message
+          def initialize(message, code)
+            @code = code
+            @message = message
+            super(message, code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/transbank/sdk/oneclick/inscription/errors/oneclick_mall_inscription_errors.rb

@@ -0,0 +1,3 @@
+require 'transbank/sdk/oneclick/inscription/errors/mall_inscription_delete_error'
+require 'transbank/sdk/oneclick/inscription/errors/mall_inscription_start_error'
+require 'transbank/sdk/oneclick/inscription/errors/mall_inscription_finish_error'

data/lib/transbank/sdk/oneclick/inscription/inscription.rb

@@ -0,0 +1,3 @@
+require 'transbank/sdk/oneclick/errors/oneclick_error'
+require 'transbank/sdk/oneclick/inscription/errors/oneclick_mall_inscription_errors'
+require 'transbank/sdk/oneclick/inscription/responses/oneclick_mall_inscription_responses'

data/lib/transbank/sdk/oneclick/inscription/responses/mall_inscription_delete_response.rb

@@ -0,0 +1,18 @@
+module Transbank
+  module Webpay
+    module Oneclick
+      class MallInscriptionDeleteResponse
+        attr_accessor :status, :code
+        def initialize(code)
+          code = code.to_i
+          @code = code
+          if code == 204
+            @status = 'OK'
+          elsif code == 404
+            @status = 'Not found'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/transbank/sdk/oneclick/inscription/responses/mall_inscription_finish_response.rb

@@ -0,0 +1,15 @@
+module Transbank
+  module Webpay
+    module Oneclick
+      class MallInscriptionFinishResponse
+        FIELDS = [:response_code, :tbk_user, :authorization_code,
+                  :card_type, :card_number]
+        attr_accessor *FIELDS
+        def initialize(json)
+          FIELDS.each {|field| send("#{field}=", json["#{field}"]) }
+        end
+      end
+    end
+  end
+end
+

data/lib/transbank/sdk/oneclick/inscription/responses/mall_inscription_start_response.rb

@@ -0,0 +1,14 @@
+module Transbank
+  module Webpay
+    module Oneclick
+      class MallInscriptionStartResponse
+        attr_accessor :token, :url_webpay
+
+        def initialize(json)
+          @token = json['token']
+          @url_webpay = json['url_webpay']
+        end
+      end
+    end
+  end
+end

data/lib/transbank/sdk/oneclick/inscription/responses/oneclick_mall_inscription_responses.rb

@@ -0,0 +1,3 @@
+require 'transbank/sdk/oneclick/inscription/responses/mall_inscription_delete_response'
+require 'transbank/sdk/oneclick/inscription/responses/mall_inscription_start_response'
+require 'transbank/sdk/oneclick/inscription/responses/mall_inscription_finish_response'

data/lib/transbank/sdk/oneclick/mall/base.rb

@@ -0,0 +1,51 @@
+module Transbank
+  module Webpay
+    module Oneclick
+      class Base
+        DEFAULT_API_KEY = '579B532A7440BB0C9079DED94D31EA1615BACEB56610332264630D42D0A36B1C'.freeze
+
+        DEFAULT_ONECLICK_MALL_COMMERCE_CODE = '597055555541'.freeze
+        DEFAULT_ONECLICK_MALL_CHILD_COMMERCE_CODES = ['597055555542'.freeze,
+                                                      '597055555543'.freeze].freeze
+
+        @api_key = DEFAULT_API_KEY
+        @commerce_code = DEFAULT_ONECLICK_MALL_COMMERCE_CODE
+        @integration_type = :TEST
+        @integration_types = {
+          LIVE: "https://webpay3g.transbank.cl/",
+          TEST: "https://webpay3gint.transbank.cl/"
+        }
+
+        class << self
+          attr_reader :integration_types
+          attr_accessor :api_key, :integration_type, :commerce_code
+
+          def integration_type_url(integration_type)
+            type = integration_type.upcase.to_sym
+            return @integration_types[type] unless @integration_types[type].nil?
+            valid_values = @integration_types.keys.join(', ')
+            raise Transbank::Webpay::Errors::IntegrationTypeError, "Invalid integration type, valid values are #{valid_values}"
+          end
+
+          def current_integration_type_url
+            @integration_types[@integration_type]
+          end
+
+          def integration_type=(integration_type)
+            type = integration_type.upcase.to_sym
+            return @integration_type = type unless @integration_types[type].nil?
+            valid_values = @integration_types.keys.join(', ')
+            raise Transbank::Webpay::Errors::IntegrationTypeError, "Invalid integration type, valid values are #{valid_values}"
+          end
+
+          def configure_mall_for_testing
+            @api_key = DEFAULT_API_KEY
+            @commerce_code = DEFAULT_ONECLICK_MALL_COMMERCE_CODE
+            self.integration_type = :TEST
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/transbank/sdk/oneclick/mall/errors/mall_transaction_authorize_error.rb

@@ -0,0 +1,16 @@
+module Transbank
+  module Webpay
+    module Oneclick
+      module Errors
+        class MallTransactionAuthorizeError < OneclickError
+          attr_accessor :code, :message
+          def initialize(message, code)
+            @code = code
+            @message = message
+            super(message, code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/transbank/sdk/oneclick/mall/errors/mall_transaction_refund_error.rb

@@ -0,0 +1,16 @@
+module Transbank
+  module Webpay
+    module Oneclick
+      module Errors
+        class MallTransactionRefundError < OneclickError
+          attr_accessor :code, :message
+          def initialize(message, code)
+            @code = code
+            @message = message
+            super(message, code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/transbank/sdk/oneclick/mall/errors/mall_transaction_status_error.rb

@@ -0,0 +1,16 @@
+module Transbank
+  module Webpay
+    module Oneclick
+      module Errors
+        class MallTransactionStatusError < OneclickError
+          attr_accessor :code, :message
+          def initialize(message, code)
+            @code = code
+            @message = message
+            super(message, code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/transbank/sdk/oneclick/mall/errors/oneclick_mall_errors.rb

@@ -0,0 +1,3 @@
+require 'transbank/sdk/oneclick/mall/errors/mall_transaction_authorize_error'
+require 'transbank/sdk/oneclick/mall/errors/mall_transaction_status_error'
+require 'transbank/sdk/oneclick/mall/errors/mall_transaction_refund_error'

data/lib/transbank/sdk/oneclick/mall/mall_inscription.rb

@@ -0,0 +1,73 @@
+module Transbank
+  module Webpay
+    module Oneclick
+      class MallInscription
+        extend Transbank::Utils::NetHelper
+        
+        INSCRIPTION_START_ENDPOINT = 'rswebpaytransaction/api/oneclick/v1.0/inscriptions'.freeze
+        INSCRIPTION_FINISH_ENDPOINT = 'rswebpaytransaction/api/oneclick/v1.0/inscriptions/:token'.freeze
+        INSCRIPTION_DELETE_ENDPOINT = 'rswebpaytransaction/api/oneclick/v1.0/inscriptions'.freeze
+        class << self
+          def start(user_name:, email:, response_url:, options: nil)
+            api_key = options&.api_key || default_integration_params[:api_key]
+            commerce_code = options&.commerce_code || default_integration_params[:commerce_code]
+            integration_type = options&.integration_type || default_integration_params[:integration_type]
+            base_url = integration_type.nil? ? Oneclick::Base::integration_type[:TEST] : Oneclick::Base.integration_type_url(integration_type)
+
+            url = base_url + INSCRIPTION_START_ENDPOINT
+            headers = webpay_headers(commerce_code: commerce_code, api_key: api_key)
+
+            body = {
+              username: user_name,
+              email: email,
+              response_url: response_url
+            }
+            resp = http_post(uri_string: url, body: body, headers: headers, camel_case_keys: false)
+            body = JSON.parse(resp.body)
+            return ::Transbank::Webpay::Oneclick::MallInscriptionStartResponse.new(body) if resp.kind_of? Net::HTTPSuccess
+            raise Oneclick::Errors::MallInscriptionStartError.new(body['error_message'], resp.code)
+          end
+
+          def finish(token:, options: nil)
+            api_key = options&.api_key || default_integration_params[:api_key]
+            commerce_code = options&.commerce_code || default_integration_params[:commerce_code]
+            integration_type = options&.integration_type || default_integration_params[:integration_type]
+            base_url = integration_type.nil? ? Oneclick::Base::integration_type[:TEST] : Oneclick::Base.integration_type_url(integration_type)
+
+            url = base_url + INSCRIPTION_FINISH_ENDPOINT.gsub(':token', token)
+            headers = webpay_headers(commerce_code: commerce_code, api_key: api_key)
+
+            resp = http_put(uri_string: url, headers: headers)
+            body = JSON.parse(resp.body)
+            return ::Transbank::Webpay::Oneclick::MallInscriptionFinishResponse.new(body) if resp.kind_of? Net::HTTPSuccess
+            raise Oneclick::Errors::MallInscriptionFinishError.new(body['error_message'], resp.code)
+          end
+
+          def delete(tbk_user:, user_name:, options: nil)
+            api_key = options&.api_key || default_integration_params[:api_key]
+            commerce_code = options&.commerce_code || default_integration_params[:commerce_code]
+            integration_type = options&.integration_type || default_integration_params[:integration_type]
+            base_url = integration_type.nil? ? Oneclick::Base::integration_type[:TEST] : Oneclick::Base.integration_type_url(integration_type)
+
+            url = base_url + INSCRIPTION_DELETE_ENDPOINT
+            headers = webpay_headers(commerce_code: commerce_code, api_key: api_key)
+            body = {tbk_user: tbk_user, username: user_name}
+            resp = http_delete(uri_string: url, body: body, headers: headers)
+            code = resp.code
+            return ::Transbank::Webpay::Oneclick::MallInscriptionDeleteResponse.new(code) if resp.kind_of? Net::HTTPSuccess
+            raise Oneclick::Errors::MallInscriptionDeleteError.new(body['error_message'], resp.code)
+          end
+
+          def default_integration_params
+            {
+              api_key: Oneclick::Base::DEFAULT_API_KEY,
+              commerce_code: Oneclick::Base::DEFAULT_ONECLICK_MALL_COMMERCE_CODE,
+              integration_type: Oneclick::Base::integration_type,
+              base_url: Oneclick::Base::current_integration_type_url
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/transbank/sdk/oneclick/mall/mall_transaction.rb

@@ -0,0 +1,97 @@
+module Transbank
+  module Webpay
+    module Oneclick
+      class MallTransaction
+        extend Transbank::Utils::NetHelper
+
+        AUTHORIZE_TRANSACTION_ENDPOINT = 'rswebpaytransaction/api/oneclick/v1.0/transactions'.freeze
+        TRANSACTION_STATUS_ENDPOINT = 'rswebpaytransaction/api/oneclick/v1.0/transactions/:buy_order'.freeze
+        TRANSACTION_REFUND_ENDPOINT = 'rswebpaytransaction/api/oneclick/v1.0/transactions/:buy_order/refunds'.freeze
+
+        class << self
+
+          def authorize(username:, tbk_user:, parent_buy_order:, details:,
+                        options: nil)
+            api_key = options&.api_key || default_integration_params[:api_key]
+            commerce_code = options&.commerce_code || default_integration_params[:commerce_code]
+            integration_type = options&.integration_type || default_integration_params[:integration_type]
+            base_url = integration_type.nil? ? Oneclick::Base::integration_type[:TEST] : Oneclick::Base.integration_type_url(integration_type)
+
+            url = base_url + AUTHORIZE_TRANSACTION_ENDPOINT
+            headers = webpay_headers(commerce_code: commerce_code, api_key: api_key)
+
+            details_array = details.map do |det|
+              hash = det.reduce({}) do |acc, (k, v)|
+                acc[k.to_s] = v
+                acc
+              end
+              # We need to make sure the hash's keys are strings (or symbols)
+              # since Ruby doesnt have hahes with indifferent access
+              # I chose to make them strings
+              details_hash = {}
+              details_hash[:amount] = hash.fetch('amount')
+              details_hash[:buy_order] = hash.fetch('buy_order')
+              details_hash[:commerce_code] = hash.fetch('commerce_code')
+              details_hash[:installments_number] = hash.fetch('installments_number')
+              details_hash
+            end
+
+            body = {
+              username: username,
+              tbk_user: tbk_user,
+              buy_order: parent_buy_order,
+              details: details_array
+            }
+            resp = http_post(uri_string: url, body: body, headers: headers, camel_case_keys: false)
+            body = JSON.parse(resp.body)
+            return ::Transbank::Webpay::Oneclick::MallTransactionAuthorizeResponse.new(body) if resp.kind_of? Net::HTTPSuccess
+            raise Oneclick::Errors::MallTransactionAuthorizeError.new(body['error_message'], resp.code)
+          end
+
+          def status(buy_order:, options: nil)
+            api_key = options&.api_key || default_integration_params[:api_key]
+            commerce_code = options&.commerce_code || default_integration_params[:commerce_code]
+            integration_type = options&.integration_type || default_integration_params[:integration_type]
+            base_url = integration_type.nil? ? Oneclick::Base::integration_type[:TEST] : Oneclick::Base.integration_type_url(integration_type)
+
+            url = base_url + TRANSACTION_STATUS_ENDPOINT.gsub(':buy_order', buy_order)
+            headers = webpay_headers(commerce_code: commerce_code, api_key: api_key)
+            resp = http_get(uri_string: url, headers: headers)
+            body = JSON.parse(resp.body)
+            return ::Transbank::Webpay::Oneclick::MallTransactionStatusResponse.new(body) if resp.kind_of? Net::HTTPSuccess
+            raise Oneclick::Errors::MallTransactionStatusError.new(body['error_message'], resp.code)
+          end
+
+          def refund(buy_order:, child_commerce_code:, child_buy_order:, amount:,
+                     options: nil)
+            api_key = options&.api_key || default_integration_params[:api_key]
+            commerce_code = options&.commerce_code || default_integration_params[:commerce_code]
+            integration_type = options&.integration_type || default_integration_params[:integration_type]
+            base_url = integration_type.nil? ? Oneclick::Base::integration_type[:TEST] : Oneclick::Base.integration_type_url(integration_type)
+
+            url = base_url + TRANSACTION_REFUND_ENDPOINT.gsub(':buy_order', buy_order)
+            headers = webpay_headers(commerce_code: commerce_code, api_key: api_key)
+            body = {
+              detail_buy_order: child_buy_order,
+              commerce_code: child_commerce_code,
+              amount: amount
+            }
+            resp = http_post(uri_string: url, body: body, headers: headers, camel_case_keys: false)
+            body = JSON.parse(resp.body)
+            return ::Transbank::Webpay::Oneclick::MallTransactionRefundResponse.new(body) if resp.kind_of? Net::HTTPSuccess
+            raise Oneclick::Errors::MallTransactionRefundError.new(body['error_message'], resp.code)
+          end
+
+          def default_integration_params
+            {
+              api_key: Oneclick::Base::DEFAULT_API_KEY,
+              commerce_code: Oneclick::Base::DEFAULT_ONECLICK_MALL_COMMERCE_CODE,
+              integration_type: Oneclick::Base::integration_type,
+              base_url: Oneclick::Base::current_integration_type_url
+            }
+          end
+        end
+      end
+    end
+  end
+end