pagarme 2.0.2 → 2.1.0

data/lib/pagarme/version.rb

@@ -0,0 +1,3 @@
+module PagarMe
+  VERSION = '2.1.0'
+end

data/pagarme.gemspec

@@ -1,26 +1,29 @@
-# coding: utf-8
 lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'pagarme/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "pagarme"
-  spec.version       = "2.0.2"
-  spec.authors       = ["Pedro Franceschi", "Henrique Dubugras"]
-  spec.email         = ["pedrohfranceschi@gmail.com", "henrique@pagar.me"]
+  spec.name          = 'pagarme'
+  spec.version       = PagarMe::VERSION
+  spec.authors       = ['Pedro Franceschi', 'Henrique Dubugras']
+  spec.email         = ['pedrohfranceschi@gmail.com', 'henrique@pagar.me']
   spec.description   = %q{Pagar.me's ruby gem}
   spec.summary       = %q{Allows integration with Pagar.me}
-  spec.homepage      = "http://pagar.me/"
+  spec.homepage      = 'http://pagar.me/'
 
   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_development_dependency "bundler", "~> 1.3"
-  spec.add_development_dependency "rake"
-  spec.add_development_dependency('shoulda', '~> 3.4.0')
-  spec.add_development_dependency('test-unit')
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'shoulda', '~> 3.4.0'
+  spec.add_development_dependency 'test-unit'
+  spec.add_development_dependency 'webmock'
+  spec.add_development_dependency 'vcr'
+  spec.add_development_dependency 'pry'
 
-  spec.add_dependency "rest-client"
-  spec.add_dependency "multi_json"
+  spec.add_dependency 'rest-client'
+  spec.add_dependency 'multi_json'
 end

data/test/assertions.rb

@@ -0,0 +1,195 @@
+module Assertions
+  def assert_customer_response(customer)
+    assert       customer.id
+    assert_equal customer.name,                'Jose da Silva'
+    assert_equal customer.document_number,     '84931126235'
+    assert_equal customer.email,               'pagarmetestruby@mailinator.com'
+    assert_equal customer.gender,              'M'
+    assert_equal Date.parse(customer.born_at), Date.parse('1970-10-11')
+  end
+
+  def assert_subscription_successfully_paid(subscription, amount = 2000, installments = 1)
+    assert       subscription.id
+    assert       !subscription.plan
+    assert       subscription.current_transaction.kind_of?(PagarMe::Transaction)
+    assert       subscription.current_transaction.id
+    assert       subscription.current_transaction.date_created
+    assert       !subscription.current_transaction.refuse_reason
+    assert       !subscription.current_transaction.boleto_url
+    assert       !subscription.current_transaction.boleto_barcode
+    assert_equal subscription.status,                             'paid'
+    assert_equal subscription.current_transaction.amount,         amount
+    assert_equal subscription.current_transaction.payment_method, 'credit_card'
+    assert_equal subscription.current_transaction.status,         'paid'
+    assert_equal subscription.current_transaction.card_brand,     'visa'
+  end
+
+  def assert_transaction_successfully(transaction)
+    assert       transaction.id
+    assert       transaction.date_created
+    assert       transaction.card.id
+    assert       !transaction.refuse_reason
+    assert_equal transaction.amount,            1000
+    assert_equal transaction.installments.to_i, 1
+    assert_equal transaction.card_holder_name,  'Jose da Silva'
+    assert_equal transaction.payment_method,    'credit_card'
+    assert_equal transaction.card_brand,        'visa'
+    assert_equal transaction.card.first_digits, '490172'
+    assert_equal transaction.card.last_digits,  '4448'
+  end
+
+  def assert_transaction_successfully_paid(transaction)
+    assert                          !transaction.postback_url
+    assert_equal                    transaction.status, 'paid'
+    assert_transaction_successfully transaction
+  end
+
+  def assert_transaction_successfully_processing(transaction)
+    assert_equal                    transaction.postback_url, 'http://test.com/postback'
+    assert_equal                    transaction.status,       'processing'
+    assert_transaction_successfully transaction
+  end
+
+  def assert_transaction_with_customer_successfully_paid(transaction)
+    assert_transaction_successfully_paid transaction
+
+    assert_equal transaction.customer.class, PagarMe::Customer
+    assert_customer_response transaction.customer
+
+    assert_equal transaction.phone.class,  PagarMe::Phone
+    assert_equal transaction.phone.ddd,    '21'
+    assert_equal transaction.phone.number, '922334455'
+
+    assert_equal transaction.address.class,         PagarMe::Address
+    assert_equal transaction.address.street,        'Av. Brigadeiro Faria Lima'
+    assert_equal transaction.address.neighborhood,  'Itaim bibi'
+    assert_equal transaction.address.zipcode,       '01452000'
+    assert_equal transaction.address.street_number, '2941'
+  end
+
+  def assert_transaction_refused_by_acquirer(transaction)
+    assert       transaction.id
+    assert       transaction.date_created
+    assert       transaction.card.id
+    assert_equal transaction.refuse_reason,     'acquirer'
+    assert_equal transaction.amount,            1000
+    assert_equal transaction.installments.to_i, 1
+    assert_equal transaction.card_holder_name,  'Jose da Silva'
+    assert_equal transaction.payment_method,    'credit_card'
+    assert_equal transaction.status,            'refused'
+    assert_equal transaction.card_brand,        'visa'
+    assert_equal transaction.card.first_digits, '490172'
+    assert_equal transaction.card.last_digits,  '4448'
+  end
+
+  def assert_transaction_with_bolelo_on_waiting_payment(transaction)
+    assert       transaction.date_created
+    assert       transaction.boleto_barcode
+    assert       transaction.boleto_expiration_date
+    assert       transaction.boleto_url
+    assert_nil   transaction.card
+    assert_nil   transaction.card_holder_name
+    assert_equal transaction.payment_method, 'boleto'
+    assert_equal transaction.status,         'waiting_payment'
+    assert_equal transaction.amount.to_s,    '1000'
+  end
+
+  def assert_split_rules(split_rules)
+    assert_equal split_rules.size, 4
+    rules = split_rules.sort_by &:percentage
+
+    assert_equal rules[0].recipient_id, Fixtures.persistent_recipient_ids[0]
+    assert_equal rules[1].recipient_id, Fixtures.persistent_recipient_ids[1]
+    assert_equal rules[2].recipient_id, Fixtures.persistent_recipient_ids[2]
+    assert_equal rules[3].recipient_id, Fixtures.persistent_recipient_ids[3]
+
+    assert_equal rules[0].percentage, 10
+    assert_equal rules[1].percentage, 20
+    assert_equal rules[2].percentage, 30
+    assert_equal rules[3].percentage, 40
+  end
+
+  def assert_plan_created(plan)
+    assert       plan.id
+    assert_equal plan.name,       'Plano gold'
+    assert_equal plan.trial_days, 5
+    assert_equal plan.days,       30
+    assert_equal plan.amount,     3000
+  end
+
+  def assert_subscription_created(subscription, plan)
+    assert       subscription.id
+    assert_equal subscription.status, 'trialing'
+    assert_equal subscription.plan.id, plan.id
+  end
+
+  def assert_no_trial_subscription_created(subscription, plan)
+    assert       subscription.id
+    assert_equal subscription.status, 'paid'
+    assert_equal subscription.plan.id, plan.id
+  end
+
+  def assert_transaction_errors(params = {})
+    PagarMe::Transaction.create transaction_with_card_params(params)
+  rescue PagarMe::ValidationError
+    assert_no_match /\s*\,\s*\Z/, $!.message
+  end
+
+  def assert_has_error_param(exception, parameter_name)
+    assert exception.errors.any?{ |error| error.parameter_name == parameter_name }
+  end
+
+  def assert_transfer(transfer)
+    assert transfer.id
+    assert transfer.fee
+    assert_equal transfer.class, PagarMe::Transfer
+    assert %w(doc credito_em_conta ted).include?(transfer.type)
+  end
+
+  def assert_empty_balance(balance)
+    assert_equal balance.available.amount,     0
+    assert_equal balance.waiting_funds.amount, 0
+    assert_equal balance.transferred.amount,   0
+  end
+
+  def assert_available_balance(balance)
+    assert(balance.available.amount > 0)
+    assert_equal balance.waiting_funds.amount, 0
+    assert_equal balance.transferred.amount,   0
+  end
+
+  def assert_transfered_balance(balance)
+    assert(balance.transferred.amount > 0)
+    assert_equal balance.available.amount,     0
+    assert_equal balance.waiting_funds.amount, 0
+  end
+
+  def assert_increased_available_amount(previous_balance, balance)
+    assert(previous_balance.available.amount < balance.available.amount)
+    assert_equal previous_balance.waiting_funds.amount, balance.waiting_funds.amount
+    assert_equal previous_balance.transferred.amount,   balance.transferred.amount
+  end
+
+  def assert_anticipation_limits(limits)
+    assert limits.maximum.amount
+    assert limits.minimum.amount
+  end
+
+  def assert_anticipation(anticipation)
+    assert_statusless_anticipation anticipation
+    assert_equal anticipation.status, 'pending'
+  end
+
+  def assert_canceled_anticipation(anticipation)
+    assert_statusless_anticipation anticipation
+    assert_equal anticipation.status, 'canceled'
+  end
+
+  def assert_statusless_anticipation(anticipation)
+    assert       anticipation.amount > 0
+    assert       anticipation.fee
+    assert       anticipation.anticipation_fee
+    assert_equal anticipation.object, 'bulk_anticipation'
+  end
+
+end

data/test/fixtures.rb

@@ -0,0 +1,222 @@
+class Fixtures
+  def transaction
+    { amount: 1000 }
+  end
+
+  def boleto
+    { payment_method: 'boleto' }
+  end
+
+  def transfer
+    { amount: 1000 }
+  end
+
+  def card
+    {
+      card_number:           '4901720080344448',
+      card_holder_name:      'Jose da Silva',
+      card_expiration_month: '10',
+      card_expiration_year:  valid_expiration_year,
+      card_cvv:              '314'
+    }
+  end
+
+  def split_rule(recipient_id, percentage)
+    { recipient_id: recipient_id, percentage: percentage }
+  end
+
+  def split_rules
+    {
+      split_rules: [
+        split_rule(persistent_recipient_ids[0], 10),
+        split_rule(persistent_recipient_ids[1], 20),
+        split_rule(persistent_recipient_ids[2], 30),
+        split_rule(persistent_recipient_ids[3], 40)
+      ]
+    }
+  end
+
+  def invalid_split_rules
+    {
+      split_rules: [
+        { percentage: 10 },
+        split_rule(persistent_recipient_ids[1], 20),
+        split_rule(persistent_recipient_ids[2], 30),
+        split_rule(persistent_recipient_ids[3], 40)
+      ]
+    }
+  end
+
+  def refused_card
+    # In test environment CVV's that starts with digit 6 are refused by acquirer
+    card.merge card_cvv: '600'
+  end
+
+  def plan
+    {
+      days:       30,
+      name:       'Plano gold',
+      amount:     3000,
+      trial_days: 5
+    }
+  end
+
+  def other_plan
+    {
+      name:   'Plano Silver',
+      days:   30,
+      amount: 3000
+    }
+  end
+
+  def no_trial_plan
+    {
+      name:       'Plano Sem Trial',
+      days:       30,
+      amount:     3000,
+      trial_days: 0
+    }
+  end
+
+  def bank_account
+    {
+      bank_code:       '237',
+      agencia:         '1935',
+      agencia_dv:      '9',
+      conta:           '23398',
+      conta_dv:        '9',
+      legal_name:      'foo bar loem',
+      document_number: '00000000000000'
+    }
+  end
+
+  def nested_bank_account
+    { bank_account: bank_account }
+  end
+
+  def refund_bank_account
+    {
+      bank_account: {
+        bank_code:       '399',
+        agencia:         '1234',
+        conta:           '1234567',
+        conta_dv:        '1',
+        legal_name:      'Jose da Silva',
+        document_number: '68782915423'
+      }
+    }
+  end
+
+  def recipient
+    {
+      transfer_day:      3,
+      transfer_enabled:  true,
+      transfer_interval: 'daily'
+    }
+  end
+
+  def postback
+    { postback_url: 'http://test.com/postback' }
+  end
+
+  def postback_response
+    {
+      id:             194330,
+      event:          'transaction_status_changed',
+      fingerprint:    'f8eb5ce941d70473ea691959ea4bfdeb79d48e2c',
+      desired_status: 'paid',
+      current_status: 'paid',
+      object:         'transaction',
+      old_status:     'processing'
+    }
+  end
+
+  def subscription
+    card.merge customer: { email: 'customer@pagar.me' }
+  end
+
+  def customer
+    {
+      customer: {
+        name:            'Jose da Silva',
+        document_number: '84931126235',
+        email:           'pagarmetestruby@mailinator.com',
+        gender:          'M',
+        born_at:         '1970-10-11',
+        phone:           { ddd: '21', number: '922334455' },
+        address: {
+          street:        'Av. Brigadeiro Faria Lima',
+          neighborhood:  'Itaim bibi',
+          zipcode:       '01452000',
+          street_number: '2941'
+        }
+      }
+    }
+  end
+
+  def invalid_expiration_year
+    { card_expiration_year: _invalid_expiration_year }
+  end
+
+  def anticipations_limits
+    {
+      timeframe:    :end,
+      payment_date: (Date.today + 7)
+    }
+  end
+
+  def respond_to?(method_name)
+    return true if super(method_name)
+    method_name.to_s.split(/_with_/).all?{ |m| super(m) }
+  end
+
+  def valid_expiration_year
+    ( Time.now.year+1 ).to_s[2..-1]
+  end
+
+  def persistent_recipient_ids
+    VCR.use_cassette('fixtures/persistent_recipients') do
+      4.times.map do
+        PagarMe::Recipient.create(recipient_with_nested_bank_account).id
+      end
+    end
+  end
+
+  def self.persistent_recipient_ids
+    new.persistent_recipient_ids
+  end
+
+  protected
+
+  def _invalid_expiration_year
+    ( Time.now.year-1 ).to_s[2..-1]
+  end
+
+  def method_missing(name, *args, &block)
+    if respond_to?(name)
+      name.to_s.split(/_with_/).map{ |m| public_send m }.inject Hash.new, &:merge
+    else
+      super name, *args, &block
+    end
+  end
+
+  module Helpers
+    protected
+    def fixtures
+      @fixtures ||= Fixtures.new
+    end
+
+    def method_missing(name, *args, &block)
+      match = name.to_s.match /\_params\Z/
+      if match && fixtures.respond_to?(match.pre_match) && args.count < 2
+        if args.empty?
+          fixtures.public_send match.pre_match
+        else
+          fixtures.public_send(match.pre_match).merge args.first
+        end
+      else
+        super name, *args, &block
+      end
+    end
+  end
+end