akatus 0.1.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 514abcc9277c34932a4bf2e95a887b0797599388
-  data.tar.gz: 73fac7d238d4fa69bf3d9f9a729c74d8925e3172
+  metadata.gz: 3e6394b4c41ed3be9c9d2e2c255926b7e94e7947
+  data.tar.gz: d083c49f1117259999bbfaec106da9441c53e7a0
 SHA512:
-  metadata.gz: bef2bca5f2186a9ed7bd7004ee5311acf98f687858f9a977fed62e6a254c2abe5d7a46354a1b885eabb774950c057977a8540aaf95708b46aa4b5d652a7566d2
-  data.tar.gz: 33caa2a12d3e88f49f4532becdc212ebd8850354c4b3d837e33c7603c70861bf87ffe8acfe222ee1ddda6eb3e5e32134752cc59e24e0320210d05fcbbd49d200
+  metadata.gz: ca9f28c3bbfb32b77598d945bdfbd64cf18a4f6a49eb25740cf9e89e40ad95eb47f80eda86fa4188f5f7a621b40bbd09e0a82b407d0336fcaba92e0e01f6698c
+  data.tar.gz: 08dec081d6135e838f59568517ae3147824d3750b8e33b2db4fbdcddacf0e8c88c644b1abfe1146b4c280cb2b752b63fd1adb87f2b66c165326dd3ee35fccc62

data/.gitignore

@@ -1,17 +1,2 @@
-*.gem
-*.rbc
-.bundle
-.config
-.yardoc
+.DS_Store
 Gemfile.lock
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp

data/.rspec

@@ -0,0 +1,2 @@
+# Check "rspec --help" for more info on the options.
+--color --format d --require spec_helper

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2013 Kauplus
+Copyright (c) 2014 Kauplus
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

data/Rakefile

@@ -1 +1,6 @@
-require "bundler/gem_tasks"
+require 'bundler/gem_tasks'
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/akatus.gemspec

@@ -1,24 +1,31 @@
-# coding: utf-8
+# encoding: utf-8
 lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'akatus/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "akatus"
+  spec.name          = 'akatus'
   spec.version       = Akatus::VERSION
-  spec.authors       = ["Kauplus"]
-  spec.email         = ["tech@kauplus.com.br"]
-  spec.description   = %q{A gem foi criada para suportar todas as integrações de pagamentos da Akatus.}
-  spec.summary       = %q{Gem de integração com o meio de pagamentos Akatus}
-  spec.homepage      = ""
-  spec.license       = "MIT"
+  spec.author        = 'Kauplus'
+  spec.email         = 'tech@kauplus.com.br'
+  spec.description   = 'Built to support all types of checkout integration between Akatus and your application'
+  spec.summary       = 'Ruby gem for the Akatus payment system'
+  spec.homepage      = 'http://github.com/kauplus/akatus'
+  spec.license       = 'MIT'
 
   spec.files         = `git ls-files`.split($/)
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
 
   spec.add_dependency 'activesupport'
-  spec.add_development_dependency "bundler", "~> 1.3"
-  spec.add_development_dependency "rake"
+  spec.add_dependency 'i18n'
+  spec.add_dependency 'json'
+  spec.add_dependency 'rest-client'
+
+  spec.add_development_dependency 'bundler',      '~> 1.3'
+  spec.add_development_dependency 'debugger'
+  spec.add_development_dependency 'factory_girl', '~> 4.3'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec',        '~> 2.14'
 end

data/config/i18n.rb

@@ -0,0 +1,3 @@
+# Tell I18n where to find translation files.
+locales = File.expand_path(File.join(File.dirname(__FILE__), '..', 'locales', 'pt-BR.yml'))
+I18n.load_path << locales

data/lib/akatus.rb

@@ -1,6 +1,36 @@
-require "akatus/configuracao"
-require "akatus/formatadores"
-require "akatus/version"
+# External libraries
+require 'active_support/inflector'
+require 'active_support/number_helper'
+require 'bigdecimal'
+require 'i18n'
+require 'json'
+require 'rest-client'
+
+# Configuration and modules
+require 'akatus/configuration'
+require 'akatus/errors'
+require 'akatus/formatters'
+require 'akatus/transferrable'
+require 'akatus/version'
+
+# Business classes
+require 'akatus/address'
+require 'akatus/installment'
+require 'akatus/installment_options'
+require 'akatus/item'
+require 'akatus/payer'
+require 'akatus/payment'
+require 'akatus/payment_option'
+require 'akatus/payment_types'
+require 'akatus/phone'
+require 'akatus/receiver'
+require 'akatus/service'
+require 'akatus/services/installments'
+require 'akatus/services/payment_options'
+require 'akatus/services/transaction'
+require 'akatus/split_fee'
+
+require_relative '../config/i18n'
 
 module Akatus
-end
+end

data/lib/akatus/address.rb

@@ -0,0 +1,11 @@
+module Akatus
+
+  class Address
+    include Transferrable
+    transferrable_attrs :type, :street, :number, :neighborhood,
+                        :additional_details, :city, :state, :country, :postal_code
+
+    attr_accessor :reference
+  end
+
+end

data/lib/akatus/configuration.rb

@@ -0,0 +1,43 @@
+require 'singleton'
+
+module Akatus
+
+  def self.config
+    Configuration.instance
+  end
+
+  class Configuration
+    include Singleton
+
+    attr_accessor :api_key, :email, :env, :sandbox
+
+    def initialize
+
+      @env = environment
+      conf = File.exists?(config_file_path) ? YAML.load_file(config_file_path)[@env] : {}
+
+      @sandbox  = conf['sandbox'] == true
+      @api_key  = conf['api_key']
+      @email    = conf['email']
+
+    end
+
+    def config_file_path
+      "#{Dir.pwd}/config/akatus.yml"
+    end
+
+    def environment
+      ENV['AKATUS_ENV'] || 'development'
+    end
+
+    def base_url
+      sandbox ? 'https://sandbox.akatus.com/' : 'https://www.akatus.com/'
+    end
+
+    def api_url
+      base_url + "api/v1/"
+    end
+
+  end
+
+end

data/lib/akatus/errors.rb

@@ -0,0 +1,4 @@
+module Akatus
+  class UnprocessableEntityError < StandardError
+  end
+end

data/lib/akatus/formatters.rb

@@ -0,0 +1,22 @@
+module Akatus
+
+  NUMERIC_FIELDS =
+    [
+      :price, :weight, :shipping_cost, :discount, :amount
+    ]
+
+  INTEGER_FIELDS =
+    [
+      :quantity
+    ]
+
+  STRING_FIELDS =
+    [
+      :reference
+    ]
+
+  def self.format_number(val)
+    ActiveSupport::NumberHelper.number_to_rounded(val, :locale => :en, :precision => 2)
+  end
+
+end

data/lib/akatus/installment.rb

@@ -0,0 +1,6 @@
+module Akatus
+  class Installment
+    include Transferrable
+    attr_accessor :quantity, :unitary_amount, :total_amount
+  end
+end

data/lib/akatus/installment_options.rb

@@ -0,0 +1,24 @@
+module Akatus
+  class InstallmentOptions
+    include Transferrable
+    attr_accessor :description, :installments, :taken_installments
+
+    #
+    # Build an empty ("dummy") object.
+    #
+    def self.blank(payment)
+
+      # The only "option" is to pay the full amount in one installment.
+      installment_options = [
+        Installment.new({
+            :quantity       => 1,
+            :unitary_amount => payment.total_amount,
+            :total_amount   => payment.total_amount
+        })
+      ]
+
+      new({ :taken_installments => 0, :installments => installment_options })
+    end
+
+  end
+end

data/lib/akatus/item.rb

@@ -0,0 +1,24 @@
+module Akatus
+  class Item
+    include Transferrable
+    transferrable_attrs :reference, :description, :quantity, :price, :weight,
+                        :shipping_cost, :discount, :split_fee
+
+    def initialize(opts = {})
+      opts = {
+        :shipping_cost => 0,
+        :discount      => 0,
+        :weight        => 0,
+        :quantity      => 1
+      }.merge(opts)
+      super(opts)
+    end
+
+    def total_amount
+      quantity * BigDecimal.new(price.to_s) +
+        BigDecimal.new(shipping_cost.to_s) -
+        BigDecimal.new(discount.to_s)
+    end
+
+  end
+end

data/lib/akatus/payer.rb

@@ -0,0 +1,35 @@
+module Akatus
+  class Payer
+    include Transferrable
+    transferrable_attrs :name, :email
+
+    attr_accessor :addresses, :phones
+
+    def address=(val)
+      addresses ? addresses.unshift(val) : (@addresses = [val])
+    end
+
+    def address
+      addresses[0] if addresses
+    end
+
+    def phone=(val)
+      phones ? phones.unshift(val) : (@phones = [val])
+    end
+
+    def phone
+      phones[0] if phones
+    end
+
+    def to_payload(include_root = true)
+      payload = super(true)
+
+      # Tweak Akatus' weird array format.
+      payload['pagador']['enderecos'] = { 'endereco' => addresses.map { |a| a.to_payload(false) } }
+      payload['pagador']['telefones'] = { 'telefone' => phones.map { |p| p.to_payload(false) } }
+
+      include_root ? payload : payload.values.first
+    end
+
+  end
+end

data/lib/akatus/payment.rb

@@ -0,0 +1,61 @@
+module Akatus
+  class Payment
+    include Transferrable
+
+    attr_reader   :receiver
+
+    attr_accessor :reference, :payer, :items, :payment_method,
+                  :weight, :shipping_cost, :discount, :currency,
+                  :id, :status, :transaction_id, :url, :error, :total_amount
+
+    def initialize(opts = {})
+      options = {
+        :items         => [],
+        :discount      => 0,
+        :shipping_cost => 0,
+        :weight        => 0
+      }.merge(opts)
+      super(options)
+
+      @receiver = Receiver.new({ :email => Akatus.config.email, :api_key => Akatus.config.api_key })
+    end
+
+    def to_payload
+      hsh = {
+        'carrinho' => {
+          'produtos'  => { 'produto' => items.map { |i| i.to_payload(false) } },
+          'transacao' => {
+            'peso'       => Akatus.format_number(total_weight),
+            'frete'      => Akatus.format_number(total_shipping_cost),
+            'desconto'   => Akatus.format_number(total_discount),
+            'referencia' => reference,
+            'moeda'      => 'BRL'
+          }.merge(payment_method.to_payload),
+          'recebedor'  => receiver.to_payload(false),
+          'pagador'    => payer.to_payload(false)
+        }
+      }
+    end
+
+    def total_weight
+      weight + items.inject(0) { |sum, item| sum + item.weight }
+    end
+
+    def total_shipping_cost
+      shipping_cost + items.inject(0) { |sum, item| sum + item.shipping_cost }
+    end
+
+    def total_discount
+      discount + items.inject(0) { |sum, item| sum + item.discount }
+    end
+
+    def total_items_amount
+      items.inject(0) { |sum, item| sum + item.total_amount }
+    end
+
+    def total_amount
+      total_items_amount - total_discount + total_shipping_cost
+    end
+
+  end
+end

data/lib/akatus/payment_option.rb

@@ -0,0 +1,6 @@
+module Akatus
+  class PaymentOption
+    include Transferrable
+    attr_accessor :code, :description, :installments
+  end
+end

data/lib/akatus/payment_types.rb

@@ -0,0 +1,37 @@
+module Akatus
+
+  class PaymentType
+    include Transferrable
+    attr_accessor :type
+  end
+
+  class CreditCard < PaymentType
+    transferrable_attrs :brand, :number, :security_code, :installments, :expiration
+
+    attr_accessor :holder_name, :holder_cpf, :holder_phone
+
+    def to_payload
+      payload = super
+      payload['cartao_de_credito']['portador'] = {
+        :nome     => holder_name,
+        :cpf      => holder_cpf,
+        :telefone => holder_phone
+      }
+      payload['cartao_de_credito']
+    end
+  end
+
+  class ElectronicFundsTransfer < PaymentType
+    transferrable_attrs :brand
+    def to_payload
+      { :meio_de_pagamento => brand }
+    end
+  end
+
+  class BoletoBancario < PaymentType
+    attr_accessor :brand
+    def to_payload
+      { :meio_de_pagamento => 'boleto' }
+    end
+  end
+end

data/lib/akatus/phone.rb

@@ -0,0 +1,6 @@
+module Akatus
+  class Phone
+    include Transferrable
+    transferrable_attrs :type, :number
+  end
+end