bluepay 1.0.1

data/README

@@ -0,0 +1,28 @@
+== Welcome to Bluepay
+
+Bluepay is used to process credit cards and ach transactions using the BluePay 2.0 Gateway.
+
+BluePay, Inc. is a merchant account provider and payment gateway.  The BluePay 2.0 Gateway processes credit card and
+ACH transactions through a virtual terminal and various API/SDK/Payment Interfaces.
+
+To apply for a BluePay merchant account and payment gateway, visit http://www.bluepay.com.
+
+== Example
+
+    require "Bluepay"
+
+    tob = Bluepay.new("123123123123", "ABCDabcdABCDabcdABCDabcdABCDabcd")
+    tob.easy_sale("1.00")
+    tob.use_card("4111111111111111", "1109", "123")
+    tob.process()
+    puts "Status: " + tob.get_status()
+    puts "Message: " + tob.get_message()
+    puts "Transaction ID: " + tob.get_trans_id()
+
+== About
+
+Author::    Chris Jansen
+ReadmeDoc:: Christopher Kois
+Copyright:: Copyright (c) 2008 BluePay, Inc.
+License::   GPL - GNU General Public License - http://www.gnu.org/licenses/gpl.html
+

data/Rakefile

@@ -0,0 +1,89 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+require 'rake/contrib/rubyforgepublisher'
+
+PKG_VERSION = "1.0.1"
+
+PKG_FILES = FileList[
+    "lib/**/*", "bin/*", "test/**/*", "[A-Z]*", "Rakefile", "doc/**/*"
+]
+
+desc "Default Task"
+task :default => [ :test ]
+
+# Run the unit tests
+desc "Run all unit tests"
+Rake::TestTask.new("test") { |t|
+  t.libs << "lib"
+  t.pattern = 'test/*/*_test.rb'
+  t.verbose = true
+}
+
+# Make a console, useful when working on tests
+desc "Generate a test console"
+task :console do
+   verbose( false ) { sh "irb -I lib/ -r 'bluepay'" }
+end
+
+# Genereate the RDoc documentation
+desc "Create documentation"
+Rake::RDocTask.new("doc") { |rdoc|
+  rdoc.title = "Ruby Merchant Bluepay"
+  rdoc.rdoc_dir = 'doc'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/*.rb')
+}
+
+# Genereate the package
+spec = Gem::Specification.new do |s|
+
+  #### Basic information.
+
+  s.name = 'bluepay'
+  s.version = PKG_VERSION
+  s.summary = <<-EOF
+    Bluepay is used to process credit card and ach transactions through the BluePay 2.0 Gateway.
+  EOF
+  s.description = <<-EOF
+    This package allows a user to run credit card and ach transactions through the BluePay 2.0
+    Gateway.  BluePay is a merchant account provider and payment gateway.  BluePay, Inc. is a
+    one-stop shop merchant services provider.  For more information, visit: http://www.bluepay.com
+  EOF
+
+  #### Which files are to be included in this gem?  Everything!  (Except SVN directories.)
+
+  s.files = PKG_FILES
+
+  #### Load-time details: library and application (you will need one or both).
+
+  s.require_path = 'lib'
+  s.autorequire = 'bluepay'
+
+  #### Documentation and testing.
+
+  s.has_rdoc = true
+
+  #### Author and project details.
+
+  s.author = "Chris Jansen"
+  s.email = "cjansen@bluepay.com"
+  s.homepage = "http://www.bluepay.com/"
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.need_zip = true
+  pkg.need_tar = true
+end
+
+desc "Report code statistics (KLOCs, etc) from the application"
+task :stats do
+  require 'code_statistics'
+  CodeStatistics.new(
+    ["Library", "lib"],
+    ["Units", "test"]
+  ).to_s
+end
+

data/lib/Bluepay.rb

@@ -0,0 +1,206 @@
+#!/usr/bin/ruby
+#--
+# Copyright (c) 2008 BluePay, Inc.
+# Author: Chris Jansen
+#
+# 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 the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#++
+#
+# See Bluepay documentation.
+
+require "net/http"
+require "net/https"
+require "uri"
+require "md5"
+
+
+
+class Bluepay
+
+  @@SERVER = "secure.bluepay.com"
+  @@PATH = "/interfaces/bp20post"
+  
+  def initialize(account,key,mode='TEST')
+    @ACCOUNT_ID = account
+    @SECRET_KEY = key
+    @PARAM_HASH = { 'MODE' => mode }
+    @RETURN_HASH = Hash.new()
+  end
+  
+  # used to set all other parameters... there's a lot of them.
+  # See Bluepay20post.txt
+  def set_param(key, val)
+    @PARAM_HASH[key] = val
+  end
+  
+  # Set up an ACH transaction.  Expects:
+  # acc_type: C for Checking, S for Savings
+  # routing: Bank routing number
+  # account: Customer's checking or savings account number
+  # doc_type: WEB, TEL, ARC, etc -- see docs.  Optional.
+  # REMEMBER: Ach requires some other fields,
+  # such as address and phone 
+  def use_check(acc_type, routing, account, doc_type)
+    @PARAM_HASH['PAYMENT_ACCOUNT'] = "#{acc_type}:#{routing}:#{account}"
+    @PARAM_HASH['DOC_TYPE'] = doc_type
+    @PARAM_HASH['PAYMENT_TYPE'] = "ACH"
+  end
+
+  # Set up a credit card payment.
+  def use_card(account, expire, cvv)
+    @PARAM_HASH['PAYMENT_ACCOUNT'] = account
+    @PARAM_HASH['CARD_EXPIRE'] = expire
+    @PARAM_HASH['CARD_CVV2'] = cvv
+  end
+
+  # Set up a sale
+  def easy_sale(amount)
+    @PARAM_HASH['TRANS_TYPE'] = 'SALE'
+    @PARAM_HASH['AMOUNT'] = amount
+  end
+
+  # Set up an Auth-only
+  def easy_auth(amount)
+    @PARAM_HASH['TRANS_TYPE'] = 'AUTH'
+    @PARAM_HASH['AMOUNT'] = amount
+  end
+  
+  # Capture an auth
+  def easy_capture(trans_id)
+    @PARAM_HASH['TRANS_TYPE'] = 'CAPTURE'
+    @PARAM_HASH['MASTER_ID'] = trans_id
+  end
+
+  # Refund
+  def easy_refund(trans_id)
+    @PARAM_HASH['TRANS_TYPE'] = 'REFUND'
+    @PARAM_HASH['MASTER_ID'] = trans_id
+  end
+
+  # This is the important stuff to get 
+  # the best rates on CC transactions.
+  def customer_data(name1, name2, addr1, city, state, zip)
+    @PARAM_HASH['NAME1'] = name1
+    @PARAM_HASH['NAME2'] = name2
+    @PARAM_HASH['ADDR1'] = addr1
+    @PARAM_HASH['CITY'] = city
+    @PARAM_HASH['STATE'] = state
+    @PARAM_HASH['ZIP'] = zip
+  end
+
+  # Turns a hash into a foo=bar&baz=bat style string
+  def uri_query(h)
+    a = Array.new()
+    h.each_pair {|key, val| a.push(URI.escape(key) + "=" + URI.escape(val)) }
+    return a.join("&")
+  end
+
+  # Sets TAMPER_PROOF_SEAL in @PARAM_HASH
+  def calc_tps()
+    # Take the cheap way out.  I wrote bp20post and I hereby publically
+    # state the TPS in bp20post is stupid.
+    @PARAM_HASH["TPS_DEF"] = "HELLO_MOTHER"
+    @PARAM_HASH["TAMPER_PROOF_SEAL"] =  MD5.new(@SECRET_KEY).hexdigest
+  end
+
+  # Run a transaction - you must have called appropriate functions
+  # to set the transaction type, etc before calling this.
+  def process()
+    ua = Net::HTTP.new(@@SERVER, 443)
+    ua.use_ssl = true
+
+    # Generate the query string and headers
+    calc_tps()
+    query = "ACCOUNT_ID=#{@ACCOUNT_ID}&"
+    query += uri_query(@PARAM_HASH)
+   
+    queryheaders = {
+      'User-Agent' => 'Bluepay Ruby Client',
+      'Content-Type' => 'application/x-www-form-urlencoded'
+    }
+    
+    # Make Bluepay do Super CreditCard Magic
+    headers, body = ua.post(@@PATH, query, queryheaders)
+
+    # Split the response into the response hash.
+    # Also, we stuff in RESPONSE_CODE expected to be 200 or 400...
+    @RESPONSE_HASH = { "RESPONSE_CODE" => headers.code }
+    body.split("&").each { |pair| 
+      (key, val) = pair.split("=")
+      val = "" if(val == nil)
+      @RESPONSE_HASH[URI.unescape(key)] = URI.unescape(val) 
+    }
+  end
+
+  # Returns ! on WTF, E for Error, 1 for Approved, 0 for Decline
+  def get_status()
+    return 'E' if(@RESPONSE_HASH['RESPONSE_CODE'] == 400)
+    return '1' if(@RESPONSE_HASH['STATUS'] == '1');
+    return '0' if(@RESPONSE_HASH['STATUS'] == '0');
+    return 'E' if(@RESPONSE_HASH['STATUS'] == 'E');
+    return '!'
+  end
+
+  # Returns the human-readable response from Bluepay.
+  # Or a nasty error.
+  def get_message()
+    m = @RESPONSE_HASH['MESSAGE']
+    if (m == nil or m == "")
+      return "ERROR - NO MESSAGE FROM BLUEPAY"
+    end
+    return m
+  end
+
+  # Returns the single-character AVS response from the 
+  # Card Issuing Bank
+  def get_avs_code()
+    return @RESPONSE_HASH['AVS']
+  end
+
+  # Same as avs_code, but for CVV2
+  def get_cvv2_code()
+    return @RESPONSE_HASH['CVV2']
+  end
+
+  # In the case of an approved transaction, contains the
+  # 6-character authorization code from the processing network.
+  # In the case of a decline or error, the contents may be junk.
+  def get_auth_code()
+    return @RESPONSE_HASH['AUTH_CODE']
+  end
+
+  # The all-important transaction ID.
+  def get_trans_id()
+    return @RESPONSE_HASH['TRANS_ID']
+  end
+    
+  # If you set up a rebilling, this'll get it's ID.
+   def get_rebill_id()
+    return @RESPONSE_HASH['REBID']
+  end
+
+end
+
+
+
+
+
+
+

data/test/bp20post_test.rb

@@ -0,0 +1,12 @@
+#!/usr/bin/ruby
+
+require "Bluepay"
+
+tob = Bluepay.new("123123123123", "ABCDabcdABCDabcdABCDabcdABCDabcd")
+tob.easy_sale("1.00")
+tob.use_card("4111111111111111", "1109", "123")
+tob.process()
+puts "Status: " + tob.get_status()
+puts "Message: " + tob.get_message()
+puts "Transaction ID: " + tob.get_trans_id()
+

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.4
+specification_version: 1
+name: bluepay
+version: !ruby/object:Gem::Version 
+  version: 1.0.1
+date: 2008-05-23 00:00:00 -05:00
+summary: Bluepay is used to process credit card and ach transactions through the BluePay 2.0 Gateway.
+require_paths: 
+- lib
+email: cjansen@bluepay.com
+homepage: http://www.bluepay.com/
+rubyforge_project: 
+description: "This package allows a user to run credit card and ach transactions through the BluePay 2.0 Gateway.  BluePay is a merchant account provider and payment gateway.  BluePay, Inc. is a one-stop shop merchant services provider.  For more information, visit: http://www.bluepay.com"
+autorequire: bluepay
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Chris Jansen
+files: 
+- lib/Bluepay.rb
+- test/bp20post_test.rb
+- README
+- Rakefile
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: []
+
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+