tangocard 4.0.0 → 4.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cd29a51b8650b514dc09bc278ce37740e9957153
-  data.tar.gz: 618da4ddf55e67a5554addd734478ef14a22054d
+  metadata.gz: 8b8c6e8dd748f73ba39b6300e69450556158be90
+  data.tar.gz: eea2b48a8cd364c9f79871e93011467d34df83d2
 SHA512:
-  metadata.gz: dae579cabb4edef980a2d8ad4bd5d55a1eac81d4a927f01b6b652e8dc408abb0c143e1dcacdad82a152e2add327e56c5612610fa18589bce0775c9884be36b67
-  data.tar.gz: a605a79b85e12710d16c352a08516e43e371340b5d5ebb61ebc27f4749cd652b6baa0c9919ffdeffd0849b2c2948a5e41a98de0f84d494b343340217d2be8ef6
+  metadata.gz: f1c2a0c08a8962c0cd89153bf5e20a4e19a95653a9632884acb18941e02e5f437653f2a3f5c1b3454ae4d265dead80605c77ab09ceffc08dc822fdebf3d2fc78
+  data.tar.gz: 6b680dbf60193d42cfafdd4ae5e0719b6b64700594bbfcc081666712ddce9888b8aed439f3d22797112e9060a58b1967050532e596d8e40d3108a099648f44ed

data/lib/tangocard.rb

@@ -30,8 +30,11 @@ require 'tangocard/raas'
 require 'tangocard/account'
 require 'tangocard/account_create_failed_exception'
 require 'tangocard/account_not_found_exception'
+require 'tangocard/account_delete_credit_card_failed_exception'
+require 'tangocard/account_register_credit_card_failed_exception'
+require 'tangocard/account_fund_failed_exception'
 require 'tangocard/brand'
 require 'tangocard/order'
 require 'tangocard/order_create_failed_exception'
 require 'tangocard/order_not_found_exception'
-require 'tangocard/reward'
+require 'tangocard/reward'

data/lib/tangocard/account.rb

@@ -1,5 +1,5 @@
 class Tangocard::Account
-  attr_reader :customer, :identifier, :email, :available_balance
+  attr_reader :customer, :identifier, :email, :available_balance, :cc_token
 
   private_class_method :new
 
@@ -71,10 +71,98 @@ class Tangocard::Account
     @available_balance
   end
 
+  # Register a credit card
+  # Raises Tango::AccountRegisterCreditCardFailedException on failure.
+  # Example:
+  #   >> account.register_credit_card('128.128.128.128', Hash (see example below))
+  #    => {"success"=>true, "cc_token"=>"33041234", "active_date"=>1439286111}
+  #
+  # Arguments:
+  #   client_ip: (String)
+  #   credit_card: (Hash) - see
+  # https://github.com/tangocarddev/RaaS/blob/master/cc_register.schema.json for details
+  #
+  # Credit Card Hash Example:
+  #
+  #   {
+  #       'number' => '4111111111111111',
+  #       'expiration' => '01/17',
+  #       'security_code' => '123',
+  #       'billing_address' => {
+  #           'f_name' => 'Jane',
+  #           'l_name' => 'User',
+  #           'address' => '123 Main Street',
+  #           'city' => 'Anytown',
+  #           'state' => 'NY',
+  #           'zip' => '11222',
+  #           'country' => 'USA',
+  #           'email' => 'jane@company.com'
+  #       }
+  #   }
+  def register_credit_card(client_ip, credit_card)
+    params = {
+        'client_ip' => client_ip,
+        'credit_card' => credit_card,
+        'customer' => customer,
+        'account_identifier' => identifier
+    }
+
+    response = Tangocard::Raas.register_credit_card(params)
+    if response.success?
+      @cc_token = response.parsed_response['cc_token']
+      response.parsed_response
+    else
+      raise Tangocard::AccountRegisterCreditCardFailedException, "#{response.denial_message}"
+    end
+  end
+
+  # Add funds to the account.
+  # Raises Tangocard::AccountFundFailedException on failure.
+  # Example:
+  #   >> account.cc_fund(5000, '128.128.128.128', '12345678', '123')
+  #    => {"success"=>true, "fund_id"=>"RF13-09261098-12", "amount"=>5000}
+
+  # Arguments:
+  #   amount: (Integer)
+  #   client_ip: (String)
+  #   cc_token: (String)
+  #   security_code: (String)
+  # def cc_fund(amount, client_ip, cc_token, security_code)
+  #   params = {
+  #       'amount' => amount,
+  #       'client_ip' => client_ip,
+  #       'cc_token' => cc_token,
+  #       'customer' => customer,
+  #       'account_identifier' => identifier,
+  #       'security_code' => security_code
+  #   }
+  #
+  #   response = Tangocard::Raas.cc_fund_account(params)
+  # end
+  #
+  def cc_fund(amount, client_ip, cc_token, security_code)
+    params = {
+        'amount' => amount,
+        'client_ip' => client_ip,
+        'cc_token' => cc_token,
+        'customer' => customer,
+        'account_identifier' => identifier,
+        'security_code' => security_code
+    }
+
+    response = Tangocard::Raas.cc_fund_account(params)
+    if response.success?
+      response.parsed_response
+    else
+      raise Tangocard::AccountFundFailedException, "#{response.error_message} #{response.denial_message} #{response.invalid_inputs}"
+    end
+  end
+
+  # (DEPRECATED)
   # Add funds to the account.
   #
   # Example:
-  #   >> account.fund(10000, '128.128.128.128', Hash (see example below))
+  #   >> account.fund!(10000, '128.128.128.128', Hash (see example below))
   #    => #<Tangocard::Account:0x007f9a6fec0138 @customer="bonusly", @email="dev@bonus.ly", @identifier="test", @available_balance=0>
   #
   # Arguments:
@@ -100,6 +188,8 @@ class Tangocard::Account
   #       }
   #   }
   def fund!(amount, client_ip, credit_card)
+    warn "[DEPRECATION] `fund!` is deprecated. Please use `cc_fund` instead. See https://github.com/tangocarddev/RaaS#fund-a-platforms-account"
+
     params = {
         'amount' => amount,
         'client_ip' => client_ip,
@@ -109,4 +199,28 @@ class Tangocard::Account
     }
     Tangocard::Raas.fund_account(params)
   end
-end
+
+  # Delete a credit card from an account
+  # Raises Tangocard::AccountDeleteCreditCardFailedException failure.
+  # Example:
+  #   >> account.delete_credit_card("12345678")
+  #    => {"success"=>true, "message": "This card is no longer present in the system"}
+
+  # Arguments:
+  #   cc_token: (String)
+  def delete_credit_card(cc_token)
+    params = {
+      'cc_token' => cc_token,
+      'customer' => customer,
+      'account_identifier' => identifier
+    }
+
+    response = Tangocard::Raas.delete_credit_card(params)
+    if response.success?
+      response.parsed_response
+    else
+      raise Tangocard::AccountDeleteCreditCardFailedException, "#{response.error_message}"
+    end
+  end
+
+end

data/lib/tangocard/account_delete_credit_card_failed_exception.rb

@@ -0,0 +1,3 @@
+class Tangocard::AccountDeleteCreditCardFailedException < Exception
+
+end

data/lib/tangocard/account_fund_failed_exception.rb

@@ -0,0 +1,3 @@
+class Tangocard::AccountFundFailedException < Exception
+
+end

data/lib/tangocard/account_register_credit_card_failed_exception.rb

@@ -0,0 +1,3 @@
+class Tangocard::AccountRegisterCreditCardFailedException < Exception
+
+end

data/lib/tangocard/raas.rb

@@ -25,6 +25,7 @@ class Tangocard::Raas
     Tangocard::Response.new(get(endpoint + "/accounts/#{params['customer']}/#{params['identifier']}", basic_auth_param))
   end
 
+  # (Deprecated)
   # Funds an account. Returns Tangocard::Response object.
   #
   # Example:
@@ -37,6 +38,42 @@ class Tangocard::Raas
     Tangocard::Response.new(post(endpoint + '/funds', {:body => params.to_json}.merge(basic_auth_param)))
   end
 
+  # Funds an account. Returns Tangocard::Response object.
+  #
+  # Example:
+  #   >> Tangocard::Raas.cc_fund_account(params)
+  #    => #<Tangocard::Response:0x007f9a6c4bca68 ...>
+  #
+  # Arguments:
+  #   params: (Hash - see https://github.com/tangocarddev/RaaS#fund-resources for details)
+  def self.cc_fund_account(params)
+    Tangocard::Response.new(post(endpoint + '/cc_fund', {:body => params.to_json}.merge(basic_auth_param)))
+  end
+
+  # Registers a credit card to an account. Returns Tangocard::Response object.
+  #
+  # Example:
+  #   >> Tangocard::Raas.register_credit_card(params)
+  #    => #<Tangocard::Response:0x007f9a6c4bca68 ...>
+  #
+  # Arguments:
+  #   params: (Hash - see https://github.com/tangocarddev/RaaS#fund-resources for details)
+  def self.register_credit_card(params)
+    Tangocard::Response.new(post(endpoint + '/cc_register', {:body => params.to_json}.merge(basic_auth_param)))
+  end
+
+  # Deletes a credit card from an account. Returns Tangocard::Response object.
+  #
+  # Example:
+  #   >> Tangocard::Raas.delete_credit_card(params)
+  #    => #<Tangocard::Response:0x007f9a6c4bca68 ...>
+  #
+  # Arguments:
+  #   params: (Hash - see https://github.com/tangocarddev/RaaS#delete-a-credit-card-from-an-account for details)
+  def self.delete_credit_card(params)
+    Tangocard::Response.new(post(endpoint + '/cc_unregister', {:body => params.to_json}.merge(basic_auth_param)))
+  end
+
   # Retrieve all rewards. Returns Tangocard::Response object.
   #
   # Example:
@@ -110,4 +147,4 @@ class Tangocard::Raas
   def self.endpoint
     Tangocard.configuration.base_uri + '/raas/v1'
   end
-end
+end

data/lib/tangocard/response.rb

@@ -14,7 +14,11 @@ class Tangocard::Response
     parsed_response['error_message'] rescue 'UNKNOWN ERROR'
   end
 
+  def denial_message
+    parsed_response['denial_message'] rescue 'UNKNOWN ERROR'
+  end
+
   def invalid_inputs
     parsed_response['invalid_inputs'] rescue 'UNKNOWN INVALID INPUTS'
   end
-end
+end

data/lib/tangocard/version.rb

@@ -1,3 +1,3 @@
 module Tangocard
-  VERSION = '4.0.0'
+  VERSION = '4.1.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tangocard
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 4.1.0
 platform: ruby
 authors:
 - Raphael Crawford-Marks
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-07-04 00:00:00.000000000 Z
+date: 2015-08-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -95,7 +95,10 @@ files:
 - lib/tangocard.rb
 - lib/tangocard/account.rb
 - lib/tangocard/account_create_failed_exception.rb
+- lib/tangocard/account_delete_credit_card_failed_exception.rb
+- lib/tangocard/account_fund_failed_exception.rb
 - lib/tangocard/account_not_found_exception.rb
+- lib/tangocard/account_register_credit_card_failed_exception.rb
 - lib/tangocard/brand.rb
 - lib/tangocard/order.rb
 - lib/tangocard/order_create_failed_exception.rb