vaulted_billing 0.0.0

data/README.md

@@ -0,0 +1,4 @@
+# VaultedBilling
+
+A generic interface to integrate with multiple vault-style Gateways (Authorize.net CIM, NMI Customer Vault, etc.)
+

data/lib/vaulted_billing.rb

@@ -0,0 +1,30 @@
+module VaultedBilling
+  autoload :Version, 'vaulted_billing/version'
+  autoload :Gateway, 'vaulted_billing/gateway'
+  autoload :Gateways, 'vaulted_billing/gateways'
+  autoload :Customer, 'vaulted_billing/customer'
+  autoload :CreditCard, 'vaulted_billing/credit_card'
+  autoload :Transaction, 'vaulted_billing/transaction'
+  autoload :HttpsInterface, 'vaulted_billing/https_interface'
+
+  mattr_accessor :logger
+
+  Dir[File.expand_path(File.join(File.dirname(__FILE__), 'vaulted_billing', 'core_ext', '**', '*.rb'))].each do |extension|
+    require extension
+  end
+
+  ##
+  # Return the matching gateway for the name provided.
+  # 
+  # * <tt>bogus</tt>:: BogusGateway - always successful, does nothing.
+  # * <tt>nmi_customer_vault</tt>:: NMICustomerVaultGateway
+  #
+  def self.gateway(name)
+    Gateways.const_get(name.to_s.camelize)
+  end
+
+  def self.logger?
+    @@logger.present?
+  end
+
+end

data/lib/vaulted_billing/certificate_authorities/entrust.pem

@@ -0,0 +1,24 @@
+-----BEGIN CERTIFICATE-----
+MIIE2DCCBEGgAwIBAgIEN0rSQzANBgkqhkiG9w0BAQUFADCBwzELMAkGA1UEBhMCVVMxFDASBgNV
+BAoTC0VudHJ1c3QubmV0MTswOQYDVQQLEzJ3d3cuZW50cnVzdC5uZXQvQ1BTIGluY29ycC4gYnkg
+cmVmLiAobGltaXRzIGxpYWIuKTElMCMGA1UECxMcKGMpIDE5OTkgRW50cnVzdC5uZXQgTGltaXRl
+ZDE6MDgGA1UEAxMxRW50cnVzdC5uZXQgU2VjdXJlIFNlcnZlciBDZXJ0aWZpY2F0aW9uIEF1dGhv
+cml0eTAeFw05OTA1MjUxNjA5NDBaFw0xOTA1MjUxNjM5NDBaMIHDMQswCQYDVQQGEwJVUzEUMBIG
+A1UEChMLRW50cnVzdC5uZXQxOzA5BgNVBAsTMnd3dy5lbnRydXN0Lm5ldC9DUFMgaW5jb3JwLiBi
+eSByZWYuIChsaW1pdHMgbGlhYi4pMSUwIwYDVQQLExwoYykgMTk5OSBFbnRydXN0Lm5ldCBMaW1p
+dGVkMTowOAYDVQQDEzFFbnRydXN0Lm5ldCBTZWN1cmUgU2VydmVyIENlcnRpZmljYXRpb24gQXV0
+aG9yaXR5MIGdMA0GCSqGSIb3DQEBAQUAA4GLADCBhwKBgQDNKIM0VBuJ8w+vN5Ex/68xYMmo6LIQ
+aO2f55M28Qpku0f1BBc/I0dNxScZgSYMVHINiC3ZH5oSn7yzcdOAGT9HZnuMNSjSuQrfJNqc1lB5
+gXpa0zf3wkrYKZImZNHkmGw6AIr1NJtl+O3jEP/9uElY3KDegjlrgbEWGWG5VLbmQwIBA6OCAdcw
+ggHTMBEGCWCGSAGG+EIBAQQEAwIABzCCARkGA1UdHwSCARAwggEMMIHeoIHboIHYpIHVMIHSMQsw
+CQYDVQQGEwJVUzEUMBIGA1UEChMLRW50cnVzdC5uZXQxOzA5BgNVBAsTMnd3dy5lbnRydXN0Lm5l
+dC9DUFMgaW5jb3JwLiBieSByZWYuIChsaW1pdHMgbGlhYi4pMSUwIwYDVQQLExwoYykgMTk5OSBF
+bnRydXN0Lm5ldCBMaW1pdGVkMTowOAYDVQQDEzFFbnRydXN0Lm5ldCBTZWN1cmUgU2VydmVyIENl
+cnRpZmljYXRpb24gQXV0aG9yaXR5MQ0wCwYDVQQDEwRDUkwxMCmgJ6AlhiNodHRwOi8vd3d3LmVu
+dHJ1c3QubmV0L0NSTC9uZXQxLmNybDArBgNVHRAEJDAigA8xOTk5MDUyNTE2MDk0MFqBDzIwMTkw
+NTI1MTYwOTQwWjALBgNVHQ8EBAMCAQYwHwYDVR0jBBgwFoAU8BdiE1U9s/8KAGv7UISX8+1i0Bow
+HQYDVR0OBBYEFPAXYhNVPbP/CgBr+1CEl/PtYtAaMAwGA1UdEwQFMAMBAf8wGQYJKoZIhvZ9B0EA
+BAwwChsEVjQuMAMCBJAwDQYJKoZIhvcNAQEFBQADgYEAkNwwAvpkdMKnCqV8IY00F6j7Rw7/JXyN
+Ewr75Ji174z4xRAN95K+8cPV1ZVqBLssziY2ZcgxxufuP+NXdYR6Ee9GTxj005i7qIcyunL2POI9
+n9cd2cNgQ4xYDiKWL2KjLB+6rQXvqzJ4h6BUcxm1XAX5Uj5tLUUL9wqT6u0G+bI=
+-----END CERTIFICATE-----

data/lib/vaulted_billing/certificate_authorities/verisign.pem

@@ -0,0 +1,14 @@
+-----BEGIN CERTIFICATE-----
+MIICPDCCAaUCEHC65B0Q2Sk0tjjKewPMur8wDQYJKoZIhvcNAQECBQAwXzELMAkG
+A1UEBhMCVVMxFzAVBgNVBAoTDlZlcmlTaWduLCBJbmMuMTcwNQYDVQQLEy5DbGFz
+cyAzIFB1YmxpYyBQcmltYXJ5IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTk2
+MDEyOTAwMDAwMFoXDTI4MDgwMTIzNTk1OVowXzELMAkGA1UEBhMCVVMxFzAVBgNV
+BAoTDlZlcmlTaWduLCBJbmMuMTcwNQYDVQQLEy5DbGFzcyAzIFB1YmxpYyBQcmlt
+YXJ5IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIGfMA0GCSqGSIb3DQEBAQUAA4GN
+ADCBiQKBgQDJXFme8huKARS0EN8EQNvjV69qRUCPhAwL0TPZ2RHP7gJYHyX3KqhE
+BarsAx94f56TuZoAqiN91qyFomNFx3InzPRMxnVx0jnvT0Lwdd8KkMaOIG+YD/is
+I19wKTakyYbnsZogy1Olhec9vn2a/iRFM9x2Fe0PonFkTGUugWhFpwIDAQABMA0G
+CSqGSIb3DQEBAgUAA4GBALtMEivPLCYATxQT3ab7/AoRhIzzKBxnki98tsX63/Do
+lbwdj2wsqFHMc9ikwFPwTtYmwHYBV4GSXiHx0bH/59AhWM1pF+NEHJwZRDmJXNyc
+AA9WjQKZ7aKQRUzkuxCkPfAyAw7xzvjoyVGM5mKf5p/AfbdynMk2OmufTqj/ZA1k
+-----END CERTIFICATE-----

data/lib/vaulted_billing/core_ext/hash.rb

@@ -0,0 +1,22 @@
+module VaultedBilling
+  module CoreExt
+    module Hash
+      def to_querystring
+        to_a.reject { |pair| pair.last.nil? }.
+          sort_by { |item| item.first.to_s }.
+          collect { |key, value| "#{key}=#{value}" }.join('&')
+      end
+
+      module ClassMethods
+        def from_querystring(string)
+          ::Hash[string.split(/&/).
+            collect { |i| i.split(/=/) }.
+            collect { |e| e.size == 1 ? (e << '') : e }]
+        end
+      end
+    end
+  end
+end
+
+::Hash.send :include, VaultedBilling::CoreExt::Hash
+::Hash.extend(VaultedBilling::CoreExt::Hash::ClassMethods)

data/lib/vaulted_billing/credit_card.rb

@@ -0,0 +1,24 @@
+module VaultedBilling
+  class CreditCard
+    attr_accessor :id
+    attr_accessor :currency
+    attr_accessor :card_number
+    attr_accessor :cvv_number
+    attr_accessor :expires_on
+    attr_accessor :first_name
+    attr_accessor :last_name
+    attr_accessor :street_address
+    attr_accessor :locality
+    attr_accessor :region
+    attr_accessor :postal_code
+    attr_accessor :country
+    attr_accessor :phone
+
+    def initialize(attributes = {})
+      attributes = HashWithIndifferentAccess.new(attributes)
+      attributes.each_pair do |key, value|
+        send("#{key}=", value) if respond_to?("#{key}=")
+      end
+    end
+  end
+end

data/lib/vaulted_billing/customer.rb

@@ -0,0 +1,12 @@
+module VaultedBilling
+  class Customer
+    attr_accessor :id
+    attr_accessor :email
+
+    def initialize(attributes = {})
+      attributes = HashWithIndifferentAccess.new(attributes)
+      @id = attributes[:id]
+      @email = attributes[:email]
+    end
+  end
+end

data/lib/vaulted_billing/gateway.rb

@@ -0,0 +1,61 @@
+module VaultedBilling
+  module Gateway
+    module Response
+      attr_accessor :response_message
+      attr_writer :success
+      def success?; @success; end
+    end
+
+    def add_customer(customer)
+      raise NotImplementedError
+    end
+
+    def update_customer(customer)
+      raise NotImplementedError
+    end
+
+    def remove_customer(customer)
+      raise NotImplementedError
+    end
+
+    def add_customer_credit_card(customer, credit_card)
+      raise NotImplementedError
+    end
+
+    def update_customer_credit_card(customer, credit_card)
+      raise NotImplementedError
+    end
+
+    def remove_customer_credit_card(customer, credit_card)
+      raise NotImplementedError
+    end
+
+    def authorize(customer, credit_card, amount)
+      raise NotImplementedError
+    end
+
+    def capture(transaction_id, amount)
+      raise NotImplementedError
+    end
+
+    def refund(transaction_id, amount)
+      raise NotImplementedError
+    end
+
+    def void(transaction_id)
+      raise NotImplementedError
+    end
+
+
+    protected
+
+
+    def respond_with(object, options = {})
+      object.tap do |o|
+        o.extend(VaultedBilling::Gateway::Response)
+        o.success = options.has_key?(:success) ? options[:success] : true
+        yield(o) if block_given?
+      end
+    end
+  end
+end

data/lib/vaulted_billing/gateways.rb

@@ -0,0 +1,9 @@
+module VaultedBilling
+  module Gateways
+    Dir[File.expand_path(File.join(File.dirname(__FILE__), 'gateways', '**', '*.rb'))].each do |file|
+      filename = File.basename(file, '.rb')
+      gateway_class = filename.camelize
+      autoload gateway_class, file
+    end
+  end
+end

data/lib/vaulted_billing/gateways/authorize_net_cim.rb

@@ -0,0 +1,217 @@
+module VaultedBilling
+  module Gateways
+
+    ##
+    # An interface to Authorize.net's CIM.
+    #
+    class AuthorizeNetCim
+      include VaultedBilling::Gateway
+      include VaultedBilling::HttpsInterface
+
+      def initialize(options = {})
+        self.test_uri = 'https://apitest.authorize.net/xml/v1/request.api'
+        self.live_uri = 'https://api.authorize.net/xml/v1/request.api'
+        self.ssl_pem = File.read(File.expand_path(File.join(File.dirname(__FILE__), '..', 'certificate_authorities', 'entrust.pem')))
+
+        options = HashWithIndifferentAccess.new(options)
+        @login = options[:username]
+        @password = options[:password]
+        self.use_test_uri = options[:test]
+      end
+
+      def add_customer(customer)
+        data = build_request('createCustomerProfileRequest') do |xml|
+          xml.tag!('profile') do
+            xml.merchantCustomerId customer.id if customer.id
+            xml.email customer.email if customer.email
+          end
+        end
+        result = post_data(data)
+        respond_with(customer, :success => result.success?) { |c| c.id = (result.body['createCustomerProfileResponse'] || {})['customerProfileId'] }
+      end
+
+      def update_customer(customer)
+        result = post_data(build_request('updateCustomerProfileRequest') { |xml|
+          xml.tag!('profile') {
+            xml.merchantCustomerId customer.id
+            xml.email customer.email
+          }
+        })
+        respond_with(customer, :success => result.success?)
+      end
+
+      def remove_customer(customer)
+        result = post_data(build_request('deleteCustomerProfileRequest') { |xml|
+          xml.customerProfileId customer.id
+        })
+        respond_with(customer, :success => result.success?)
+      end
+
+      def add_customer_credit_card(customer, credit_card)
+        result = post_data(build_request('createCustomerPaymentProfileRequest') { |xml|
+          xml.customerProfileId customer.id
+          xml.paymentProfile do
+            billing_info!(xml, customer, credit_card)
+            credit_card_info!(xml, customer, credit_card)
+          end
+        })
+        respond_with(credit_card, :success => result.success?) { |c| c.id = (result.body['createCustomerPaymentProfileResponse'] || {})['customerPaymentProfileId'] }
+      end
+
+      def update_customer_credit_card(customer, credit_card)
+        result = post_data(build_request('updateCustomerPaymentProfileRequest') { |xml|
+          xml.customerProfileId customer.id
+          xml.paymentProfile do
+            billing_info!(xml, customer, credit_card)
+            credit_card_info!(xml, customer, credit_card)
+            xml.customerPaymentProfileId credit_card.id
+          end
+        })
+        respond_with(credit_card, :success => result.success?)
+      end
+
+      def remove_customer_credit_card(customer, credit_card)
+        result = post_data(build_request('deleteCustomerPaymentProfileRequest') { |xml|
+          xml.customerProfileId customer.id
+          xml.customerPaymentProfileId credit_card.id
+        })
+        respond_with(credit_card, :success => result.success?)
+      end
+
+      def authorize(customer, credit_card, amount)
+        result = post_data(build_request('createCustomerProfileTransactionRequest') { |xml|
+          xml.transaction do
+            xml.profileTransAuthOnly do
+              xml.amount amount
+              xml.customerProfileId customer.id
+              xml.customerPaymentProfileId credit_card.id
+            end
+          end
+        })
+        respond_with(new_transaction_from_response(result.body), :success => result.success?)
+      end
+
+      def capture(transaction_id, amount)
+        result = post_data(build_request('createCustomerProfileTransactionRequest') { |xml|
+          xml.transaction do
+            xml.profileTransPriorAuthCapture do
+              xml.amount amount
+              xml.transId transaction_id
+            end
+          end
+        })
+        respond_with(new_transaction_from_response(result.body), :success => result.success?)
+      end
+
+      def refund(transaction_id, amount)
+        result = post_data(build_request('createCustomerProfileTransactionRequest') { |xml|
+          xml.transaction do
+            xml.profileTransRefund do
+              xml.amount amount
+              xml.transId transaction_id
+            end
+          end
+        })
+        respond_with(new_transaction_from_response(result.body), :success => result.success?)
+      end
+
+      def void(transaction_id)
+        result = post_data(build_request('createCustomerProfileTransactionRequest') { |xml|
+          xml.transaction do
+            xml.profileTransVoid do
+              xml.transId transaction_id
+            end
+          end
+        })
+        respond_with(new_transaction_from_response(result.body), :success => result.success?)
+      end
+
+
+      protected
+
+
+      def post_data(data, headers = {})
+        super(data, {'Content-Type' => 'text/xml'}.merge(headers))
+      end
+
+      def before_post(data)
+        VaultedBilling.logger.debug { "Posting: %s to %s" % [data.inspect, uri.inspect] } if VaultedBilling.logger?
+      end
+
+      def after_post(response)
+        VaultedBilling.logger.debug { "Response code %s (HTTP %d), %s" % [response.message, response.code, response.body.inspect] } if VaultedBilling.logger?
+        response.body = Hash.from_xml(response.body)
+        response.success = response.body[response.body.keys.first]['messages']['resultCode'] == 'Ok'
+      end
+
+      def build_request(request, xml = Builder::XmlMarkup.new(:indent => 2))
+        xml.instruct!
+        xml.tag!(request, :xmlns => 'AnetApi/xml/v1/schema/AnetApiSchema.xsd') do
+          xml.tag!('merchantAuthentication') do
+            xml.name @login
+            xml.transactionKey @password
+          end
+          yield(xml)
+        end
+        xml.target!
+      end
+
+
+      private
+
+
+      def billing_info!(xml, customer, credit_card)
+        xml.billTo do
+          xml.firstName credit_card.first_name if credit_card.first_name.present?
+          xml.lastName credit_card.last_name if credit_card.last_name.present?
+          xml.address credit_card.street_address if credit_card.street_address.present?
+          xml.city credit_card.locality if credit_card.locality.present?
+          xml.state credit_card.region if credit_card.region.present?
+          xml.zip credit_card.postal_code if credit_card.postal_code.present?
+          xml.country credit_card.country if credit_card.country.present?
+          xml.phoneNumber credit_card.phone if credit_card.phone.present?
+        end
+      end
+
+      def credit_card_info!(xml, customer, credit_card)
+        xml.payment do
+          xml.creditCard do
+            xml.cardNumber credit_card.card_number if credit_card.card_number.present?
+            xml.expirationDate credit_card.expires_on.strftime("%Y-%m") if credit_card.expires_on.present?
+            xml.cardCode credit_card.cvv_number if credit_card.cvv_number.present?
+          end
+        end
+      end
+
+      def new_transaction_from_response(response)
+        root = response.keys.first
+        if root == 'ErrorResponse'
+          Transaction.new
+        else
+          direct_response = parse_direct_response(response[root]['directResponse'])
+          Transaction.new({
+            :id => direct_response['transaction_id'],
+            :avs_response => direct_response['avs_response'],
+            :cvv_response => direct_response['cvv_response'],
+            :authcode => direct_response['approval_code'],
+            :message => response[root]['messages']['text'],
+            :code => response[root]['messages']['code']
+          })
+        end
+      end
+
+      def parse_direct_response(string)
+        fields = string.split(',')
+        {
+          'message' => fields[3],
+          'approval_code' => fields[4],
+          'avs_response' => fields[5],
+          'transaction_id' => fields[6],
+          'cvv_response' => fields[39]
+        }
+      end
+
+    end
+
+  end
+end

data/lib/vaulted_billing/gateways/bogus.rb

@@ -0,0 +1,61 @@
+require 'digest/md5'
+
+module VaultedBilling
+  module Gateways
+    class Bogus
+      include VaultedBilling::Gateway
+
+      def add_customer(customer)
+        respond_with(customer) { |c| c.id = new_identifier }
+      end
+
+      def update_customer(customer)
+        respond_with customer
+      end
+
+      def remove_customer(customer)
+        respond_with customer
+      end
+
+      def add_customer_credit_card(customer, credit_card)
+        respond_with(credit_card) { |c| c.id = new_identifier }
+      end
+
+      def update_customer_credit_card(customer, credit_card)
+        respond_with credit_card
+      end
+
+      def remove_customer_credit_card(customer, credit_card)
+        respond_with credit_card
+      end
+
+      def authorize(customer, credit_card, amount)
+        transaction_response
+      end
+
+      def void(transaction_id)
+        transaction_response
+      end
+
+      def capture(transaction_id, amount)
+        transaction_response
+      end
+
+      def refund(transaction_id, amount)
+        transaction_response
+      end
+
+
+      private
+
+
+      def new_identifier
+        Digest::MD5.hexdigest("--#{Time.now.to_f}--#{rand(1_000_000)}--#{rand(1_000_000)}--")
+      end
+
+      def transaction_response
+        respond_with VaultedBilling::Transaction.new(:id => new_identifier)
+      end
+    end
+  end
+end

data/lib/vaulted_billing/gateways/nmi_customer_vault.rb

@@ -0,0 +1,171 @@
+module VaultedBilling
+  module Gateways
+
+    ##
+    # An interface to the NMI Customer Vault.
+    #
+    # Currently, the Customer Vault is setup to be one-to-one with
+    # a customer to a credit card.  Unlike Authorize.net's CIM, a 
+    # single customer cannot carry multiple credit cards.  Therefore
+    # most of the individual customer manipulation methods are
+    # simply stubbed to always be successful.  The meat of the library
+    # is in the credit card methods and transactions.
+    # 
+    class NmiCustomerVault
+      include VaultedBilling::Gateway
+      include VaultedBilling::HttpsInterface
+
+      def initialize(options = {})
+        self.live_uri = self.test_uri = "https://secure.nmi.com/api/transact.php"
+        self.ssl_pem = File.read(File.expand_path(File.join(File.dirname(__FILE__), '..', 'certificate_authorities', 'verisign.pem')))
+
+        options = HashWithIndifferentAccess.new(options)
+        @username = options[:username]
+        @password = options[:password]
+        self.use_test_uri = options[:test]
+      end
+
+      ##
+      # A stub, since the vault requires both customer information
+      # and credit card information.  Actual additions are handled
+      # via the add_customer_credit_card method.
+      #
+      def add_customer(customer)
+        respond_with customer
+      end
+
+      ##
+      # A stub, since the vault requires both customer information
+      # and credit card information.  Actual modifications are
+      # handled via the update_customer_credit_card method.
+      #
+      def update_customer(customer)
+        respond_with customer
+      end
+
+      ##
+      # A stub, since the vault requires both customer information
+      # and credit card information.  Actual removals are
+      # handled via the remove_customer_credit_card method.
+      #
+      def remove_customer(customer)
+        respond_with customer
+      end
+
+      def add_customer_credit_card(customer, credit_card)
+        response = post_data(storage_data('add_customer', customer, credit_card))
+        respond_with(credit_card, :success => response.success?) do |c|
+          c.id = response.body['customer_vault_id']
+        end
+      end
+
+      def update_customer_credit_card(customer, credit_card)
+        response = post_data(storage_data('update_customer', customer, credit_card))
+        respond_with(credit_card, :success => response.success?)
+      end
+
+      def remove_customer_credit_card(customer, credit_card)
+        response = post_data(core_data.merge({
+          :customer_vault => 'delete_customer',
+          :customer_vault_id => credit_card.id
+        }).to_querystring)
+        respond_with(credit_card, :success => response.success?)
+      end
+
+      def authorize(customer, credit_card, amount)
+        response = post_data(transaction_data('auth', {
+          :customer_vault_id => credit_card.id,
+          :amount => amount
+        }))
+        respond_with(new_transaction_from_response(response.body),
+                     :success => response.success?)
+      end
+
+      def capture(transaction_id, amount)
+        response = post_data(transaction_data('capture', {
+          :transactionid => transaction_id,
+          :amount => amount
+        }))
+        respond_with(new_transaction_from_response(response.body),
+                     :success => response.success?)
+      end
+
+      def refund(transaction_id, amount)
+        response = post_data(transaction_data('refund', {
+          :transactionid => transaction_id,
+          :amount => amount
+        }))
+        respond_with(new_transaction_from_response(response.body),
+                     :success => response.success?)
+      end
+
+      def void(transaction_id)
+        response = post_data(transaction_data('void', {
+          :transactionid => transaction_id
+        }))
+        respond_with(new_transaction_from_response(response.body),
+                     :success => response.success?)
+      end
+
+
+      protected
+
+
+      def before_post(data)
+        VaultedBilling.logger.debug { "Posting %s to %s" % [data.inspect, uri.to_s] } if VaultedBilling.logger?
+      end
+
+      def after_post(response)
+        VaultedBilling.logger.debug { "Response code %s (HTTP %d), %s" % [response.message, response.code, response.body.inspect] } if VaultedBilling.logger?
+        response.body = Hash.from_querystring(response.body)
+        response.success = response.body['response'] == '1'
+      end
+
+
+      private
+
+
+      def core_data
+        {
+          :username => @username,
+          :password => @password
+        }
+      end
+
+      def transaction_data(method, overrides = {})
+        core_data.merge(overrides).to_querystring
+      end
+
+      def storage_data(method, customer, credit_card)
+        core_data.merge({
+          :customer_vault => method.to_s,
+          :customer_vault_id => credit_card.id,
+          :currency => credit_card.currency,
+          :method => 'creditcard',
+          :ccnumber => credit_card.card_number,
+          :ccexp => credit_card.expires_on.try(:strftime, "%y%m"),
+          :first_name => credit_card.first_name,
+          :last_name => credit_card.last_name,
+          :address1 => credit_card.street_address,
+          :city => credit_card.locality,
+          :state => credit_card.region,
+          :zip => credit_card.postal_code,
+          :country => credit_card.country,
+          :phone => credit_card.phone,
+          :email => customer.email
+        }).to_querystring
+      end
+
+      def new_transaction_from_response(response)
+        Transaction.new({
+          :id => response['transactionid'],
+          :avs_response => response['avsresponse'] == 'Y',
+          :cvv_response => response['cvvresponse'] == 'Y',
+          :authcode => response['authcode'],
+          :message => response['responsetext'],
+          :code => response['response_code']
+        })
+      end
+    end
+  end
+end

data/lib/vaulted_billing/https_interface.rb

@@ -0,0 +1,80 @@
+require 'net/https'
+require 'uri'
+
+module VaultedBilling
+  module HttpsInterface
+
+    class PostResponse
+      attr_accessor :code
+      attr_accessor :message
+      attr_accessor :body
+      attr_accessor :success
+      attr_accessor :raw_response
+
+      def initialize(http_response)
+        self.raw_response = http_response
+        self.code = http_response.code
+        self.message = http_response.message
+        self.body = http_response.body
+        self.success = ((http_response.code =~ /^2\d{2}/) == 0)
+      end
+
+      alias :success? :success
+      alias :status_code :code
+    end
+
+    attr_writer :use_test_uri
+    attr_writer :ssl_pem
+
+    def live_uri=(input)
+      @live_uri = input ? URI.parse(input) : nil
+    end
+
+    def test_uri=(input)
+      @test_uri = input ? URI.parse(input) : nil
+    end
+
+    ##
+    # Returns the protocol and host and any path details that is used
+    # when making communications.
+    #
+    def uri
+      @use_test_uri ? @test_uri : @live_uri
+    end
+
+    ##
+    # Posts the given data to the uri and returns the response.
+    #
+    def post_data(data, request_headers = {})
+      request = Net::HTTP::Post.new(uri.path)
+      request.initialize_http_header({
+        'User-Agent' => "vaulted_billing #{VaultedBilling::Version}"
+      }.reverse_merge(request_headers))
+      request.body = data
+      response = Net::HTTP.new(uri.host, uri.port).tap do |https|
+        https.use_ssl = true
+        if @ssl_pem
+          https.cert = OpenSSL::X509::Certificate.new(@ssl_pem)
+          https.verify_mode = OpenSSL::SSL::VERIFY_PEER
+        else
+          https.verify_mode = OpenSSL::SSL::VERIFY_NONE
+        end
+      end
+
+      before_post(data)
+      response = response.request(request)
+      PostResponse.new(response).tap do |post_response|
+        after_post(post_response)
+      end
+    end
+    protected :post_data
+
+    def before_post(data)
+    end
+    protected :before_post
+
+    def after_post(response)
+    end
+    protected :after_post
+  end
+end

data/lib/vaulted_billing/transaction.rb

@@ -0,0 +1,16 @@
+module VaultedBilling
+  class Transaction
+    attr_accessor :id
+    attr_accessor :authcode
+    attr_accessor :avs_response
+    attr_accessor :cvv_response
+    attr_accessor :code
+    attr_accessor :message
+
+    def initialize(attributes = {})
+      attributes.each_pair do |key, value|
+        send("#{key}=", value) if respond_to?("#{key}=")
+      end
+    end
+  end
+end

data/lib/vaulted_billing/version.rb

@@ -0,0 +1,3 @@
+module VaultedBilling
+  Version = '0.0.0'
+end

metadata

@@ -0,0 +1,177 @@
+--- !ruby/object:Gem::Specification 
+name: vaulted_billing
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 0
+  version: 0.0.0
+platform: ruby
+authors: 
+- Nathaniel Bibler
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-08-23 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 3
+        version: "2.3"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: builder
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 1
+        - 2
+        version: 2.1.2
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 0
+        - 0
+        - beta
+        - 19
+        version: 2.0.0.beta.19
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: vcr
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 3
+        version: 1.0.3
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: webmock
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 3
+        - 4
+        version: 1.3.4
+  type: :development
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: factory_girl
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 3
+        - 2
+        version: 1.3.2
+  type: :development
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: faker
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 3
+        - 1
+        version: 0.3.1
+  type: :development
+  version_requirements: *id007
+description: Several card processors and gateways support offloading the storage of credit card information onto their service.  This offloads PCI compliance to the gateway rather than keeping it with each retailer.  This library abstracts the interface to many of them, making it trivial to work with any or all of them.
+email: 
+- nate@envylabs.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/vaulted_billing/certificate_authorities/entrust.pem
+- lib/vaulted_billing/certificate_authorities/verisign.pem
+- lib/vaulted_billing/core_ext/hash.rb
+- lib/vaulted_billing/credit_card.rb
+- lib/vaulted_billing/customer.rb
+- lib/vaulted_billing/gateway.rb
+- lib/vaulted_billing/gateways/authorize_net_cim.rb
+- lib/vaulted_billing/gateways/bogus.rb
+- lib/vaulted_billing/gateways/nmi_customer_vault.rb
+- lib/vaulted_billing/gateways.rb
+- lib/vaulted_billing/https_interface.rb
+- lib/vaulted_billing/transaction.rb
+- lib/vaulted_billing/version.rb
+- lib/vaulted_billing.rb
+- README.md
+has_rdoc: true
+homepage: http://github.com/envylabs/vaulted_billing
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: A library for working with credit card storage gateways
+test_files: []
+