tray-checkout 0.0.0 → 0.0.1

data/CHANGELOG.rdoc

@@ -1,2 +1,5 @@
+== Version 0.0.1
+- First stable version.
+
 == Version 0.0.0
 - First version, unstable yet.

data/README.rdoc

@@ -7,6 +7,7 @@ Tray Checkout API
 === Gemfile
   gem 'tray-checkout'
 
+
 === Direct installation
   $ gem install tray-checkout
 
@@ -15,7 +16,91 @@ Tray Checkout API
 
   require 'tray-checkout'
 
-  t = Tray::Checkout::Transaction.new
+  transaction = Tray::Checkout::Transaction.new
+
+Getting an existing transaction:
+  txn = transaction.get("522045453u5uu32e0u8014f060uuu5uu")
+  txn[:success]               # => true
+  txn[:transaction_token]     # => "522045453u5uu32e0u8014f060uuu5uu"
+  txn[:transaction_id]        # => 501
+  txn[:status]                # => :waiting_payment
+  txn[:payment_method]        # => :boleto
+  txn[:price_payment]         # => 213.21
+  txn[:price_seller]          # => 199.19
+  txn[:split]                 # => 1
+  txn[:payment][:url_payment] # => "http://checkout.sandbox.tray.com.br/payment/billet/u9uuu8731319u59u3073u9011uu6u6uu"
+  txn[:date_transaction].strftime("%d/%m/%Y") # => "03/12/2012"
+
+When the transaction is not found:
+  txn = transaction.get("xxxxx00000yyyy")
+  txn[:success]                # => false
+  txn[:transaction_id]         # => nil
+  txn[:errors].first[:code]    # => "003042"
+  txn[:errors].first[:message] # => "Transação não encontrada"
+
+Creating a successful transaction:
+  txn = transaction.create(
+    token_account: "949u5uu9ef36f7u",
+    customer: {
+      name: "Pedro Bonamides",
+      cpf: "18565842673",
+      email: "pedro@bo.com.br",
+      sex: :male,
+      marital_status: :single,
+      contacts: [
+        { contact_type: :home,
+          number_contact: "1142360873"
+        }
+      ],
+      addresses: [
+        { address_type: :billing,
+          street: "Avenida Pedro Alvares Cabral",
+          number: "123",
+          neighborhood: "Parque Ibirapuera",
+          postal_code: "04094050",
+          city: "São Paulo",
+          state: "SP"
+        }
+      ]
+    },
+    transaction: {
+      order_number: "R1245",
+      shipping_type: "Sedex",
+      shipping_price: 13.94,
+      url_notification: "http://prodis.blog.br/tray_notification"
+    },
+    transaction_product: [
+      { code: "LOGO-8278",
+        quantity: 2,
+        price_unit: 100.99,
+        description: "Logo Prodis"
+      },
+      { code: "877",
+        quantity: 1,
+        price_unit: 10.00,
+        description: "Outro produto"
+      }
+    ],
+    payment: {
+      payment_method: :mastercard,
+      split: 3,
+      card_name: "ZEFINHA NOCEGA",
+      card_number: "5105105105105100",
+      card_expdate_month: "09",
+      card_expdate_year: "2015",
+      card_cvv: "123"
+    }
+  )
+  txn[:success]             # => true
+  txn[:transaction_token]   # => "87654321u5uu92e4u09876543uuu5uu"
+  txn[:transaction_id]      # => 503
+  txn[:status]              # => :approved
+  txn[:status_name]         # => "Aprovada"
+  txn[:payment_method]      # => :mastercard
+  txn[:payment_method_name] # => "Mastercard"
+  txn[:price_payment]       # => 213.21
+  txn[:price_seller]        # => 199.19
+  txn[:date_payment].strftime("%d/%m/%Y") # => "05/12/2012"
 
 
 == Author

data/lib/tray/checkout/constants.rb

@@ -0,0 +1,53 @@
+# encoding: UTF-8
+
+module Tray
+  module Checkout
+    PAYMENT_METHOD = {
+      diners: 2,
+      visa: 3,
+      mastercard: 4,
+      american_express: 5,
+      boleto: 6,
+      itau_shopline: 7,
+      pagamento_com_saldo: 8,
+      peela: 14,
+      discover: 15,
+      elo: 16
+    }
+
+    TRANSACTION_STATUS = {
+      waiting_payment: 4,
+      processing: 5,
+      approved: 6,
+      canceled: 7,
+      disputing: 24,
+      monitoring: 87,
+      recovering: 88,
+      disapproved: 89
+    }
+
+    CONTACT_TYPE = {
+      home: "H",
+      mobile: "M",
+      work: "W"
+    }
+
+    ADDRESS_TYPE = {
+      billing: "B",
+      delivery: "D"
+    }
+
+    SEX = {
+      male: "M",
+      female: "F"
+    }
+
+    MARITAL_STATUS = {
+      single: "S",
+      married: "M",
+      separated: "A",
+      divorced: "D",
+      widowed: "W"
+    }
+  end
+end

data/lib/tray/checkout/hash.rb

@@ -0,0 +1,22 @@
+# encoding: UTF-8
+class Hash
+  def symbolize_all_keys!
+    symbolize_all_keys_in self
+  end
+
+  private
+
+  def symbolize_all_keys_in(hash)
+    case
+    when hash.is_a?(Array)
+      hash.each { |value| symbolize_all_keys_in(value) }
+    when hash.is_a?(Hash)
+      hash.symbolize_keys!
+
+      hash.each_value do |value|
+        value.symbolize_keys! if value.is_a?(Hash)
+        symbolize_all_keys_in(value)
+      end
+    end
+  end
+end

data/lib/tray/checkout/parser.rb

@@ -5,48 +5,94 @@ module Tray
   module Checkout
     class Parser
       def response(xml)
-        puts xml
-        hash = convert_to_hash(xml)
-        success?(hash) ? data(hash) : errors(hash)
+        create_response_from(xml)
+        success? ? data : errors
+      end
+
+      def payment_params!(params)
+        customer_params_types! params[:customer]
+        payment_params_types! params[:payment]
+
+        params
       end
 
       private
 
-      def convert_to_hash(xml)
-        symbolize_all_keys!(Hash.from_xml(xml))[:transaction]
+      def customer_params_types!(customer)
+        return unless customer
+        customer[:gender] = SEX[customer[:sex]] if customer[:sex]
+        customer[:relationship] = MARITAL_STATUS[customer[:marital_status]] if customer[:marital_status]
+        contacts_params_types! customer[:contacts]
+        addresses_params_types! customer[:addresses]
       end
 
-      def success?(hash)
-        hash[:message_response][:message] == "success"
+      def payment_params_types!(payment)
+        return unless payment
+        payment[:payment_method_id] = PAYMENT_METHOD[payment[:payment_method]] if payment[:payment_method]
+      end
+
+      def contacts_params_types!(contacts)
+        return unless contacts
+
+        contacts.each do |contact|
+          contact[:type_contact] = CONTACT_TYPE[contact[:contact_type]] if contact[:contact_type]
+        end
       end
 
-      def data(hash)
-        hash[:data_response]
+      def addresses_params_types!(addresses)
+        return unless addresses
+
+        addresses.each do |address|
+          address[:type_address] = ADDRESS_TYPE[address[:address_type]] if address[:address_type]
+        end
       end
 
-      def errors(hash)
-        hash[:error_response]
+      def create_response_from(xml)
+        @response = Hash.from_xml(xml).symbolize_all_keys![:transaction]
       end
 
-      def symbolize_all_keys!(hash)
-        #TODO: Move to Hash class.
-        case
-        when hash.is_a?(Array)
-          puts "### Array #{hash}"
-          puts
-          hash.each { |value| symbolize_all_keys!(value) }
-        when hash.is_a?(Hash)
-          puts "$$$ Hash: #{hash}"
-          puts
-          hash.symbolize_keys!
+      def success?
+        @response[:message_response][:message] == "success"
+      end
 
-          hash.each_value do |value|
-            value.symbolize_keys! if value.is_a?(Hash)
-            symbolize_all_keys!(value)
-          end
+      def data
+        data_response = @response[:data_response][:transaction]
+        transaction_response_types! data_response
+        payment_response_types! data_response
+        date_to_time! data_response
+        data_response[:success] = true
+        data_response
+      end
+
+      def transaction_response_types!(transaction)
+        transaction[:payment_method] = PAYMENT_METHOD.invert[transaction[:payment_method_id]]
+        transaction[:status] = TRANSACTION_STATUS.invert[transaction[:status_id]]
+      end
+
+      def payment_response_types!(transaction)
+        payment = transaction[:payment]
+        payment[:payment_method] = PAYMENT_METHOD.invert[payment[:payment_method_id]]
+      end
+
+      def errors
+        error_response = @response[:error_response]
+
+        if error_response[:validation_errors]
+          error_response[:errors] = error_response.delete(:validation_errors)
         end
 
-        hash
+        error_response[:success] = false
+        error_response
+      end
+
+      def date_to_time!(hash)
+        hash.each do |key, value|
+          date_to_time!(value) if value.is_a?(Hash)
+
+          if key.to_s.starts_with?("date_") && value
+            hash[key] = (value.to_time rescue value) || value
+          end
+        end
       end
     end
   end

data/lib/tray/checkout/transaction.rb

@@ -6,8 +6,12 @@ module Tray
 
       def get(token)
         response = web_service.request!("#{URL}/get_by_token", { token: token })
-        result = parser.response(response)
-        result
+        parser.response(response)
+      end
+
+      def create(params)
+        response = web_service.request!("#{URL}/pay_complete", parser.payment_params!(params))
+        parser.response(response)
       end
 
       private

data/lib/tray/checkout/version.rb

@@ -1,7 +1,7 @@
 # encoding: UTF-8
 module Tray
   module Checkout
-    VERSION = "0.0.0"
+    VERSION = "0.0.1"
   end
 end
 

data/lib/tray/checkout/web_service.rb

@@ -1,4 +1,5 @@
 # encoding: UTF-8
+require 'active_support/core_ext'
 require 'net/http'
 require 'uri'
 
@@ -24,7 +25,7 @@ module Tray
 
       def build_request(uri, params)
         request = Net::HTTP::Post.new(uri.path)
-        request.set_form_data(params)
+        request.body = params.to_param
         request
       end
     end

data/lib/tray-checkout.rb

@@ -1,6 +1,8 @@
 # encoding: UTF-8
 require 'rubygems'
 require 'tray/checkout'
+require 'tray/checkout/constants'
+require 'tray/checkout/hash'
 require 'tray/checkout/parser'
 require 'tray/checkout/transaction'
 require 'tray/checkout/web_service'

data/spec/support/mock_request.rb

@@ -0,0 +1,23 @@
+# encoding: UTF-8
+
+def mock_request_for(response)
+  url = Regexp.new(Tray::Checkout::Transaction::URL)
+  WebMock::API.stub_request(:post, url).to_return(:status => 200, :body => body_for(response))
+end
+
+def body_for(response)
+  case response
+  when :get_success_boleto,
+       :get_failure_not_found,
+       :create_success_boleto,
+       :create_success_mastercard,
+       :create_failure_validation_errors
+    read_file_for(response)
+  else
+    response
+  end
+end
+
+def read_file_for(filename)
+  File.open("#{File.dirname(__FILE__)}/responses/#{filename}.xml").read
+end

data/spec/support/responses/create_failure_validation_errors.xml

@@ -0,0 +1,51 @@
+<transaction>
+  <message_response>
+    <message>error</message>
+  </message_response>
+  <error_response>
+    <validation_errors type="array">
+      <validation_error>
+        <code>1</code>
+        <message_complete>Tipo n&#227;o pode ficar em branco</message_complete>
+        <message>n&#227;o pode ficar em branco</message>
+        <field>person_addresses.type_address</field>
+      </validation_error>
+      <validation_error>
+        <code>1</code>
+        <message_complete>Logradouro (Rua, Av, Travessa...) n&#227;o pode ficar em branco</message_complete>
+        <message>n&#227;o pode ficar em branco</message>
+        <field>person_addresses.street</field>
+      </validation_error>
+      <validation_error>
+        <code>1</code>
+        <message_complete>Cep n&#227;o pode ficar em branco</message_complete>
+        <message>n&#227;o pode ficar em branco</message>
+        <field>person_addresses.postal_code</field>
+      </validation_error>
+      <validation_error>
+        <code>1</code>
+        <message_complete>Cidade n&#227;o pode ficar em branco</message_complete>
+        <message>n&#227;o pode ficar em branco</message>
+        <field>person_addresses.city</field>
+      </validation_error>
+      <validation_error>
+        <code>1</code>
+        <message_complete>UF n&#227;o pode ficar em branco</message_complete>
+        <message>n&#227;o pode ficar em branco</message>
+        <field>person_addresses.state</field>
+      </validation_error>
+      <validation_error>
+        <code>1</code>
+        <message_complete>N&#250;mero, Lote n&#227;o pode ficar em branco</message_complete>
+        <message>n&#227;o pode ficar em branco</message>
+        <field>person_addresses.number</field>
+      </validation_error>
+      <validation_error>
+        <code>1</code>
+        <message_complete>Bairro n&#227;o pode ficar em branco</message_complete>
+        <message>n&#227;o pode ficar em branco</message>
+        <field>person_addresses.neighborhood</field>
+      </validation_error>
+    </validation_errors>
+  </error_response>
+</transaction>