superpay_api 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e19b66538456ae34eae4448a9f6acdd191f64389
+  data.tar.gz: 6884549fdd974f9924224cd4c7011dada8c0f9d9
+SHA512:
+  metadata.gz: 6e7752e4f932db0033ddf6fb7685d32558b2df4ddd0c2e9b068d25ed5430e345aeab6b545d26ea13d804c2a64a56f4bcedb9c11613e410d1ef5f23b27e41086d
+  data.tar.gz: c5eac64d290bfa1598d0d50899a73cc94b63d94bcf679549d48bcf6ec590919184a363db497f828a58463869f8b7d707462cd573296d1fc404b4f4da9f6b82af

data/lib/superpay_api/configuracao.rb

@@ -0,0 +1,171 @@
+# -*- encoding : utf-8 -*-
+module SuperpayApi
+  module Configuracao
+
+    # Endereço do wsdl funções:
+    # [Criar Transação pagamentoTransacaoCompleta, Capturar operacaoTransacao, Cancelar operacaoTransacao, Consultar consultaTransacaoEspecifica]
+    # [Estornar estornaTransacao] - Estorno
+    URL = {
+      :homologacao          => "https://homologacao.superpay.com.br/superpay/servicosPagamentoCompletoWS.Services?wsdl",
+      :homologacao_estorno  => "https://homologacao.superpay.com.br/superpay/servicosEstornoWS.Services?wsdl",
+      :producao             => "https://superpay2.superpay.com.br/checkout/servicosPagamentoCompletoWS.Services?wsdl",
+      :producao_estorno     => "https://superpay2.superpay.com.br/checkout/servicosEstornoWS.Services?wsdl",
+    }
+
+    # Opções de idiomas
+    IDIOMAS = {
+      :portugues  => 1,
+      :ingles     => 2,
+      :espanhol   => 3,
+    }
+
+    # Opções de Origem da Transação
+    # Consulte área de suporte sobre a habilitação das origens
+    ORIGEM_DA_TRANSACAO ={
+      :ecommerce  => 1,
+      :mobile     => 2,
+      :ura        => 3,
+      :pos        => 4,
+    }
+
+    # Retornar array com os possíveis idiomas
+    def self.validos
+      IDIOMAS.map{ |key, value| key }
+    end
+
+    # Retornar array com as possíveis Origem da Transação
+    def self.origem_da_transacao_validos
+      ORIGEM_DA_TRANSACAO.map{ |key, value| key }
+    end
+
+    # Parâmetros iniciais
+    URL_CAMPAINHA      = 'http://localhost:3000'
+    # Parâmetros iniciais
+    IDIOMA             = :portugues
+    # Parâmetros iniciais
+    ORIGEM_TRANSACAO   = :ecommerce
+    # Parâmetros iniciais
+    AMBIENTE           = :homologacao # :homologacao ou :producao
+    # Parâmetros iniciais
+    USUARIO            = 'superpay'
+    # Parâmetros iniciais
+    SENHA              = 'superpay'
+    # Parâmetros iniciais
+    ESTABELECIMENTO    = 1010101010101010
+
+    # Define o ambiente de trabalho
+    # Simbolo - Valores pré-definidos [:homologacao, :producao]
+    attr_writer :ambiente
+
+    # Código que identifica o estabelecimento dentro do SuperPay (fornecido pelo gateway)
+    # Enviado pelo SuperPay
+    attr_writer :estabelecimento
+
+    # URL será sempre acionada quando o status do pedido mudar. Deve estar preparada para receber dados de campainha
+    # Alfa Numérico - Até 250 caracteres
+    attr_writer :url_campainha
+
+    # Código do idioma. Ver tabela “Idiomas”
+    # Simbolo - Valores pré-definidos
+    attr_writer :idioma
+
+    # Código do ambiente de origem. Verificar tabela “Ambientes de Origem”
+    # Simbolo - Valores pré-definidos
+    attr_writer :origem_transacao
+
+    # Enviado pelo SuperPay
+    attr_writer :usuario
+
+    # Enviado pelo SuperPay
+    attr_writer :senha
+
+    # Comando que recebe as configuracoes
+    def configure
+      yield self if block_given?
+    end
+
+    # Definir ambiente
+    def ambiente
+      @ambiente ||= AMBIENTE
+    end
+
+    # Definir url_campainha
+    def url_campainha
+      @url_campainha ||= URL_CAMPAINHA
+    end
+
+    # Definir idioma
+    def idioma
+      @idioma ||= IDIOMA
+    end
+
+    # Definir origem_transacao
+    def origem_transacao
+      @origem_transacao ||= ORIGEM_TRANSACAO
+    end
+
+    # Definir usuario
+    def usuario
+      @usuario ||= USUARIO
+    end
+
+    # Definir senha
+    def senha
+      @senha ||= SENHA
+    end
+
+    # Definir estabelecimento
+    def estabelecimento
+      @estabelecimento ||= ESTABELECIMENTO
+    end
+
+    # Montar o Hash de Login no padrão utilizado pelo SuperPay
+    def login
+      login = {
+        usuario: usuario.to_s,
+        senha: senha.to_s,
+      }
+      return login
+    end
+
+    # Retornar o número do idioma no padrão utilizado pelo SuperPay
+    def idiomas_to_request
+      IDIOMAS[self.idioma].to_i
+    end
+
+    # Retornar o número da origem da transacao no padrão utilizado pelo SuperPay
+    def origem_da_transacao_to_request
+      ORIGEM_DA_TRANSACAO[self.origem_transacao].to_i
+    end
+
+    # Montar o Hash de configurações no padrão utilizado pelo SuperPay
+    def configuracoes_to_request
+      configuracoes = {
+        codigo_estabelecimento:   self.estabelecimento.to_i,
+        url_campainha:            self.url_campainha.to_s,
+        idioma:                   self.idiomas_to_request,
+        origem_transacao:         self.origem_da_transacao_to_request,
+      }
+      return configuracoes
+    end
+
+    # Retornar a url conforme o ambiente
+    def url
+      if ambiente == :producao
+        SuperpayApi::Configuracao::URL[:producao]
+      else
+        SuperpayApi::Configuracao::URL[:homologacao]
+      end
+    end
+
+    # Retornar a url conforme o ambiente
+    def url_estorno
+      if ambiente == :producao
+        SuperpayApi::Configuracao::URL[:producao_estorno]
+      else
+        SuperpayApi::Configuracao::URL[:homologacao_estorno]
+      end
+    end
+
+  end
+end

data/lib/superpay_api/dados_usuario.rb

@@ -0,0 +1,144 @@
+# -*- encoding : utf-8 -*-
+module SuperpayApi
+  class DadosUsuario
+
+    # Opções de Sexo
+    SEXO = {
+      :masculino  => "M",
+      :feminino   => "F",
+    }
+
+    # Opções de Tipo de Cliente
+    TIPOS_DE_CLIENTE = {
+      :pessoa_fisica    => 1,
+      :pessoa_juridica  => 2,
+    }
+
+    # Código que identifica o cliente no estabelecimento.
+    # Alfa Numérico - Até 20 caracteres
+    attr_accessor :codigo_cliente
+
+    # Identifica se o cliente é pessoa física ou jurídica. Ver tabela “Tipo Cliente”
+    # Simbolo - Valores pré-definidos [:pessoa_fisica, :pessoa_juridica]
+    attr_accessor :tipo_cliente
+
+    # Nome do comprador
+    # Alfa Numérico - Até 100 caracteres
+    attr_accessor :nome
+
+    # E-mail do comprador
+    # Alfa Numérico - Até 100 caracteres
+    attr_accessor :email
+
+    # Documento principal do comprador
+    # Alfa Numérico - Até 30 caracteres
+    attr_accessor :documento
+
+    # Documento complementar do comprador
+    # Alfa Numérico - Até 30 caracteres
+    attr_accessor :documento_2
+
+    # M – Masculino / F – Feminino
+    # Simbolo - Valores pré-definidos [:masculino, :feminino]
+    attr_accessor :sexo
+
+    # Data de nascimento do comprador. Formato dd/mm/yyyy
+    # Alfa Numérico - Até 10 caracteres
+    attr_accessor :data_nascimento
+
+    # Endereços
+    # SuperpayApi::Endereco
+    attr_accessor :endereco_comprador, :endereco_entrega
+
+    # Telefones
+    # SuperpayApi::Telefone
+    attr_accessor :telefone_comprador, :telefone_adicional_comprador, :telefone_entrega, :telefone_adicional_entrega
+
+    # Validações do Rails 3
+    include ActiveModel::Validations
+
+    # Retornar array com os possíveis sexos
+    def self.sexos_validos
+      SEXO.map{ |key, value| key }
+    end
+
+    # Retornar array com os possíveis tipos de cliente
+    def self.tipos_de_cliente_validos
+      TIPOS_DE_CLIENTE.map{ |key, value| key }
+    end
+
+    # Validações
+    validates :sexo, inclusion: { in: SuperpayApi::DadosUsuario.sexos_validos }, allow_nil: true
+    validates :tipo_cliente, inclusion: { in: SuperpayApi::DadosUsuario.tipos_de_cliente_validos }, allow_nil: true
+    validates :codigo_cliente, length: { maximum: 20 }
+    validates :nome, :email, length: { maximum: 100 }
+    validates :documento, :documento_2, length: { maximum: 30 }
+    validates :data_nascimento, length: { maximum: 10 }
+
+    validates_each [:endereco_comprador, :endereco_entrega], allow_nil: true do |record, attr, value|
+      if value.is_a? SuperpayApi::Endereco
+        if value.invalid?
+          value.errors.full_messages.each { |msg| record.errors.add(attr, msg) }
+        end
+      else
+        record.errors.add(attr, 'deve ser um objeto SuperpayApi::Endereco.')
+      end
+    end
+
+    validates_each [:telefone_comprador, :telefone_adicional_comprador, :telefone_entrega, :telefone_adicional_entrega], allow_nil: true do |record, attr, value|
+      if value.is_a? SuperpayApi::Telefone
+        if value.invalid?
+          value.errors.full_messages.each { |msg| record.errors.add(attr, msg) }
+        end
+      else
+        record.errors.add(attr, 'deve ser um objeto SuperpayApi::Telefone.')
+      end
+    end
+
+    # Nova instancia da classe DadosUsuario
+    # @param [Hash] campos
+    def initialize(campos = {})
+      campos.each do |campo, valor|
+        if SuperpayApi::DadosUsuario.public_instance_methods.include? "#{campo}=".to_sym
+          send "#{campo}=", valor
+        end
+      end
+    end
+
+    # Retornar o número do tipo de telefone no padrão utilizado pelo SuperPay
+    def sexo_to_request
+      SEXO[self.sexo]
+    end
+
+    # Retornar o número do tipo de telefone no padrão utilizado pelo SuperPay
+    def tipos_de_cliente_to_request
+      TIPOS_DE_CLIENTE[self.tipo_cliente]
+    end
+
+    # Montar o Hash de dados do usuario no padrão utilizado pelo SuperPay
+    def to_request
+      dados_usuario = {
+        codigo_cliente:             self.codigo_cliente,
+        tipo_cliente:               self.tipos_de_cliente_to_request,
+        nome_comprador:             self.nome,
+        documento_comprador:        self.documento,
+        documento_2_comprador:      self.documento_2,
+        sexo_comprador:             self.sexo_to_request,
+        data_nascimento_comprador:  self.data_nascimento,
+        email_comprador:            self.email,
+      }
+      # Adiciona os dados de endereços
+      dados_usuario.merge! self.endereco_comprador.to_request("endereco_comprador") unless endereco_comprador.blank?
+      dados_usuario.merge! self.endereco_entrega.to_request("endereco_entrega") unless endereco_entrega.blank?
+
+      # Adiciona os dados de telefones
+      dados_usuario.merge! self.telefone_comprador.to_request("comprador") unless telefone_comprador.blank?
+      dados_usuario.merge! self.telefone_adicional_comprador.to_request("adicional_comprador") unless telefone_adicional_comprador.blank?
+      dados_usuario.merge! self.telefone_entrega.to_request("entrega") unless telefone_entrega.blank?
+      dados_usuario.merge! self.telefone_adicional_entrega.to_request("adicional_entrega") unless telefone_adicional_entrega.blank?
+
+      return dados_usuario
+    end
+
+  end
+end

data/lib/superpay_api/endereco.rb

@@ -0,0 +1,84 @@
+# -*- encoding : utf-8 -*-
+module SuperpayApi
+  class Endereco
+
+    # Endereço (Logradouro)
+    # Alfa Numérico - Até 100 caracteres
+    attr_accessor :logradouro
+
+    # Número do logradouro
+    # Alfa Numérico - Até 10 caracteres
+    attr_accessor :numero
+
+    # Bairro do logradouro
+    # Alfa Numérico - Até 50 caracteres
+    attr_accessor :bairro
+
+    # Complemento do endereço comprador
+    # Alfa Numérico - Até 50 caracteres
+    attr_accessor :complemento
+
+    # Cidade do logradouro
+    # Alfa Numérico - Até 50 caracteres
+    attr_accessor :cidade
+
+    # Estado do logradouro
+    # Alfa Numérico - Até 2 caracteres
+    attr_accessor :estado
+
+    # CEP. Enviar sem traços ou espaços
+    # Alfa Numérico - Até 10 caracteres
+    attr_accessor :cep
+
+    # Validações do Rails 3
+    include ActiveModel::Validations
+
+    # Validações
+    validates :logradouro, length: { maximum: 100 }
+    validates :numero, :cep, length: { maximum: 10 }
+    validates :bairro, :complemento, :cidade, length: { maximum: 50 }
+    validates :estado, length: { maximum: 2 }
+
+    # Nova instancia da classe Endereco
+    # @param [Hash] campos
+    def initialize(campos = {})
+      campos.each do |campo, valor|
+        if SuperpayApi::Endereco.public_instance_methods.include? "#{campo}=".to_sym
+          send "#{campo}=", valor
+        end
+      end
+    end
+
+    # Montar o Hash de Endereco conforme o tipo dele no padrão utilizado pelo SuperPay
+    # tipo: [:endereco_comprador, :endereco_entrega]
+    def to_request tipo
+      endereco = {}
+      case tipo.to_sym
+        when :endereco_comprador then
+          endereco = {
+            endereco_comprador:               self.logradouro,
+            numero_endereco_comprador:        self.numero,
+            bairro_endereco_comprador:        self.bairro,
+            complemento_endereco_comprador:   self.complemento,
+            cidade_endereco_comprador:        self.cidade,
+            estado_endereco_comprador:        self.estado,
+            cep_endereco_comprador:           self.cep,
+          }
+        when :endereco_entrega then
+          endereco = {
+            endereco_entrega:               self.logradouro,
+            numero_endereco_entrega:        self.numero,
+            bairro_endereco_entrega:        self.bairro,
+            complemento_endereco_entrega:   self.complemento,
+            cidade_endereco_entrega:        self.cidade,
+            estado_endereco_entrega:        self.estado,
+            cep_endereco_entrega:           self.cep,
+          }
+        else
+          raise 'Endereço inválido.'
+      end
+      return endereco
+    end
+
+  end
+end

data/lib/superpay_api/forma_de_pagamento.rb

@@ -0,0 +1,56 @@
+# -*- encoding : utf-8 -*-
+module SuperpayApi
+  class FormaDePagamento
+
+    # Opções de Formas de Pagamento
+    FORMAS_DE_PAGAMENTO = {
+      52   => "Cielo - Checkout Redirect",
+      120  => "Cielo - Visa WebService",
+      121  => "Cielo - MasterCard WebService",
+      122  => "Cielo - American Express WebService",
+      123  => "Cielo - ELO WebService",
+      124  => "Cielo - Diners WebService",
+      125  => "Cielo - Discover WebService",
+      126  => "Cielo - Aura WebService",
+      127  => "Cielo - JCB WebService",
+      128  => "Cielo - Maestro WebService",
+      129  => "Cielo - Visa Electron WebService",
+      130  => "Cielo - Visa Redirect",
+      131  => "Cielo - MasterCard Redirect",
+      132  => "Cielo - American Express Redirect",
+      133  => "Cielo - ELO Redirect",
+      134  => "Cielo - Diners Redirect",
+      135  => "Cielo - Discover Redirect",
+      136  => "Cielo - Aura Redirect",
+      137  => "Cielo - JCB Redirect",
+      138  => "Cielo - Maestro Redirect",
+      139  => "Cielo - Visa Electron Redirect",
+      80   => "Rede - Visa Komerci Integrado Redirect",
+      81   => "Rede - MasterCard Komerci Integrado Redirect",
+      82   => "Rede - Diners Komerci Integrado Redirect",
+      90   => "Rede - Visa Komerci WebService WebService",
+      91   => "Rede - MasterCard Komerci WebService WebService",
+      92   => "Rede - Diners Komerci WebService WebService",
+      93   => "Rede - Hpercard Komerci WebService WebService",
+      94   => "Rede - Hiper Komerci WebService WebService",
+      204  => "Elavon - Visa WebService",
+      205  => "Elavon - MasterCard WebService",
+      206  => "Elavon - Diners WebService",
+      207  => "Elavon - Discover WebService",
+      270  => "GetNet - Visa WebService",
+      271  => "GetNet - MasterCard WebService",
+      350  => "Stone - Visa WebService",
+      351  => "Stone - MasterCard WebService",
+      380  => "Bin-FirstData - Visa WebService",
+      381  => "Bin-FirstData - MasterCard WebService",
+      382  => "Bin-FirstData - Cabal WebService",
+      999  => "Múltiplos Cartões WebService",
+    }
+
+    # Retornar array com as possíveis Formas de Pagamento
+    def self.validos
+      FORMAS_DE_PAGAMENTO.map{ |key, value| key }
+    end
+
+  end
+end

data/lib/superpay_api/helper.rb

@@ -0,0 +1,46 @@
+# -*- encoding : utf-8 -*-
+module SuperpayApi
+  class Helper
+
+    # Montar o Hash com a requisição de consulta transação completo
+    def build_request_consulta_transacao_completa numero_transacao
+      # Montar os parâmetros para consulta
+      params = {
+        consulta_transacao_w_s: {
+          codigo_estabelecimento: SuperpayApi.estabelecimento,
+          numero_transacao: numero_transacao,
+        }
+      }
+      # Adiciona as configurações de login
+      params.merge! SuperpayApi.login
+    end
+
+    # Montar o Hash com a requisição de pagamento transação completo
+    def build_request_pagamento_transacao_completa transacao
+      # Montar os parâmetros para pagamento transacao completa
+      params = {}
+      params[:transacao] = transacao.to_request
+      # Adiciona as configurações de login
+      params.merge! SuperpayApi.login
+    end
+
+    # Montar o Hash com a resposta quando ocorre erro
+    # [ResultadoPagamentosWS, ResultadoConsultaTransacaoWS]
+    def build_response_retorno(resposta = {})
+      response = resposta.to_array.first
+      if !response[:consulta_transacao_completa_response].blank?
+        return SuperpayApi::Retorno.new(response[:consulta_transacao_completa_response][:return])
+      elsif !response[:pagamento_transacao_completa_response].blank?
+        return SuperpayApi::Retorno.new(response[:pagamento_transacao_completa_response][:return])
+      else
+        return resposta
+      end
+    end
+
+    # Montar o Hash com a resposta quando ocorre erro
+    def build_response_error(resposta = {})
+      return resposta
+    end
+
+  end
+end

data/lib/superpay_api/item_pedido.rb

@@ -0,0 +1,64 @@
+# -*- encoding : utf-8 -*-
+module SuperpayApi
+  class ItemPedido
+
+    # Código único que identifica cada produto.
+    # Alfa Numérico - Até 20 caracteres
+    attr_accessor :codigo_produto
+
+    # Código que identifica categoria do produto.
+    # Alfa Numérico - Até 20 caracteres
+    attr_accessor :codigo_categoria
+
+    # Nome do Produto
+    # Alfa Numérico - Até 100 caracteres
+    attr_accessor :nome_produto
+
+    # Quantidade comprada do produto
+    # Numérico - Até 8 dígitos
+    attr_accessor :quantidade_produto
+
+    # Valor unitário do produto.
+    # Sempre enviar o valor sem vírgula ou ponto, os dois últimos dígitos são sempre considerados como centavos.
+    # Numérico - Até 10 dígitos
+    attr_accessor :valor_unitario_produto
+
+    # Nome da categoria do produto.
+    # Alfa Numérico - Até 100 caracteres
+    attr_accessor :nome_categoria
+
+    # Validações do Rails 3
+    include ActiveModel::Validations
+
+    # Validações
+    validates :quantidade_produto, :valor_unitario_produto, numericality: true, allow_nil: true
+    validates :codigo_produto, :codigo_categoria, length: { maximum: 20 }
+    validates :nome_produto, :nome_categoria, length: { maximum: 100 }
+    validates :quantidade_produto, length: { maximum: 8 }
+    validates :valor_unitario_produto, length: { maximum: 10 }
+
+    # Nova instancia da classe ItemPedido
+    # @param [Hash] campos
+    def initialize(campos = {})
+      campos.each do |campo, valor|
+        if SuperpayApi::ItemPedido.public_instance_methods.include? "#{campo}=".to_sym
+          send "#{campo}=", valor
+        end
+      end
+    end
+
+    # Montar o Hash de dados do ItemPedido no padrão utilizado pelo SuperPay
+    def to_request
+      item_pedido = {
+        codigo_produto:           self.codigo_produto,
+        codigo_categoria:         self.codigo_categoria,
+        nome_produto:             self.nome_produto,
+        quantidade_produto:       self.quantidade_produto,
+        valor_unitario_produto:   self.valor_unitario_produto,
+        nome_categoria:           self.nome_categoria,
+      }
+      return item_pedido
+    end
+
+  end
+end

data/lib/superpay_api/retorno.rb

@@ -0,0 +1,80 @@
+# -*- encoding : utf-8 -*-
+module SuperpayApi
+  class Retorno
+
+    # Código que identifica a transação dentro do SuperPay
+    # Numérico - Até 8 dígitos
+    attr_accessor :numero_transacao
+
+    # Código que identifica o estabelecimento dentro do SuperPay (fornecido pelo gateway)
+    # Enviado pelo SuperPay
+    attr_accessor :codigo_estabelecimento
+
+    # Código da forma de pagamento. Ver tabela “Forma de Pagamento”
+    # Simbolo - Valores pré-definidos - Verifique classe SuperpayApi::FormaDePagamento
+    attr_accessor :codigo_forma_pagamento
+
+    # Valor da transação
+    # Sempre enviar o valor sem vírgula ou ponto, os dois últimos dígitos são sempre considerados como centavos.
+    # Numérico - Até 10 dígitos
+    attr_accessor :valor
+
+    # Valor do desconto da transação
+    # Sempre enviar o valor sem vírgula ou ponto, os dois últimos dígitos são sempre considerados como centavos.
+    # Numérico - Até 10 dígitos
+    attr_accessor :valor_desconto
+
+    # Valor da taxa de embarque
+    # Sempre enviar o valor sem vírgula ou ponto, os dois últimos dígitos são sempre considerados como centavos.
+    # Numérico - Até 10 dígitos
+    attr_accessor :taxa_embarque
+
+    # Quantidade de parcelas da transação. Verificar se forma de pagamento suporta parcelamento
+    # Numérico - Até 2 dígitos
+    attr_accessor :parcelas
+
+    # Para o modelo redirect. Essa será a URL de redirecionamento da operação.
+    # Alfa Numérico - Até 500 caracteres
+    attr_accessor :url_pagamento
+
+    # Código que mostra o status atual da transação. Verificar tabela “Status”
+    # Simbolo - Valores pré-definidos - Verifique classe SuperpayApi::Status
+    attr_accessor :status_transacao
+
+    # Código de autorização da operadora/banco/intermediário financeiro
+    # Numérico - Até 20 dígitos
+    attr_accessor :autorizacao
+
+    # Código da transação na operadora/banco/intermediário financeiro
+    # Numérico - Até 20 dígitos
+    attr_accessor :codigo_transacao_operadora
+
+    # Data de aprovação na operadora
+    # Alfa Numérico - Até 10 caracteres
+    attr_accessor :data_aprovacao_operadora
+
+    # Número do comprovante de venda
+    # Alfa Numérico - Até 20 caracteres
+    attr_accessor :numero_comprovante_venda
+
+    # Mensagem de retorno da operadora
+    # Alfa Numérico - Até 50 caracteres
+    attr_accessor :mensagem_venda
+
+    # Retorna o status conforme classe SuperpayApi::Status
+    def status
+      @status ||= SuperpayApi::Status::STATUS[self.status_transacao.to_i]
+    end
+
+    # Nova instancia da classe Retorno
+    # @param [Hash] campos
+    def initialize(campos = {})
+      campos.each do |campo, valor|
+        if SuperpayApi::Retorno.public_instance_methods.include? "#{campo}=".to_sym
+          send "#{campo}=", valor.to_s
+        end
+      end
+    end
+
+  end
+end

data/lib/superpay_api/status.rb

@@ -0,0 +1,55 @@
+# -*- encoding : utf-8 -*-
+module SuperpayApi
+  class Status
+
+    # Map Status para Texto.
+    MAPPING = {
+      :autorizado_e_confirmado                => "Autorizado e Confirmado",
+      :autorizado                             => "Autorizado",
+      :nao_autorizado                         => "Não Autorizado",
+      :transacao_em_andamento                 => "Transação em Andamento",
+      :aguardando_pagamento                   => "Aguardando Pagamento",
+      :falha_na_operadora                     => "Falha na Operadora",
+      :cancelado                              => "Cancelado",
+      :estornada                              => "Estornada",
+      :em_analise_de_risco                    => "Em Análise de Risco",
+      :recusado_analise_de_risco              => "Recusado Análise de Risco",
+      :falha_no_envio_para_analise_de_risco   => "Falha no envio para Análise de Risco",
+      :boleto_pago_a_menor                    => "Boleto Pago a menor",
+      :boleto_pago_a_maior                    => "Boleto Pago a maior",
+      :estorno_parcial                        => "Estorno Parcial",
+      :estorno_nao_autorizado                 => "Estorno Não Autorizado",
+      :operacao_em_andamento                  => "Operação em andamento",
+      :transacao_ja_efetuada                  => "Transação já efetuada",
+      :aguardando_cancelamento                => "Aguardando Cancelamento",
+    }
+
+    # Opções de Status das Transações
+    STATUS = {
+      1   => :autorizado_e_confirmado,
+      2   => :autorizado,
+      3   => :nao_autorizado,
+      5   => :transacao_em_andamento,
+      8   => :aguardando_pagamento,
+      9   => :falha_na_operadora,
+      13  => :cancelado,
+      14  => :estornada,
+      15  => :em_analise_de_risco,
+      17  => :recusado_analise_de_risco,
+      18  => :falha_no_envio_para_analise_de_risco,
+      21  => :boleto_pago_a_menor,
+      22  => :boleto_pago_a_maior,
+      23  => :estorno_parcial,
+      24  => :estorno_nao_autorizado,
+      30  => :operacao_em_andamento,
+      31  => :transacao_ja_efetuada,
+      40  => :aguardando_cancelamento,
+    }
+
+    # Retornar array com os possíveis Status
+    def self.validos
+      STATUS.map{ |key, value| key }
+    end
+
+  end
+end

data/lib/superpay_api/telefone.rb

@@ -0,0 +1,99 @@
+# -*- encoding : utf-8 -*-
+module SuperpayApi
+  class Telefone
+
+    # Opções de Tipo de Telefone
+    TIPOS_DE_TELEFONE = {
+      :outros        => 1,
+      :residencial   => 2,
+      :comercial     => 3,
+      :recados       => 4,
+      :cobranca      => 5,
+      :temporario    => 6,
+    }
+
+    # Ver tabela “Tipos de Telefone”
+    # Simbolo - Valores pré-definidos [:outros, :residencial, :comercial, :recados, :cobranca, :temporario]
+    attr_accessor :codigo_tipo_telefone
+
+    # Telefone sem espaços ou traços
+    # Alfa Numérico - Até 10 caracteres
+    attr_accessor :telefone
+
+    # DDD do telefone
+    # Alfa Numérico - Até 3 caracteres
+    attr_accessor :ddd
+
+    # DDI do telefone
+    # Alfa Numérico - Até 3 caracteres
+    attr_accessor :ddi
+
+    # Validações do Rails 3
+    include ActiveModel::Validations
+
+    # Retornar array com os possíveis tipos de telefone
+    def self.validos
+      TIPOS_DE_TELEFONE.map{ |key, value| key }
+    end
+
+    # Validações
+    validates :codigo_tipo_telefone, inclusion: { in: SuperpayApi::Telefone.validos }, allow_nil: true
+    validates :telefone, length: { maximum: 10 }
+    validates :ddd, :ddi, length: { maximum: 3 }
+
+    # Nova instancia da classe Telefone
+    # @param [Hash] campos
+    def initialize(campos = {})
+      campos.each do |campo, valor|
+         if SuperpayApi::Telefone.public_instance_methods.include? "#{campo}=".to_sym
+          send "#{campo}=", valor
+        end
+      end
+    end
+
+    # Retornar o número do tipo de telefone
+    def codigo_tipo_telefone_to_request
+      TIPOS_DE_TELEFONE[self.codigo_tipo_telefone]
+    end
+
+    # Montar o Hash de tefone conforme o tipo dele no padrão utilizado pelo SuperPay
+    # tipo: [:comprador, :adicional_comprador, :entrega, :adicional_entrega]
+    def to_request tipo
+      telefone = {}
+      case tipo.to_sym
+        when :comprador then
+          telefone = {
+            codigo_tipo_telefone_comprador:   self.codigo_tipo_telefone_to_request,
+            telefone_comprador:               self.telefone,
+            ddd_comprador:                    self.ddd,
+            ddi_comprador:                    self.ddi,
+          }
+        when :adicional_comprador then
+          telefone = {
+            codigo_tipo_telefone_adicional_comprador:   self.codigo_tipo_telefone_to_request,
+            telefone_adicional_comprador:               self.telefone,
+            ddd_adicional_comprador:                    self.ddd,
+            ddi_adicional_comprador:                    self.ddi,
+          }
+        when :entrega then
+          telefone = {
+            codigo_tipo_telefone_entrega:   self.codigo_tipo_telefone_to_request,
+            telefone_entrega:               self.telefone,
+            ddd_entrega:                    self.ddd,
+            ddi_entrega:                    self.ddi,
+          }
+        when :adicional_entrega then
+          telefone = {
+            codigo_tipo_telefone_adicional_entrega:   self.codigo_tipo_telefone_to_request,
+            telefone_adicional_entrega:               self.telefone,
+            ddd_adicional_entrega:                    self.ddd,
+            ddi_adicional_entrega:                    self.ddi,
+          }
+        else
+          raise 'Tipo inválido.'
+      end
+      return telefone
+    end
+
+  end
+end

data/lib/superpay_api/transacao.rb

@@ -0,0 +1,206 @@
+# -*- encoding : utf-8 -*-
+module SuperpayApi
+  class Transacao
+
+    # Código que identifica a transação dentro do SuperPay
+    # Numérico - Até 8 dígitos
+    attr_accessor :numero_transacao
+
+    # Código da forma de pagamento. Ver tabela “Forma de Pagamento”
+    # Simbolo - Valores pré-definidos - Verifique classe SuperpayApi::FormaDePagamento
+    attr_accessor :codigo_forma_pagamento
+
+    # Valor da transação
+    # Sempre enviar o valor sem vírgula ou ponto, os dois últimos dígitos são sempre considerados como centavos.
+    # Numérico - Até 10 dígitos
+    attr_accessor :valor
+
+    # Valor do desconto da transação
+    # Sempre enviar o valor sem vírgula ou ponto, os dois últimos dígitos são sempre considerados como centavos.
+    # Numérico - Até 10 dígitos
+    attr_accessor :valor_desconto
+
+    # Valor da taxa de embarque
+    # Sempre enviar o valor sem vírgula ou ponto, os dois últimos dígitos são sempre considerados como centavos.
+    # Numérico - Até 10 dígitos
+    attr_accessor :taxa_embarque
+
+    # Quantidade de parcelas da transação. Verificar se forma de pagamento suporta parcelamento
+    # Numérico - Até 2 dígitos
+    attr_accessor :parcelas
+
+    # Nome do titular do cartão de crédito (Exatamente como escrito no cartão)
+    # Alfa Numérico - Até 16 caracteres
+    attr_accessor :nome_titular_cartao_credito
+
+    # Numero do cartão de crédito, sem espaços ou traços
+    # Numérico - Até 22 caracteres
+    attr_accessor :numero_cartao_credito
+
+    # Código de segurança do cartão (campo não é armazenado pelo SuperPay)
+    # Numérico - Até 4 caracteres
+    attr_accessor :codigo_seguranca
+
+    # Data de validade do cartão.
+    # Alfa Numérico - Até 7 caracteres - Formato mm/yyyy
+    attr_accessor :data_validade_cartao
+
+    # Data de validade do boleto.
+    # Alfa Numérico - Até 10 caracteres - Formato dd/mm/yyyy
+    attr_accessor :vencimento_boleto
+
+    # Para o modelo de pagamento redirect, O SuperPay redirecionará para essa URL em caso de transação *aprovada
+    # Alfa Numérico - Até 250 caracteres
+    attr_accessor :url_redirecionamento_pago
+
+    # Para o modelo de pagamento redirect, O SuperPay redirecionará para essa URL em caso de transação *reprovada
+    # Alfa Numérico - Até 250 caracteres
+    attr_accessor :url_redirecionamento_nao_pago
+
+    # Número do IP do usuário final/cliente.
+    # Alfa Numérico - Até 15 caracteres Formato xxx.xxx.xxx.xxx
+    attr_accessor :ip
+
+    # Campo Livre 1
+    # Alfa Numérico - Até 16 caracteres
+    attr_accessor :campo_livre1
+
+    # Campo Livre 2
+    # Alfa Numérico - Até 16 caracteres
+    attr_accessor :campo_livre2
+
+    # Campo Livre 3
+    # Alfa Numérico - Até 16 caracteres
+    attr_accessor :campo_livre3
+
+    # Campo Livre 4
+    # Alfa Numérico - Até 16 caracteres
+    attr_accessor :campo_livre4
+
+    # Campo Livre 5
+    # Alfa Numérico - Até 16 caracteres
+    attr_accessor :campo_livre5
+
+    # Informações para cobrança e entrega. Informações importantes para análise de fraude
+    # SuperpayApi::DadosUsuario
+    attr_accessor :dados_usuario_transacao
+
+    # Lista com Itens que estão sendo comprados. Informações importantes para análise de fraude e intermediários financeiros
+    # SuperpayApi::ItemPedido
+    attr_accessor :itens_do_pedido
+
+    # Validações do Rails 3
+    include ActiveModel::Validations
+
+    # Validações
+    validates :numero_transacao, :codigo_forma_pagamento, :valor, :valor_desconto, :taxa_embarque, :parcelas, :numero_cartao_credito,
+              :codigo_seguranca, numericality: true
+    validates :codigo_forma_pagamento, inclusion: { in: SuperpayApi::FormaDePagamento.validos }
+    validates :parcelas, length: { maximum: 2 }
+    validates :codigo_seguranca, length: { maximum: 4 }
+    validates :data_validade_cartao, length: { maximum: 7 }
+    validates :numero_transacao, length: { maximum: 8 }
+    validates :valor, :valor_desconto, :taxa_embarque, :vencimento_boleto, length: { maximum: 10 }
+    validates :ip, length: { maximum: 15 }
+    validates :nome_titular_cartao_credito, :campo_livre1, :campo_livre2, :campo_livre3, :campo_livre4, :campo_livre5, length: { maximum: 16 }
+    validates :numero_cartao_credito, length: { maximum: 22 }
+    validates :url_redirecionamento_pago, :url_redirecionamento_nao_pago, length: { maximum: 250 }
+
+    validates_each [:dados_usuario_transacao], allow_nil: true do |record, attr, value|
+      if value.is_a? SuperpayApi::DadosUsuario
+        if value.invalid?
+          value.errors.full_messages.each { |msg| record.errors.add(attr, msg) }
+        end
+      else
+        record.errors.add(attr, 'deve ser um objeto SuperpayApi::DadosUsuario.')
+      end
+    end
+
+    validates_each [:itens_do_pedido], allow_nil: true do |record, attr, value|
+      if value.is_a? Array
+        value.each do |item_do_pedido|
+          if item_do_pedido.is_a? SuperpayApi::ItemPedido
+            if item_do_pedido.invalid?
+              item_do_pedido.errors.full_messages.each { |msg| record.errors.add(attr, msg) }
+            end
+          else
+            record.errors.add(attr, 'deve ser um objeto SuperpayApi::ItemPedido.')
+          end
+        end
+      else
+        record.errors.add(attr, 'deve ser uma coleção (Array).')
+      end
+    end
+
+    # Nova instancia da classe Transacao
+    # @param [Hash] campos
+    def initialize(campos = {})
+      campos.each do |campo, valor|
+        if SuperpayApi::Transacao.public_instance_methods.include? "#{campo}=".to_sym
+          send "#{campo}=", valor
+        end
+      end
+    end
+
+    # Função para consultar transações
+    def consulta_transacao numero_transacao
+      resposta = web_service.consulta_transacao_completa numero_transacao
+      resposta
+    end
+
+    # Função para consultar transações
+    def self.consulta_transacao numero_transacao
+      self.new.consulta_transacao numero_transacao
+    end
+
+    # Função para realizar o pagamento de transações
+    def enviar_pagamento
+      resposta = web_service.pagamento_transacao_completa self
+      resposta
+    end
+
+    # Montar o Hash da transação no padrão utilizado pelo SuperPay
+    def to_request
+      transacao = {
+        numero_transacao:               self.numero_transacao,
+        "IP" =>                         self.ip,
+        codigo_forma_pagamento:         self.codigo_forma_pagamento,
+        valor:                          self.valor,
+        valor_desconto:                 self.valor_desconto,
+        taxa_embarque:                  self.taxa_embarque,
+        parcelas:                       self.parcelas,
+        nome_titular_cartao_credito:    self.nome_titular_cartao_credito,
+        numero_cartao_credito:          self.numero_cartao_credito,
+        codigo_seguranca:               self.codigo_seguranca,
+        data_validade_cartao:           self.data_validade_cartao,
+        vencimento_boleto:              self.vencimento_boleto,
+        url_redirecionamento_pago:      self.url_redirecionamento_pago,
+        url_redirecionamento_nao_pago:  self.url_redirecionamento_nao_pago,
+        campo_livre1:                   self.campo_livre1,
+        campo_livre2:                   self.campo_livre2,
+        campo_livre3:                   self.campo_livre3,
+        campo_livre4:                   self.campo_livre4,
+        campo_livre5:                   self.campo_livre5,
+      }
+
+      # Adicionar os parâmetros de configurações
+      transacao.merge! SuperpayApi.configuracoes_to_request
+
+      # Adicionar dados do usuário
+      transacao[:dados_usuario_transacao] = self.dados_usuario_transacao.to_request unless self.dados_usuario_transacao.blank?
+
+      # Adicionar itens do pedido
+      transacao[:itens_do_pedido] = self.itens_do_pedido.collect{ |i| i.to_request } unless self.itens_do_pedido.blank?
+
+      return transacao
+    end
+
+    private
+
+      # Acesso ao web_service
+      def web_service
+        @web_service ||= SuperpayApi::WebService.new
+      end
+
+  end
+end

data/lib/superpay_api/version.rb

@@ -0,0 +1,9 @@
+# -*- encoding : utf-8 -*-
+module SuperpayApi
+  module Version
+    MAJOR = 0
+    MINOR = 0
+    PATCH = 1
+    STRING = "#{MAJOR}.#{MINOR}.#{PATCH}"
+  end
+end

data/lib/superpay_api/web_service.rb

@@ -0,0 +1,74 @@
+# -*- encoding : utf-8 -*-
+require 'savon'
+
+module SuperpayApi
+  class WebService
+
+    # Atributo para o cliente SOAP
+    attr_reader :savon_client
+
+    # Nova instancia da classe WebService
+    # Será considerado o ambiente informado nas configurações
+    def initialize
+      @savon_client = Savon.client(
+        wsdl: ::SuperpayApi.url,
+        env_namespace: :soapenv,
+        convert_request_keys_to: :lower_camelcase,
+        namespace_identifier: :pag,
+        namespaces: {
+          "xmlns:soapenv" => "http://schemas.xmlsoap.org/soap/envelope/",
+          "xmlns:pag" => "http://pagamentos.webservices.superpay.ernet.com.br/",
+        }
+      )
+    end
+
+    # Função que faz a requisição para consulta_transacao_completa
+    def consulta_transacao_completa(numero_transacao)
+      # Monta os parâmetros
+      params = helper.build_request_consulta_transacao_completa(numero_transacao)
+
+      # Faz a requisição para o wsdl
+      begin
+        retorno = @savon_client.call(:consulta_transacao_completa, message: params)
+      rescue Savon::SOAPFault => error
+        return helper.build_response_error(error)
+      end
+
+      # Verifica se a retorno veio correta ou se deu problema
+      if retorno.blank?
+        return {error: true}
+      else
+        return helper.build_response_retorno(retorno)
+      end
+    end
+
+    # Função que faz a requisição para pagamento_transacao_completa
+    def pagamento_transacao_completa(transacao)
+      # Monta os parâmetros
+      params = helper.build_request_pagamento_transacao_completa(transacao)
+
+      # Faz a requisição para o wsdl
+      begin
+        retorno = @savon_client.call(:pagamento_transacao_completa, message: params)
+      rescue Savon::SOAPFault => error
+        return helper.build_response_error(error)
+        # return helper.build_response_error({error: error.to_hash[:fault][:faultstring]})
+      end
+
+      # Verifica se a retorno veio correta ou se deu problema
+      if retorno.blank?
+        return {error: true}
+      else
+        return helper.build_response_retorno(retorno)
+      end
+    end
+
+    private
+
+      # Acesso ao helper
+      def helper
+        @helper ||= SuperpayApi::Helper.new
+      end
+
+  end
+end

data/lib/superpay_api.rb

@@ -0,0 +1,22 @@
+# -*- encoding : utf-8 -*-
+require 'rubygems'
+require 'active_model'
+
+require "superpay_api/version"
+require "superpay_api/configuracao"
+require "superpay_api/helper"
+require "superpay_api/web_service"
+require "superpay_api/forma_de_pagamento"
+require "superpay_api/status"
+
+require "superpay_api/endereco"
+require "superpay_api/telefone"
+require "superpay_api/dados_usuario"
+require "superpay_api/item_pedido"
+require "superpay_api/transacao"
+require "superpay_api/retorno"
+
+# -*- encoding : utf-8 -*-
+module SuperpayApi
+  extend SuperpayApi::Configuracao
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification
+name: superpay_api
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- QW3 Software & Marketing
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-07-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: savon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.11'
+description: Gem para utilização do SuperPay API disponibilizado pela empresa SuperPay
+  para integrar sua plataforma de forma segura e eficaz com as principais formas de
+  pagamento disponíveis no mercado.
+email:
+- contato@qw3.com.br
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/superpay_api.rb
+- lib/superpay_api/configuracao.rb
+- lib/superpay_api/dados_usuario.rb
+- lib/superpay_api/endereco.rb
+- lib/superpay_api/forma_de_pagamento.rb
+- lib/superpay_api/helper.rb
+- lib/superpay_api/item_pedido.rb
+- lib/superpay_api/retorno.rb
+- lib/superpay_api/status.rb
+- lib/superpay_api/telefone.rb
+- lib/superpay_api/transacao.rb
+- lib/superpay_api/version.rb
+- lib/superpay_api/web_service.rb
+homepage: https://github.com/qw3/superpay_api
+licenses:
+- MIT
+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.4.1
+signing_key: 
+specification_version: 4
+summary: SuperPay API - Gateway de pagamento
+test_files: []
+has_rdoc: