akatus 0.1.0 → 1.0.0

data/spec/factories/item_factories.rb

@@ -0,0 +1,35 @@
+FactoryGirl.define do
+
+  factory :item, :class => Akatus::Item do
+
+    reference     'ABC1234567'
+    description   'Caixa de bombons sortidos'
+    quantity      32
+    price         BigDecimal.new('32.25')
+    weight        BigDecimal.new('2.25')
+    shipping_cost BigDecimal.new('9.90')
+    discount      0
+
+    trait :with_percentage_split_fee do
+      split_fee {
+        Akatus::SplitFee.new({
+          :receiver => 'ze@hotmail.com',
+          :type     => 'porcentagem',
+          :amount   => 20
+        })
+      }
+    end
+
+    trait :with_fixed_split_fee do
+      split_fee {
+        Akatus::SplitFee.new({
+          :receiver => 'ze@hotmail.com',
+          :type     => 'real',
+          :amount   => 20
+        })
+      }
+    end
+
+  end
+
+end

data/spec/factories/payer_factories.rb

@@ -0,0 +1,8 @@
+FactoryGirl.define do
+  factory :payer, :class => Akatus::Payer do
+    name   'Jose Antonio'
+    email  'ze@antonio.com.br'
+    address { build(:address) }
+    phone   { build(:phone) }
+  end
+end

data/spec/factories/phone_factories.rb

@@ -0,0 +1,6 @@
+FactoryGirl.define do
+  factory :phone, :class => Akatus::Phone do
+    type   'comercial'
+    number '1199999999'
+  end
+end

data/spec/item_spec.rb

@@ -0,0 +1,42 @@
+# encoding: utf-8
+
+describe Akatus::Item do
+
+  let(:attrs) {
+    {
+      :reference     => 'ABC1234567',
+      :description   => 'Caixa de bombons sortidos',
+      :quantity      => 32,
+      :price         => BigDecimal.new('32.2'),
+      :weight        => BigDecimal.new('2.25'),
+      :shipping_cost => BigDecimal.new(9),
+    }
+  }
+
+  let(:payload) {
+    {
+      'produto' => {
+        'codigo'     => 'ABC1234567',
+        'descricao'  => 'Caixa de bombons sortidos',
+        'quantidade' => '32',
+        'preco'      => '32.20',
+        'peso'       => '2.25',
+        'frete'      => '9.00',
+        'desconto'   => '0.00'
+      }
+    }
+  }
+
+  it_behaves_like Akatus::Transferrable
+
+  it "has default values" do
+
+    item = Akatus::Item.new
+    item.shipping_cost.should == 0
+    item.discount.should == 0
+    item.weight.should == 0
+    item.quantity.should == 1
+
+  end
+
+end

data/spec/payer_spec.rb

@@ -0,0 +1,31 @@
+# encoding: utf-8
+
+describe Akatus::Payer do
+
+  let(:attrs) {
+    {
+      :name    => 'Jose Antonio',
+      :email   => 'ze@antonio.com.br',
+      :phone   => build(:phone),
+      :address => build(:address)
+    }
+  }
+
+  let(:payload) {
+    {
+      'pagador' => {
+        'nome'    => 'Jose Antonio',
+        'email'   => 'ze@antonio.com.br',
+        'enderecos' => {
+          'endereco' => [ build(:address).to_payload(false) ]
+        },
+        'telefones' => {
+          'telefone' => [ build(:phone).to_payload(false) ]
+        }
+      }
+    }
+  }
+
+  it_behaves_like Akatus::Transferrable
+
+end

data/spec/phone_spec.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+
+describe Akatus::Phone do
+
+  let(:attrs) {
+    {
+      :type   => 'comercial',
+      :number => '1199999999'
+    }
+  }
+
+  let(:payload) {
+    {
+      'telefone' => {
+        'tipo'     => 'comercial',
+        'numero'   => '1199999999'
+      }
+    }
+  }
+
+  it_behaves_like Akatus::Transferrable
+
+end

data/spec/services/installments_spec.rb

@@ -0,0 +1,36 @@
+describe Akatus::Services::Installments do
+
+  it "fetches dummy installment options for transactions that don't support installments" do
+
+    p = Akatus::Payment.new
+    p.items << build(:item)
+    p.payment_method = Akatus::BoletoBancario.new
+
+    result = Akatus::Services::Installments.calculate(p)
+
+    result.description.should be_nil
+    result.taken_installments.should == 0
+    result.installments.size.should == 1
+
+    installment = result.installments.first
+    installment.quantity.should == 1
+    installment.unitary_amount.should == p.total_amount
+    installment.total_amount.should == p.total_amount
+
+  end
+
+  it "fetches installment options for transactions with credit card" do
+
+    p = Akatus::Payment.new
+    p.items << build(:item)
+    p.payment_method = Akatus::CreditCard.new(:brand => 'cartao_visa')
+
+    result = Akatus::Services::Installments.calculate(p)
+
+    result.description.length.should be > 0
+    result.taken_installments.should == 0
+    result.installments.size.should >= 0
+
+  end
+
+end

data/spec/services/payment_options_spec.rb

@@ -0,0 +1,22 @@
+describe Akatus::Services::PaymentOptions do
+
+  it 'fetches all available payment methods for an account' do
+    result = Akatus::Services::PaymentOptions.available
+
+    result.should be_a(Hash)
+    result.keys.reject { |k| [:boleto, :credit_card, :eft].include?(k) }.should be_empty
+  end
+
+  it 'fetches all available payment methods (with installments) for a payment' do
+
+    p = Akatus::Payment.new
+    p.items << build(:item)
+
+    r1 = Akatus::Services::PaymentOptions.available
+    r2 = Akatus::Services::PaymentOptions.available_with_installments(p)
+
+    r2.should be_a(Hash)
+    r2.keys.should == r1.keys
+  end
+
+end

data/spec/services/transaction_spec.rb

@@ -0,0 +1,80 @@
+describe Akatus::Services::Transaction do
+
+  let(:secondary_receiver) {
+    raise "You should replace this with a string containing a valid Akatus account e-mail"
+    # Example: "my-akatus-account@domain.com"
+  }
+
+  specify 'basic example' do
+
+    payment = Akatus::Payment.new({
+      :payer          => build(:payer),
+      :items          => [ build(:item) ],
+      :reference      => 'order#0001',
+      :payment_method => Akatus::BoletoBancario.new
+    })
+
+    Akatus::Services::Transaction.create(payment)
+
+    payment.id.to_s.length.should be > 0
+    payment.transaction_id.to_s.length.should be > 0
+    payment.url.to_s.length.should be > 0
+
+  end
+
+  specify 'payment with split fees I' do
+
+    payment = Akatus::Payment.new({
+      :payer          => build(:payer),
+      :items          => [ build(:item, :with_percentage_split_fee) ],
+      :reference      => 'order#0001',
+      :payment_method => Akatus::BoletoBancario.new
+    })
+
+    Akatus::Services::Transaction.create(payment)
+
+  end
+
+  specify 'payment with split fees II' do
+
+    payment = Akatus::Payment.new({
+      :payer          => build(:payer),
+      :reference      => 'order#0002',
+      :payment_method => Akatus::BoletoBancario.new
+    })
+
+    item1 = Akatus::Item.new({
+      :reference   => 'P01',
+      :description => 'P01',
+      :price       => 100,
+      :split_fee   => Akatus::SplitFee.new({
+        :receiver => secondary_receiver,
+        :type     => 'porcentagem',
+        :amount   => BigDecimal.new('12.2')
+      })
+    })
+
+    item2 = Akatus::Item.new({
+      :reference   => 'P02',
+      :description => 'P02',
+      :price       => 200,
+      :split_fee   => Akatus::SplitFee.new({
+        :receiver => secondary_receiver,
+        :type     => 'real',
+        :amount   => BigDecimal.new('3.33')
+      })
+    })
+
+    item3 = Akatus::Item.new({
+      :reference   => 'P03',
+      :description => 'P03',
+      :price       => 300
+    })
+
+    payment.items = [ item1, item2, item3 ]
+
+    Akatus::Services::Transaction.create(payment)
+
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,31 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+require_relative "../lib/akatus"
+
+require "factory_girl"
+
+# Require factories.
+Dir[File.expand_path("../factories/**/*.rb", __FILE__)].each { |f| require f }
+
+# Require supporting ruby files with custom matchers and macros, etc,
+# in spec/support/ and its subdirectories.
+Dir[File.expand_path("../support/**/*.rb", __FILE__)].each { |f| require f }
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+
+  config.include FactoryGirl::Syntax::Methods
+end

data/spec/support/configuration.rb

@@ -0,0 +1,7 @@
+Akatus.config.api_key = "PLEASE-REPLACE-ME"
+Akatus.config.email   = "PLEASE-REPLACE-ME"
+Akatus.config.sandbox = true
+
+if Akatus.config.email == "PLEASE-REPLACE-ME"
+  raise "Please replace the values above with your actual account information"
+end

data/spec/support/shared_examples/transferrable_example.rb

@@ -0,0 +1,22 @@
+shared_examples_for Akatus::Transferrable do
+
+  it "can be initialized with attributes" do
+
+    obj = described_class.new(attrs)
+
+    attrs.each do |attr, value|
+      obj.send(attr).should == value
+    end
+
+  end
+
+  it "can be turned into a JSON payload" do
+
+    obj = described_class.new(attrs)
+
+    obj.to_payload.should == payload
+    obj.to_payload(false).should == payload.values.first
+
+  end
+
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: akatus
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Kauplus
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-11-25 00:00:00.000000000 Z
+date: 2014-01-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -24,6 +24,48 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: i18n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -38,6 +80,34 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: debugger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: factory_girl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4.3'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -52,26 +122,72 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: A gem foi criada para suportar todas as integrações de pagamentos da
-  Akatus.
-email:
-- tech@kauplus.com.br
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.14'
+description: Built to support all types of checkout integration between Akatus and
+  your application
+email: tech@kauplus.com.br
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- .rspec
 - Gemfile
 - LICENSE
-- LICENSE.txt
 - README.md
 - Rakefile
 - akatus.gemspec
+- config/i18n.rb
 - lib/akatus.rb
-- lib/akatus/configuracao.rb
-- lib/akatus/formatadores.rb
+- lib/akatus/address.rb
+- lib/akatus/configuration.rb
+- lib/akatus/errors.rb
+- lib/akatus/formatters.rb
+- lib/akatus/installment.rb
+- lib/akatus/installment_options.rb
+- lib/akatus/item.rb
+- lib/akatus/payer.rb
+- lib/akatus/payment.rb
+- lib/akatus/payment_option.rb
+- lib/akatus/payment_types.rb
+- lib/akatus/phone.rb
+- lib/akatus/receiver.rb
+- lib/akatus/service.rb
+- lib/akatus/services/installments.rb
+- lib/akatus/services/payment_options.rb
+- lib/akatus/services/transaction.rb
+- lib/akatus/split_fee.rb
+- lib/akatus/transferrable.rb
 - lib/akatus/version.rb
-homepage: ''
+- locales/pt-BR.yml
+- spec/address_spec.rb
+- spec/factories/address_factories.rb
+- spec/factories/item_factories.rb
+- spec/factories/payer_factories.rb
+- spec/factories/phone_factories.rb
+- spec/item_spec.rb
+- spec/payer_spec.rb
+- spec/phone_spec.rb
+- spec/services/installments_spec.rb
+- spec/services/payment_options_spec.rb
+- spec/services/transaction_spec.rb
+- spec/spec_helper.rb
+- spec/support/configuration.rb
+- spec/support/shared_examples/transferrable_example.rb
+homepage: http://github.com/kauplus/akatus
 licenses:
 - MIT
 metadata: {}
@@ -94,5 +210,19 @@ rubyforge_project:
 rubygems_version: 2.0.3
 signing_key: 
 specification_version: 4
-summary: Gem de integração com o meio de pagamentos Akatus
-test_files: []
+summary: Ruby gem for the Akatus payment system
+test_files:
+- spec/address_spec.rb
+- spec/factories/address_factories.rb
+- spec/factories/item_factories.rb
+- spec/factories/payer_factories.rb
+- spec/factories/phone_factories.rb
+- spec/item_spec.rb
+- spec/payer_spec.rb
+- spec/phone_spec.rb
+- spec/services/installments_spec.rb
+- spec/services/payment_options_spec.rb
+- spec/services/transaction_spec.rb
+- spec/spec_helper.rb
+- spec/support/configuration.rb
+- spec/support/shared_examples/transferrable_example.rb