alpha_card 0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: dd70168d46aad0fa4d47e2b3f4ddc456bfe2a3d9
+  data.tar.gz: e6823a997b69246add52d448ab5069b7334d7136
+SHA512:
+  metadata.gz: d517bc9ab7e41c42eb45df3e430c27b2b235e0f5d388d720229b44e2488ec7d92e795c464321dd9b65cbb5f607d57f02ef00ab2af65669d0ad2c6c9dbf05ef88
+  data.tar.gz: c9038bd884701f52dc6d438217326af53a9a2350c8b5d1f6385d01f62f6d56040cd23da17991e10cfd6d6aba9caf66f501ee4ea6cd5baf973eb2bf06ba9d2f63

data/lib/alpha_card.rb

@@ -0,0 +1,55 @@
+require 'curb'
+require 'yaml'
+require 'virtus'
+require 'rack'
+
+require 'alpha_card/object'
+
+require 'alpha_card/alpha_card_response'
+require 'alpha_card/alpha_card_error'
+require 'alpha_card/alpha_card_object'
+
+require 'alpha_card/account'
+require 'alpha_card/billing'
+require 'alpha_card/order'
+require 'alpha_card/sale'
+require 'alpha_card/shipping'
+
+module AlphaCard
+  @api_base = 'https://secure.alphacardgateway.com/api/transact.php'
+
+  CREDIT_CARD_CODES = YAML.load_file(File.expand_path('../alpha_card/data/codes.yml',  __FILE__)) unless defined? CREDIT_CARD_CODES
+
+  class << self
+    attr_accessor :api_base
+  end
+
+  def self.request(params, account)
+    unless account.filled?
+      raise AlphaCardError.new('You must set credentials to create the sale!')
+    end
+
+    auth_params = account.to_query
+
+    curl = Curl::Easy.new(@api_base)
+    curl.connect_timeout = 15
+    curl.timeout = 15
+    curl.header_in_body = false
+    curl.ssl_verify_peer = false
+    curl.post_body = [auth_params, params].join('&')
+    curl.perform
+
+    response = AlphaCardResponse.new(curl.body_str)
+    handle_errors(response)
+
+    response
+  end
+
+  private
+
+  def self.handle_errors(response)
+    code = response.text
+    raise AlphaCardError.new(CREDIT_CARD_CODES[code] || code) unless response.success?
+  end
+end
+

data/lib/alpha_card/account.rb

@@ -0,0 +1,15 @@
+module AlphaCard
+  class Account < AlphaCardObject
+    attribute :username, String
+    attribute :password, String
+
+    def initialize(username, password)
+      self.username = username
+      self.password = password
+    end
+
+    def filled?
+      [self.username, self.password].all?(&:present?)
+    end
+  end
+end

data/lib/alpha_card/alpha_card_error.rb

@@ -0,0 +1,4 @@
+module AlphaCard
+  class AlphaCardError < StandardError
+  end
+end

data/lib/alpha_card/alpha_card_object.rb

@@ -0,0 +1,13 @@
+module AlphaCard
+  class AlphaCardObject
+    include Virtus.model
+
+    def to_query
+      Rack::Utils.build_query(self.filled_attributes)
+    end
+
+    def filled_attributes
+      self.attributes.select { |key, value| value.present? }
+    end
+  end
+end

data/lib/alpha_card/alpha_card_response.rb

@@ -0,0 +1,37 @@
+module AlphaCard
+  class AlphaCardResponse
+    attr_reader :data
+
+    APPROVED = '1'
+    DECLINED = '2'
+    ERROR    = '3'
+
+    def initialize(request_body)
+      @data = Rack::Utils.parse_nested_query(request_body)
+    end
+
+    def text
+      @data['responsetext']
+    end
+
+    def transaction_id
+      @data['transactionid']
+    end
+
+    def code
+      @data['response_code']
+    end
+
+    def success?
+      @data['response'] == APPROVED
+    end
+
+    def declined?
+      @data['response'] == DECLINED
+    end
+
+    def error?
+      @data['response'] == ERROR
+    end
+  end
+end

data/lib/alpha_card/billing.rb

@@ -0,0 +1,6 @@
+module AlphaCard
+  class Billing < AlphaCardObject
+    attribute :email, String
+    attribute :phone, String
+  end
+end

data/lib/alpha_card/data/codes.yml

@@ -0,0 +1,62 @@
+"AP": 'Approved or completed successfully'
+"CALL AE": 'Refer to American Express.'
+"CALL CB": 'Refer to Carte Blanche.'
+"CALL DC": 'Refer to Diners Club.'
+"CALL DISCOVER": 'Refer to Discover.'
+"CALL JB": 'Refer to JBS.'
+"CALL ND": 'Call your Visa/MasterCard Voice Authorization Center.'
+"CALL TC": 'Refer to TeleCredit.'
+"CALL TK": 'Refer to TeleCheck.'
+"CALL WC": 'Refer to Worldcheck.'
+"CALL XXXXXXXXXX": 'Call indicated number.'
+"ISSUER UNAVAIL NDC": 'cannot contact issuing bank for authorization.'
+"INVLD MERCH ID": 'Invalid Merchant ID.'
+"PIC UP": 'Authorization declined.'
+"DECLINE": 'Authorization declined.'
+"REVERSED": 'Requested transaction reversal was successful.'
+"AP WITH ID": 'Approved with positive ID. NDC Host does not capture this transaction.'
+"INVLD SERV ID": 'Service ID number is incorrect'
+"INVALID REQUEST": 'Administrative message contains a syntax error.'
+"INVLD TRAN CODE": 'Processing code entered is incorrect. Please refer to valid processing code.'
+"INVLD AMOUNT": 'Amount entered is not valid.'
+"INVLD ACCT": 'Account number does not pass issuer’s edit checks'
+"INVLD CODE ACCT": 'Valid account number matched with a transaction code for a different card type.'
+"PLEASE RETRY": 'NDC’s user tables are set up incorrectly for this account.'
+"INVLD EMP DATE": 'NDC GATEWAY requests a retry.'
+"PIN INVALID": 'Expired date entered is incorrect.'
+"UNAUTH TRANS": 'Incorrect PIN entered.'
+"MAX PIN RETRIES": 'A transaction code was used for which you are not setup on the Merchant Master File.'
+"AP DUPE": 'Maximum PIN number entry attempts exceeded.'
+"IN ACCT MATCH": 'Transaction entered is a duplicate.'
+"INV AMT MATCH": 'The account number entered during a void or adjustment transaction does not match the account number stored in the NDC Host for that item.'
+"INV ITEM NUM": 'The item number entered for a void or adjustment transaction is incorrect.'
+"ITEM VOIDED": 'An adjustment or item review was attempted on a transaction previously voided or reversed.'
+"ITEM REVERSED": 'An adjustment or item review was attempted on a transaction previously voided or reversed.'
+"MUST BALANCE NOW": 'Terminal has not been balanced within time specified in the NDC Merchant Master File for this merchant.'
+"USE DUP THEN BAL": 'Terminal has not been balanced within time specified in the NDC Merchant Master File for this merchant, but merchant is set up to perform extra transactions before balancing.'
+"NO DUP FOUND": 'Override transaction is at tempted on a non-duplicated transaction.'
+"INVALID DATA": 'Format of the transaction is incorrect.'
+"NO TRANS FOUND": 'Reversal transaction is attempted on a transaction that is not in the open batch on the host.'
+"AP NOT CAPTURED": 'Approved but not captured (applied to only credit card transactions).'
+"AP AUTH-ONLY": 'Approved but this EDC merchant is not set up to capture this card type (applies only to credit card transactions).'
+"INV BANK": 'Acquiring Bank ID entered is incorrect.'
+"TRAN TYPE INVLD": 'Transaction not supported by EFT network or EFT Group ID is incorrect.'
+"APPROVED": 'Merchant is not set up for debit on NDC Merchant Master File.'
+"DB UNAVAIL 02": 'NDC GATEWAY is down'
+"DB UNAVAIL 03": 'NDC GATEWAY Link ID timed out.'
+"DB UNAVAIL 04": 'NDC GATEWAY cannot contact EFT network or EFT Group ID is incorrect.'
+"UNAUTH USER": 'Merchant is not set up for debit on NDC Merchant Master File.'
+"INVALID CARD": 'Debit card not on issuer file.'
+"DB ISSUER UNAVAIL EFT": 'network cannot contact issuer'
+"INVALID POS CARD": 'Card is not eligible for POS.'
+"ACCT TYPE INVLD": 'Type of account entered cannot be accessed (checking, savings, etc.)'
+"INVALID PREFIX": 'No sharing arrangement for this card.'
+"INVALID FIID NDC GATEWAY": 'Financial Institution ID not set up.'
+"VERIFY XXXXXXXXXX": 'Match on SCAN file. XXXXXXXXXX is routing/transit number on the negative file.'
+"INVALID LIC": 'The license or ID number entered during a check authorization transaction is incorrect.'
+"INVALID STATE CD": 'State code entered is incorrect.'
+"EDC UNAVAILABLE EDC": 'application down, try later.'
+"DB UNAVAIL 01": 'Problem at NDC routing transaction.'
+"SCAN UNAVAILABLE SCAN": 'application is down, try later.'
+"EXCEEDS MAX AMT": 'Exceeds withdrawal amount limit.'
+"EXCEEDS MAX USES": 'Exceeds withdrawal frequency limit'

data/lib/alpha_card/object.rb

@@ -0,0 +1,17 @@
+class Object
+  def blank?
+    respond_to?(:empty?) ? !!empty? : !self
+  end
+
+  def present?
+    !blank?
+  end
+
+  def try(*a, &b)
+    if a.empty? && block_given?
+      yield self
+    else
+      public_send(*a, &b) if respond_to?(a.first)
+    end
+  end
+end

data/lib/alpha_card/order.rb

@@ -0,0 +1,8 @@
+module AlphaCard
+  class Order < AlphaCardObject
+    attribute :orderid, Integer
+    attribute :orderdescription, String
+
+    attr_accessor :billing, :shipping
+  end
+end

data/lib/alpha_card/sale.rb

@@ -0,0 +1,25 @@
+module AlphaCard
+  class Sale < AlphaCardObject
+    attribute :ccexp, String
+    attribute :ccnumber, String
+    attribute :amount, String
+    attribute :cvv, String
+
+    attribute :type, String, default: 'sale', writer: :private
+
+    def create(order, account)
+      [:ccexp, :ccnumber, :amount].each do |attr|
+        raise Exception.new("No #{attr.to_s} information provided") if self.send(attr.to_s).blank?
+      end
+
+      sale_query = self.to_query
+      order_query = order.to_query
+      billing_query = order.billing.try(:to_query)
+      shipping_query = order.shipping.try(:to_query)
+
+      params = [order_query, billing_query, sale_query, shipping_query].reject(&:blank?).join('&')
+
+      AlphaCard.request(params, account).success?
+    end
+  end
+end

data/lib/alpha_card/shipping.rb

@@ -0,0 +1,10 @@
+module AlphaCard
+  class Shipping < AlphaCardObject
+    attribute :address_1, String
+    attribute :address_2, String
+    attribute :city, String
+    attribute :state, String
+    attribute :zip_code, String
+    attribute :email, String
+  end
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: alpha_card
+version: !ruby/object:Gem::Version
+  version: '0.1'
+platform: ruby
+authors:
+- Nikita Bulaj
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-25 00:00:00.000000000 Z
+dependencies: []
+description: Gem for creates sales with Alpha Card DirectPost API
+email: bulajnikita@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/alpha_card.rb
+- lib/alpha_card/account.rb
+- lib/alpha_card/alpha_card_error.rb
+- lib/alpha_card/alpha_card_object.rb
+- lib/alpha_card/alpha_card_response.rb
+- lib/alpha_card/billing.rb
+- lib/alpha_card/data/codes.yml
+- lib/alpha_card/object.rb
+- lib/alpha_card/order.rb
+- lib/alpha_card/sale.rb
+- lib/alpha_card/shipping.rb
+homepage: http://github.com/budev/alpha_card
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Alpha Card DirectPost API
+test_files: []