cielo-ws15 1.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 14f65e9edcee6d1d490c57a751e224dafe60645f
+  data.tar.gz: 0adb601a95ed3140e120713a5311cf8b57abee6c
+SHA512:
+  metadata.gz: a88aab5616c3af7dc90b6f539065b82d30861454650d2af4db0d2bed8b67f61fd37b330181bc816ee676408ee7e83acd45c472ea6f3129727b9725823f65fb72
+  data.tar.gz: 25bf32a0b05a3b17968d4270280937ed39d484e46519cb5a915c0b0635a5b1af028b83e0d8a76cc0d1ddb393ab7d80e683077e66fa2390fd5dd7553c2789162a

data/lib/cielo/ws15.rb

@@ -0,0 +1,214 @@
+require "cielo/ws15/holder"
+require "cielo/ws15/merchant"
+require "cielo/ws15/order"
+require "cielo/ws15/payment_method"
+require "cielo/ws15/transaction"
+require "cielo/ws15/token"
+
+require "cielo/ws15/authorization_message"
+require "cielo/ws15/cancellation_message"
+require "cielo/ws15/capture_message"
+require "cielo/ws15/transaction_message"
+require "cielo/ws15/token_message"
+require "net/http"
+
+# SDK de integração com o Webservice 1.5 da Cielo
+module Cielo
+  # Integração com o Webservice 1.5;  esse participante faz um papel de facilitador
+  # para a construção de todos os participantes importantes para a integração.
+  # Através de factory methods, é possível criar as instâncias pré-configuradas
+  # com os parâmetros mínimos necessários para a execução das operações.
+  class WS15
+    # Ambiente de produção da Cielo
+    PRODUCTION = "https://ecommerce.cielo.com.br/servicos/ecommwsec.do"
+
+    # Ambiente de testes da Cielo
+    TEST = "https://qasecommerce.cielo.com.br/servicos/ecommwsec.do"
+
+    # Namespace dos XML de requisição e resposta
+    NAMESPACE = "http://ecommerce.cbmp.com.br"
+
+    # Versão do XML utilizado na integração
+    VERSION = "1.3.0"
+
+    attr_accessor :merchant, :endpoint
+    private :merchant, :endpoint
+
+    # Inicializa uma nova instância de WS15 informando as credenciais e o ambiente
+    #
+    # @param affiliation_id [String] Número de afiliação na Cielo
+    # @param affiliation_key [String] Chave de afiliação
+    # @param endpoint [String] Ambiente onde será executada a integração
+    def initialize(
+      affiliation_id,
+      affiliation_key,
+      endpoint = WS15::PRODUCTION)
+
+      @merchant = Merchant.new(affiliation_id, affiliation_key)
+      @endpoint = endpoint
+    end
+
+    # Cria uma instância de Holder, que representa o portador de um cartão,
+    # definindo os dados do cartão ou apenas um token previamente gerado
+    #
+    # @param token_or_number [String] token ou o número do cartão do cliente
+    # @param expiration_year [String] ano de expiração do cartão
+    # @param expiration_month [String] mês de expiração do cartão
+    # @param indicator [Number] indicador de visibilidade do código de segurança
+    # @param cvv [String] Código de segurança do cartão
+    #
+    # @return [Holder] instância configurada com os dados informados
+    def holder(
+      token_or_number,
+      expiration_year = nil,
+      expiration_month = nil,
+      indicator = nil,
+      cvv = Holder::CVV_NOT_INFORMED)
+
+      if expiration_year == nil
+        return Holder.new(token_or_number)
+      end
+
+      return Holder.new(
+        token_or_number,
+        expiration_year,
+        expiration_month,
+        indicator,
+        cvv
+      )
+    end
+
+    # Cria uma instância de Order, que representa um pedido, informando o número
+    # valor, moeda e data de criação.
+    #
+    # @param number [String] Número do pedido na plataforma da loja
+    # @param total [Number] Valor total do pedido em centavos
+    # @param currency [Number] Código ISO que representa a moeda; 986 para Real
+    # @param date_time [String] Data e hora do pedido na plataforma da loja
+    #
+    # @return [Order] instância de Order configurada com os dados informados
+    def order(
+      number,
+      total,
+      currency = 986,
+      date_time = nil)
+
+      return Order.new(number, total, currency, date_time)
+    end
+
+    # Cria uma instância de PaymentMethod, que representa a forma de pagamento,
+    # informando o banco emissor do cartão, produto Cielo e número de parcelas.
+    #
+    # @param issuer [String] Banco emissor do cartão
+    # @param product [String] Produto Cielo que será utilizado
+    # @param installments [Number] Número de parcelas; 1 para transação à vista
+    #
+    # @return [PaymentMethod] instância de PaymentMethod configurada com os dados informados
+    def payment_method(
+      issuer,
+      product = PaymentMethod::CREDITO_A_VISTA,
+      installments = 1)
+
+      return PaymentMethod.new(issuer, product, installments)
+    end
+
+    # Cria uma instância de Transaction, que representa uma transação, informando
+    # o portador do cartão, pedido, forma de pagamento, URL de retorno, método
+    # de autorização e forma de captura.
+    #
+    # @param holder [Holder] Portador do cartão
+    # @param order [Order] Pedido
+    # @param payment_method [PaymentMethod] Forma de pagamento
+    # @param return_url [String] URL de retorno
+    # @param authorize [Number] Método de autorização
+    # @param capture [Boolean] Se a transação deve ser capturada automaticamente
+    #
+    # @return [Transaction] instância de Transaction configurada com os dados informados
+    def transaction(
+      holder,
+      order,
+      payment_method,
+      return_url,
+      authorize,
+      capture: true)
+
+      return Transaction.new(@merchant, holder, order, payment_method, return_url, authorize, capture:capture)
+    end
+
+    # Envia uma requisicao-autorizacao-tid para a Cielo
+    #
+    # @param transaction [Transaction] A transação que será enviada na requisição
+    #
+    # @return [Transaction] A transação com o retorno da Cielo
+    def authorization_request(transaction)
+      authorization_message = WS15Message::AuthorizationMessage.new
+
+      response = send_request(authorization_message.serialize(transaction))
+
+      return transaction
+    end
+
+    # Envia uma requisicao-cancelamento para a Cielo
+    #
+    # @param transaction [Transaction] A transação que será enviada na requisição
+    # @param total [Number] O valor que será cancelado; se não informado, o cancelamento será total
+    #
+    # @return [Transaction] A transação com o retorno da Cielo
+    def cancellation_request(transaction, total = nil)
+      cancellation_message = WS15Message::CancellationMessage.new
+
+      response = send_request(cancellation_message.serialize(transaction, total))
+
+      return cancellation_message.unserialize(response, transaction)
+    end
+
+    # Envia uma requisicao-captura para a Cielo
+    #
+    # @param transaction [Transaction] A transação que será enviada na requisição
+    # @param total [Number] O valor que será capturado; se não informado, a captura será total
+    #
+    # @return [Transaction] A transação com o retorno da Cielo
+    def capture_request(transaction, total = nil)
+      capture_message = WS15Message::CaptureMessage.new
+
+      response = send_request(capture_message.serialize(transaction, total))
+
+      return capture_message.unserialize(response, transaction)
+	  end
+
+    # Envia uma requisicao-token para a Cielo
+    #
+    # @param holder [Holder] Dados do portador do cartão
+    #
+    # @return [Token] O token gerado para os dados do cartão
+    def token_request(holder)
+      token_message = WS15Message::TokenMessage.new
+
+      response = send_request(token_message.serialize(@merchant, holder))
+
+      return token_message.unserialize(response)
+	  end
+
+    # Envia uma requisicao-transacao para a Cielo
+    #
+    # @param transaction [Transaction] A transação que será enviada na requisição
+    #
+    # @return [Transaction] A transação com o retorno da Cielo
+    def transaction_request(transaction)
+      transaction_message = WS15Message::TransactionMessage.new
+
+      response = send_request(transaction_message.serialize(transaction))
+
+      return transaction_message.unserialize(response, transaction)
+	  end
+
+    private
+    def send_request(message)
+      uri = URI(@endpoint)
+
+      response = Net::HTTP.post_form(uri, {"mensagem" => message})
+
+      return response.body
+    end
+  end
+end

data/lib/cielo/ws15/authentication.rb

@@ -0,0 +1,16 @@
+module Cielo
+  # Em casos de autenticação, representa os dados da autenticação.
+  #
+  # @attr [String] code Código da autenticação
+  # @attr [String] message Mensagem da autenticação
+  # @attr [String] date_time Data e hora da autenticação
+  # @attr [Number] total Valor autenticado
+  # @attr [Number] eci Código ECI para a autenticação
+  class Authentication
+    attr_accessor :code,
+                  :message,
+                  :date_time,
+                  :total,
+                  :eci
+  end
+end

data/lib/cielo/ws15/authorization.rb

@@ -0,0 +1,20 @@
+module Cielo
+  # Dados da autorização
+  #
+  # @attr [String] code Código da autorização
+  # @attr [String] message Mensagem da autorização
+  # @attr [String] date_time Data e hora da autorização
+  # @attr [Number] total Valor autorização
+  # @attr [Number] lr Código LR da autorização
+  # @attr [Number] arp Código ARP da autorização
+  # @attr [Number] nsu Código NSU da autorização
+  class Authorization
+    attr_accessor :code,
+                  :message,
+                  :date_time,
+                  :total,
+                  :lr,
+                  :arp,
+                  :nsu
+  end
+end

data/lib/cielo/ws15/authorization_message.rb

@@ -0,0 +1,28 @@
+require "nokogiri"
+require "cielo/ws15/message"
+
+module Cielo::WS15Message
+  class AuthorizationMessage
+    include Cielo::WS15Message
+
+    def serialize(transaction)
+      builder = Nokogiri::XML::Builder.new(:encoding => "ISO-8859-1") do |xml|
+        xml.send("requisicao-autorizacao-tid",
+                     "xmlns" => Cielo::WS15::NAMESPACE,
+                     "versao" => Cielo::WS15::VERSION,
+                     "id" => transaction.order.number) {
+
+            xml.send("tid", transaction.tid)
+
+            Cielo::WS15Message.serialize_dados_ec(xml, transaction.merchant)
+        }
+      end
+
+      return builder.to_xml
+    end
+
+    def unserialize(message, transaction)
+      return Cielo::WS15Message.unserialize_transaction(message, transaction)
+    end
+  end
+end

data/lib/cielo/ws15/cancellation.rb

@@ -0,0 +1,14 @@
+module Cielo
+  # Em casos de cancelamento, representa os dados do cancelamento
+  #
+  # @attr [String] code Código do cancelamento
+  # @attr [String] message Mensagem do cancelamento
+  # @attr [String] date_time Data e hora do cancelamento
+  # @attr [Number] total Valor cancelado
+  class Cancellation
+    attr_accessor :code,
+                  :message,
+                  :date_time,
+                  :total
+  end
+end

data/lib/cielo/ws15/cancellation_message.rb

@@ -0,0 +1,32 @@
+require "nokogiri"
+require "cielo/ws15/message"
+
+module Cielo::WS15Message
+  class CancellationMessage
+    include Cielo::WS15Message
+
+    def serialize(transaction, total = nil)
+      builder = Nokogiri::XML::Builder.new(:encoding => "ISO-8859-1") do |xml|
+        xml.send("requisicao-cancelamento",
+                     "xmlns" => Cielo::WS15::NAMESPACE,
+                     "versao" => Cielo::WS15::VERSION,
+                     "id" => transaction.order.number) {
+
+            xml.send("tid", transaction.tid)
+
+            Cielo::WS15Message.serialize_dados_ec(xml, transaction.merchant)
+
+            if total != nil
+              xml.send("valor", total)
+            end
+        }
+      end
+
+      return builder.to_xml
+    end
+
+    def unserialize(message, transaction)
+      return Cielo::WS15Message.unserialize_transaction(message, transaction)
+    end
+  end
+end

data/lib/cielo/ws15/capture.rb

@@ -0,0 +1,14 @@
+module Cielo
+  # Em casos de captura, representa os dados da captura.
+  #
+  # @attr [String] code Código da captura
+  # @attr [String] message Mensagem da captura
+  # @attr [String] date_time Data e hora da captura
+  # @attr [Number] total Valor capturado
+  class Capture
+    attr_accessor :code,
+                  :message,
+                  :date_time,
+                  :total
+  end
+end

data/lib/cielo/ws15/capture_message.rb

@@ -0,0 +1,32 @@
+require "nokogiri"
+require "cielo/ws15/message"
+
+module Cielo::WS15Message
+  class CaptureMessage
+    include Cielo::WS15Message
+
+    def serialize(transaction, total = nil)
+      builder = Nokogiri::XML::Builder.new(:encoding => "ISO-8859-1") do |xml|
+        xml.send("requisicao-captura",
+                     "xmlns" => Cielo::WS15::NAMESPACE,
+                     "versao" => Cielo::WS15::VERSION,
+                     "id" => transaction.order.number) {
+
+            xml.send("tid", transaction.tid)
+
+            Cielo::WS15Message.serialize_dados_ec(xml, transaction.merchant)
+
+            if total != nil
+              xml.send("valor", total)
+            end
+        }
+      end
+
+      return builder.to_xml
+    end
+
+    def unserialize(message, transaction)
+      return Cielo::WS15Message.unserialize_transaction(message, transaction)
+    end
+  end
+end

data/lib/cielo/ws15/holder.rb

@@ -0,0 +1,55 @@
+module Cielo
+  # Dados do portador
+  #
+  # @attr [String] token Token único do cartão
+  # @attr [String] number Número do cartão
+  # @attr [String] expiration Data de expiração do cartão
+  # @attr [Number] indicator Indicador do código de segurança do cartão
+  # @attr [String] cvv Código de segurança do cartão
+  # @attr [String] name Nome do portador do cartão
+  class Holder
+    # Indica que o CVV não foi informado
+    CVV_NOT_INFORMED = 0
+
+    # Indica que o CVV foi informado
+    CVV_INFORMED = 1
+
+    # Indica que o CVV não estava legível
+    CVV_UNREADABLE = 2
+
+    # Indica que existe um CVV
+    CVV_NONEXISTENT = 9
+
+    attr_accessor :token,
+                  :number,
+                  :expiration,
+                  :indicator,
+                  :cvv,
+                  :name
+
+    # Inicializa uma nova instância de Holder, que representa o portador de um
+    # cartão, definindo os dados do cartão ou apenas um token previamente gerado
+    #
+    # @param token_or_number [String] token ou o número do cartão do cliente
+    # @param expiration_year [String] ano de expiração do cartão
+    # @param expiration_month [String] mês de expiração do cartão
+    # @param indicator [Number] indicador de visibilidade do código de segurança
+    # @param cvv [String] Código de segurança do cartão
+    def initialize(
+      token_or_number,
+      expiration_year = nil,
+      expiration_month = nil,
+      indicator = nil,
+      cvv = Holder::CVV_NOT_INFORMED)
+
+      if (expiration_year == nil)
+        @token = token_or_number
+      else
+        @number = token_or_number
+        @expiration = "#{expiration_year}#{expiration_month}"
+        @indicator = indicator
+        @cvv = cvv
+      end
+    end
+  end
+end

data/lib/cielo/ws15/merchant.rb

@@ -0,0 +1,20 @@
+module Cielo
+  # Dados do estabelecimento comercial
+  #
+  # @attr [String] affiliation_id Número de afiliação na Cielo
+  # @attr [String] affiliation_key Chave de afiliação
+  class Merchant
+    attr_accessor :affiliation_id,
+                  :affiliation_key
+
+
+    # Inicializa uma nova instância de Merchat
+    #
+    # @param affiliation_id [String] Número de afiliação na Cielo
+    # @param affiliation_key [String] Chave de afiliação
+    def initialize(affiliation_id, affiliation_key)
+      @affiliation_id = affiliation_id
+      @affiliation_key = affiliation_key
+    end
+  end
+end

data/lib/cielo/ws15/message.rb

@@ -0,0 +1,110 @@
+require "nokogiri"
+require "cielo/ws15/authentication"
+require "cielo/ws15/authorization"
+require "cielo/ws15/capture"
+require "cielo/ws15/cancellation"
+require "cielo/ws15/token"
+
+# Helper para serialização e deserialização dos XML de requisição e resposta
+module Cielo::WS15Message
+  def self.serialize_dados_ec(xml, merchant)
+    xml.send("dados-ec") {
+      xml.send("numero", merchant.affiliation_id)
+      xml.send("chave", merchant.affiliation_key)
+    }
+  end
+
+  def self.unserialize_transaction(message, transaction)
+    document = document = load_document(message)
+
+    check_error(document)
+
+    transaction.tid = document.xpath("//transacao/tid").text
+    transaction.pan = document.xpath("//transacao/pan").text
+
+    transaction.order = Cielo::Order.new(
+      document.xpath("//transacao/dados-pedido/numero").text,
+      document.xpath("//transacao/dados-pedido/valor").text.to_i,
+      document.xpath("//transacao/dados-pedido/moeda").text.to_i,
+      document.xpath("//transacao/dados-pedido/data-hora").text
+    )
+
+    transaction.order.description = document.xpath("//transacao/dados-pedido/descricao").text
+    transaction.order.language = document.xpath("//transacao/dados-pedido/idioma").text
+    transaction.order.shipping = document.xpath("//transacao/dados-pedido/taxa-embarque").text.to_i
+
+    transaction.payment_method = Cielo::PaymentMethod.new(
+      document.xpath("//transacao/forma-pagamento/bandeira").text,
+      document.xpath("//transacao/forma-pagamento/produto").text,
+      document.xpath("//transacao/forma-pagamento/parcelas").text.to_i
+    )
+
+    transaction.authentication = Cielo::Authentication.new
+    transaction.authentication.code = document.xpath("//transacao/autenticacao/codigo").text
+    transaction.authentication.message = document.xpath("//transacao/autenticacao/mensagem").text
+    transaction.authentication.date_time = document.xpath("//transacao/autenticacao/data-hora").text
+    transaction.authentication.total = document.xpath("//transacao/autenticacao/valor").text
+    transaction.authentication.eci = document.xpath("//transacao/autenticacao/eci").text
+
+    transaction.authorization = Cielo::Authorization.new
+    transaction.authorization.code = document.xpath("//transacao/autorizacao/codigo").text
+    transaction.authorization.message = document.xpath("//transacao/autorizacao/mensagem").text
+    transaction.authorization.date_time = document.xpath("//transacao/autorizacao/data-hora").text
+    transaction.authorization.total = document.xpath("//transacao/autorizacao/valor").text
+    transaction.authorization.lr = document.xpath("//transacao/autorizacao/lr").text
+    transaction.authorization.arp = document.xpath("//transacao/autorizacao/arp").text
+    transaction.authorization.nsu = document.xpath("//transacao/autorizacao/nsu").text
+
+    transaction.capture = Cielo::Capture.new
+    transaction.capture.code = document.xpath("//transacao/captura/codigo").text
+    transaction.capture.message = document.xpath("//transacao/captura/mensagem").text
+    transaction.capture.date_time = document.xpath("//transacao/captura/data-hora").text
+    transaction.capture.total = document.xpath("//transacao/captura/valor").text
+
+    transaction.cancellation = Array.new
+
+    document.xpath("//transacao/cancelamentos/cancelamento").each do |cancelamento|
+      cancellation = Cielo::Cancellation.new
+
+      cancellation.code = cancelamento.xpath('.//codigo').text
+      cancellation.message = cancelamento.xpath('.//mensagem').text
+      cancellation.date_time = cancelamento.xpath('.//data-hora').text
+      cancellation.total = cancelamento.xpath('.//valor').text
+
+      transaction.cancellation << cancellation
+    end
+
+    transaction.token = unserialize_token(message, document)
+
+    return transaction
+  end
+
+  def self.unserialize_token(message, document = nil)
+    if document == nil
+      document = load_document(message)
+    end
+
+    token = Cielo::Token.new
+
+    token.code = document.xpath(".//token/dados-token/codigo-token").text
+    token.status = document.xpath(".//token/dados-token/status").text
+    token.number = document.xpath(".//token/dados-token/numero-cartao-truncado").text
+
+    return token
+  end
+
+  private
+  def self.check_error(document)
+    code = document.xpath(".//erro/codigo").text
+    message = document.xpath(".//erro/mensagem").text
+
+    raise "Erro[#{code}]: #{message}" unless code == ""
+  end
+
+  def self.load_document(message)
+    document = Nokogiri::XML(message)
+    document.remove_namespaces!
+
+    return document
+  end
+end

data/lib/cielo/ws15/order.rb

@@ -0,0 +1,49 @@
+module Cielo
+  class Order
+    # Dados do estabelecimento comercial
+    #
+    # @attr [String] number Número do pedido na plataforma da loja
+    # @attr [Number] total Valor do pedido em centavos
+    # @attr [Number] Código ISO da moeda; 986 para Real
+    # @attr [String] date_time Data e hora do pedido
+    # @attr [String] description Descrição do pedido
+    # @attr [String] language Idioma do pedido; PT para português
+    # @attr [Number] shipping Valor do frete em centavos
+    # @attr [String] soft_descriptor Nome de exibição na fatura do cartão
+    attr_accessor :number,
+                  :total,
+                  :currency,
+                  :date_time,
+                  :description,
+                  :language,
+                  :shipping,
+                  :soft_descriptor
+
+    # Inicializa uma instância de Order informando o número do pedido, valor,
+    # moeda e data de criação.
+    #
+    # @param number [String] Número do pedido na plataforma da loja
+    # @param total [Number] Valor total do pedido em centavos
+    # @param currency [Number] Código ISO que representa a moeda; 986 para Real
+    # @param date_time [String] Data e hora do pedido na plataforma da loja
+    def initialize(
+      number = 0,
+      total = 0,
+      currency = 986,
+      date_time = nil)
+
+      if (date_time == nil)
+        now = Time.now
+
+        date_time = now.strftime("%Y-%m-%dT%H:%M:%S")
+      end
+
+      @number = number
+      @total = total
+      @currency = currency
+      @language = "PT"
+      @date_time = date_time
+      @shipping = 0
+    end
+  end
+end

data/lib/cielo/ws15/payment_method.rb

@@ -0,0 +1,64 @@
+module Cielo
+  # Forma de pagamento da transação
+  #
+  # @attr [String] issuer Banco emissor do cartão
+  # @attr [String] product Produto da Cielo utilizado
+  # @attr [Number] installments Número de parcelas
+  class PaymentMethod
+    # Cartão Visa
+    VISA = "visa"
+
+    # Cartão Mastercard
+    MASTERCARD = "mastercard"
+
+    # Cartão Diners
+    DINERS = "diners"
+
+    # Cartão Discover
+    DISCOVER = "discover"
+
+    # Cartão ELO
+    ELO = "elo"
+
+    # Cartão Amex
+    AMEX = "amex"
+
+    # Cartão JCB
+    JCB = "jcb"
+
+    # Cartão Aura
+    AURA = "aura"
+
+    # Pagamento com cartão de crédito à vista
+    CREDITO_A_VISTA = 1
+
+    # Pagamento com cartão de crédito parcelado pela loja
+    PARCELADO_LOJA = 2
+
+    # Pagamento com cartão de crédito parcelado pela administradora
+    PARCELADO_ADM = 3
+
+    # Pagamento com cartão de débito
+    DEBITO = "A"
+
+    attr_accessor :issuer,
+                  :product,
+                  :installments
+
+    # Inicializa uma instância de PaymentMethod informando o banco emissor do
+    # cartão, produto Cielo e número de parcelas.
+    #
+    # @param issuer [String] Banco emissor do cartão
+    # @param product [String] Produto Cielo que será utilizado
+    # @param installments [Number] Número de parcelas; 1 para transação à vista
+    def initialize(
+      issuer,
+      product = PaymentMethod::CREDITO_A_VISTA,
+      installments = 1)
+
+      @issuer = issuer
+      @product = product
+      @installments = installments
+    end
+  end
+end

data/lib/cielo/ws15/token.rb

@@ -0,0 +1,12 @@
+module Cielo
+  # Dados do token do cartão
+  #
+  # @attr [String] code Código do token para ser utilizado em outras transações
+  # @attr [Number] status Status do token
+  # @attr [String] Número do cartão truncado
+  class Token
+    attr_accessor :code,
+                  :status,
+                  :number
+  end
+end

data/lib/cielo/ws15/token_message.rb

@@ -0,0 +1,35 @@
+require "nokogiri"
+require "uuidtools"
+require "cielo/ws15/message"
+
+module Cielo::WS15Message
+  class TokenMessage
+    include Cielo::WS15Message
+
+    def serialize(merchant, holder)
+      builder = Nokogiri::XML::Builder.new(:encoding => "ISO-8859-1") do |xml|
+        xml.send("requisicao-token",
+                     "xmlns" => Cielo::WS15::NAMESPACE,
+                     "versao" => Cielo::WS15::VERSION,
+                     "id" => UUIDTools::UUID.random_create) {
+
+            Cielo::WS15Message.serialize_dados_ec(xml, merchant)
+
+            xml.send("dados-portador") {
+                xml.send("numero", holder.number)
+                xml.send("validade", holder.expiration)
+                xml.send("indicador", holder.indicator)
+                xml.send("codigo-seguranca", holder.cvv)
+                xml.send("nome-portador", holder.name)
+            }
+        }
+      end
+
+      return builder.to_xml
+    end
+
+    def unserialize(message)
+      return Cielo::WS15Message.unserialize_token(message)
+    end
+  end
+end

data/lib/cielo/ws15/transaction.rb

@@ -0,0 +1,90 @@
+module Cielo
+  # Representação de uma transação
+  #
+  # @attr [String] tid ID da transação
+  # @attr [String] pan Código PAN da transação
+  # @attr [Number] status Código de status da transação
+  # @attr [String] authentication_url URL de redirecionamento à Cielo
+  # @attr [Authentication] authentication Dados da autenticação
+  # @attr [Authorizarion] authorizarion Dados da autorização
+  # @attr [Merchant] merchant Dados do estabelecimento comercial
+  # @attr [Holder] holder Dados do portador do cartão
+  # @attr [Order] order Dados do pedido na plataforma da loja
+  # @attr [PaymentMethod] payment_method Dados da forma de pagamento
+  # @attr [String] return_url URL de redirecionamento da Cielo para a loja
+  # @attr [Number] authorize Método de autorização
+  # @attr [Boolean] do_capture Indica se a captura deve ser automática ou não
+  # @attr [Capture] capture Dados da captura
+  # @attr [String] free_field Campo livre
+  # @attr [String] bin Seis primeiros dígitos do cartão
+  # @attr [Boolean] generate_token Se um token deve ser gerado para o cartão
+  # @attr [String] avs Bloco XML contendo informações necessárias para realizar a consulta ao serviço
+  # @attr [Token] token Dados do token
+  # @attr [Array<Cancellation>] cancellation Lista de cancelamentos ocorridos
+  class Transaction
+    # Apenas autentica a transação
+    ONLY_AUTHENTICATE = 0
+
+    # Autoriza a transação apenas se tiver sido autenticada
+    AUTHORIZE_IF_AUTHENTICATED = 1
+
+    # Autoriza a transação
+    AUTHORIZE = 2
+
+    # Autorização direta, sem autenticação
+    AUTHORIZE_WITHOUT_AUTHENTICATION = 3
+
+    # Autorização para recorrência
+    RECURRENCE = 4
+
+    attr_accessor :tid,
+                  :pan,
+                  :status,
+                  :authentication_url,
+                  :authentication,
+                  :authorization,
+                  :merchant,
+                  :holder,
+                  :order,
+                  :payment_method,
+                  :return_url,
+                  :authorize,
+                  :do_capture,
+                  :capture,
+                  :free_field,
+                  :bin,
+                  :generate_token,
+                  :avs,
+                  :token,
+                  :cancellation
+
+    # Inicializa uma instância de Transaction informando os dados do estabelecimento,
+    # portador do cartão, pedido, forma de pagamento, URL de retorno, método
+    # de autorização e forma de captura.
+    #
+    # @param merchant [Merchant] Dados do estabelecimento comercial
+    # @param holder [Holder] Portador do cartão
+    # @param order [Order] Dados do pedido
+    # @param payment_method [PaymentMethod] Forma de pagamento
+    # @param return_url [String] URL de retorno
+    # @param authorize [Number] Método de autorização
+    # @param capture [Boolean] Se a transação deve ser capturada automaticamente
+    def initialize(
+      merchant,
+      holder,
+      order,
+      payment_method,
+      return_url,
+      authorize,
+      capture: true)
+
+      @merchant = merchant
+      @holder = holder
+      @order = order
+      @payment_method = payment_method
+      @return_url = return_url
+      @authorize = authorize
+      @do_capture = capture
+    end
+  end
+end

data/lib/cielo/ws15/transaction_message.rb

@@ -0,0 +1,68 @@
+require "nokogiri"
+require "cielo/ws15/message"
+
+module Cielo::WS15Message
+  class TransactionMessage
+    include Cielo::WS15Message
+
+    def serialize(transaction)
+      builder = Nokogiri::XML::Builder.new(:encoding => "ISO-8859-1") do |xml|
+        xml.send("requisicao-transacao",
+                     "xmlns" => Cielo::WS15::NAMESPACE,
+                     "versao" => Cielo::WS15::VERSION,
+                     "id" => transaction.order.number) {
+
+            Cielo::WS15Message.serialize_dados_ec(xml, transaction.merchant)
+
+            xml.send("dados-portador") {
+              if transaction.holder.token != nil
+                xml.send("token", transaction.holder.token)
+              else
+                xml.send("numero", transaction.holder.number)
+                xml.send("validade", transaction.holder.expiration)
+                xml.send("indicador", transaction.holder.indicator)
+                xml.send("codigo-seguranca", transaction.holder.cvv)
+                xml.send("nome-portador", transaction.holder.name)
+              end
+            }
+
+            xml.send("dados-pedido") {
+              xml.send("numero", transaction.order.number)
+              xml.send("valor", transaction.order.total)
+              xml.send("moeda", transaction.order.currency)
+              xml.send("data-hora", transaction.order.date_time)
+              xml.send("descricao", transaction.order.description)
+              xml.send("idioma", transaction.order.language)
+              xml.send("taxa-embarque", transaction.order.shipping)
+              xml.send("soft-descriptor", transaction.order.soft_descriptor)
+            }
+
+            xml.send("forma-pagamento") {
+              xml.send("bandeira", transaction.payment_method.issuer)
+              xml.send("produto", transaction.payment_method.product)
+              xml.send("parcelas", transaction.payment_method.installments)
+            }
+
+            xml.send("url-retorno", transaction.return_url)
+            xml.send("autorizar", transaction.authorize)
+            xml.send("capturar", transaction.do_capture)
+            xml.send("campo-livre", transaction.free_field)
+
+            if transaction.bin != nil
+              xml.send("bin", transaction.bin)
+            end
+
+            if transaction.generate_token != nil
+              xml.send("gerar-token", transaction.generate_token)
+            end
+        }
+      end
+
+      return builder.to_xml
+    end
+
+    def unserialize(message, transaction)
+      return Cielo::WS15Message.unserialize_transaction(message, transaction)
+    end
+  end
+end

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification
+name: cielo-ws15
+version: !ruby/object:Gem::Version
+  version: 1.3.0
+platform: ruby
+authors:
+- Cielo
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-01-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: uuidtools
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+description: Integração com o webservice 1.5 da Cielo
+email:
+- cieloecommerce@cielo.com.br
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/cielo/ws15.rb
+- lib/cielo/ws15/authentication.rb
+- lib/cielo/ws15/authorization.rb
+- lib/cielo/ws15/authorization_message.rb
+- lib/cielo/ws15/cancellation.rb
+- lib/cielo/ws15/cancellation_message.rb
+- lib/cielo/ws15/capture.rb
+- lib/cielo/ws15/capture_message.rb
+- lib/cielo/ws15/holder.rb
+- lib/cielo/ws15/merchant.rb
+- lib/cielo/ws15/message.rb
+- lib/cielo/ws15/order.rb
+- lib/cielo/ws15/payment_method.rb
+- lib/cielo/ws15/token.rb
+- lib/cielo/ws15/token_message.rb
+- lib/cielo/ws15/transaction.rb
+- lib/cielo/ws15/transaction_message.rb
+homepage: https://github.com/DeveloperCielo/Webservice-1.5-ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.5
+signing_key: 
+specification_version: 4
+summary: SDK Webservice 1.5
+test_files: []
+has_rdoc: yard