figpay_gateway 1.0.0

data/bin/test_all_methods

@@ -0,0 +1,330 @@
+#!/usr/bin/env ruby
+require "pry"
+require 'bundler/setup'
+require 'figpay_gateway'
+require 'dotenv'
+Dotenv.load
+
+# Use demo credentials if not set
+ENV['NMI_SECURITY_KEY'] ||= '6457Thfj624V5r7WUwc5v6a68Zsd6YEm'
+
+puts "=" * 80
+puts "FigPay Gateway - Comprehensive Method Test"
+puts "=" * 80
+puts "Using Security Key: #{ENV['NMI_SECURITY_KEY'][0..10]}..."
+puts "=" * 80
+puts
+
+# Store results
+results = {}
+customer_vault_id = nil
+subscription_id = nil
+transaction_id = nil
+auth_transaction_id = nil
+
+# Helper method to display results
+def display_result(name, result)
+  puts "\n#{'-' * 80}"
+  puts "Test: #{name}"
+
+  if result.success?
+    puts "Status: ✓ SUCCESS"
+    puts "Response Code: #{result.response_code}" if result.respond_to?(:response_code)
+    puts "Response Message: #{result.response_message}" if result.respond_to?(:response_message) && result.response_message
+    puts "Transaction ID: #{result.transactionid}" if result.respond_to?(:transactionid) && result.transactionid
+    puts "Customer Vault ID: #{result.customer_vault_id}" if result.respond_to?(:customer_vault_id) && result.customer_vault_id
+    puts "Subscription ID: #{result.subscription_id}" if result.respond_to?(:subscription_id) && result.subscription_id
+    puts "Auth Code: #{result.authcode}" if result.respond_to?(:authcode) && result.authcode
+    puts "Response: #{result.response}" if result.respond_to?(:response) && result.response
+  else
+    puts "Status: ✗ FAILED"
+    puts "Error: #{result.response_text}" if result.respond_to?(:response_text)
+    puts "Response Code: #{result.response_code}" if result.respond_to?(:response_code)
+    puts "Response Message: #{result.response_message}" if result.respond_to?(:response_message) && result.response_message
+    puts "Response: #{result.response}" if result.respond_to?(:response) && result.response
+  end
+
+  puts "-" * 80
+  result
+end
+
+puts "\n### TRANSACTION TESTS ###\n"
+
+# Test 1: Validate Card
+puts "\n1. Testing Card Validation..."
+result = FigpayGateway::Transaction.new.validate(
+  ccnumber: '4111111111111111',
+  ccexp: '1225',
+  first_name: 'John',
+  last_name: 'Doe',
+  email: 'john@example.com'
+)
+results[:validate] = display_result("Card Validation", result)
+
+# Test 2: Sale Transaction
+puts "\n2. Testing Sale Transaction..."
+result = FigpayGateway::Transaction.new.sale(
+  ccnumber: '4111111111111111',
+  ccexp: '1225',
+  cvv: '999',
+  amount: 10.00,
+  first_name: 'John',
+  last_name: 'Doe',
+  address1: '123 Main St',
+  city: 'Beverly Hills',
+  state: 'CA',
+  zip: '90210',
+  country: 'US',
+  email: 'john@example.com'
+)
+results[:sale] = display_result("Sale Transaction", result)
+transaction_id = result.transactionid if result.success? && result.respond_to?(:transactionid)
+
+# Test 3: Authorization
+puts "\n3. Testing Authorization..."
+result = FigpayGateway::Transaction.new.authorize(
+  ccnumber: '4111111111111111',
+  ccexp: '1225',
+  amount: 25.00,
+  first_name: 'John',
+  last_name: 'Doe',
+  email: 'john@example.com'
+)
+results[:authorize] = display_result("Authorization", result)
+auth_transaction_id = result.transactionid if result.success? && result.respond_to?(:transactionid)
+
+# Test 4: Capture (if authorization succeeded)
+if auth_transaction_id
+  puts "\n4. Testing Capture..."
+  result = FigpayGateway::Transaction.new.capture(
+    transactionid: auth_transaction_id,
+    amount: 25.00
+  )
+  results[:capture] = display_result("Capture", result)
+else
+  puts "\n4. Skipping Capture (no auth transaction ID)"
+end
+
+# Test 5: Credit (Standalone)
+puts "\n5. Testing Standalone Credit..."
+result = FigpayGateway::Transaction.new.credit(
+  ccnumber: '4111111111111111',
+  ccexp: '1225',
+  amount: 5.00,
+  first_name: 'John',
+  last_name: 'Doe',
+  email: 'john@example.com'
+)
+results[:credit] = display_result("Standalone Credit", result)
+
+# Test 6: Find Transaction (if we have a transaction ID)
+if transaction_id
+  puts "\n6. Testing Transaction Query..."
+  result = FigpayGateway::Transaction.new.find(
+    transactionid: transaction_id
+  )
+  results[:find_transaction] = display_result("Transaction Query", result)
+else
+  puts "\n6. Skipping Transaction Query (no transaction ID)"
+end
+
+# Test 7: Update Transaction (if we have a transaction ID)
+if transaction_id
+  puts "\n7. Testing Transaction Update..."
+  result = FigpayGateway::Transaction.new.update(
+    transactionid: transaction_id,
+    orderid: 'TEST-ORDER-123',
+    order_description: 'Test order updated'
+  )
+  results[:update_transaction] = display_result("Transaction Update", result)
+else
+  puts "\n7. Skipping Transaction Update (no transaction ID)"
+end
+
+# Test 8: Refund (if we have a transaction ID)
+if transaction_id
+  puts "\n8. Testing Refund..."
+  result = FigpayGateway::Transaction.new.refund(
+    transactionid: transaction_id,
+    amount: 5.00
+  )
+  results[:refund] = display_result("Refund", result)
+else
+  puts "\n8. Skipping Refund (no transaction ID)"
+end
+
+# Test 9: Void (create a new transaction to void)
+puts "\n9. Testing Void..."
+void_result = FigpayGateway::Transaction.new.sale(
+  ccnumber: '4111111111111111',
+  ccexp: '1225',
+  amount: 1.00,
+  first_name: 'John',
+  last_name: 'Doe',
+  email: 'john@example.com'
+)
+if void_result.success? && void_result.respond_to?(:transactionid)
+  result = FigpayGateway::Transaction.new.void(
+    transactionid: void_result.transactionid
+  )
+  results[:void] = display_result("Void Transaction", result)
+else
+  puts "Skipping Void (could not create transaction to void)"
+end
+
+puts "\n\n### CUSTOMER VAULT TESTS ###\n"
+
+# Test 10: Create Customer
+puts "\n10. Testing Customer Vault Create..."
+result = FigpayGateway::CustomerVault.new.create(
+  ccnumber: '4111111111111111',
+  ccexp: '1225',
+  cvv: '999',
+  first_name: 'Jane',
+  last_name: 'Smith',
+  address1: '456 Oak Ave',
+  city: 'Los Angeles',
+  state: 'CA',
+  zip: '90001',
+  email: 'jane@example.com'
+)
+results[:create_customer] = display_result("Create Customer", result)
+customer_vault_id = result.customer_vault_id if result.success? && result.respond_to?(:customer_vault_id)
+
+# Test 11: Update Customer (if we have a customer vault ID)
+if customer_vault_id
+  puts "\n11. Testing Customer Vault Update..."
+  result = FigpayGateway::CustomerVault.new.update(
+    customer_vault_id: customer_vault_id,
+    first_name: 'Jane',
+    last_name: 'Doe-Smith',
+    email: 'jane.smith@example.com'
+  )
+  results[:update_customer] = display_result("Update Customer", result)
+else
+  puts "\n11. Skipping Customer Update (no customer vault ID)"
+end
+
+# Test 12: Find Customer (if we have a customer vault ID)
+if customer_vault_id
+  puts "\n12. Testing Customer Vault Query..."
+  result = FigpayGateway::CustomerVault.new.find(
+    customer_vault_id: customer_vault_id
+  )
+  results[:find_customer] = display_result("Find Customer", result)
+else
+  puts "\n12. Skipping Customer Query (no customer vault ID)"
+end
+
+# Test 13: Charge Vaulted Customer (if we have a customer vault ID)
+if customer_vault_id
+  puts "\n13. Testing Charge Vaulted Customer..."
+  result = FigpayGateway::Transaction.new.sale(
+    customer_vault_id: customer_vault_id,
+    amount: 15.00,
+    orderid: 'VAULT-ORDER-456'
+  )
+  results[:charge_vaulted] = display_result("Charge Vaulted Customer", result)
+else
+  puts "\n13. Skipping Charge Vaulted Customer (no customer vault ID)"
+end
+
+puts "\n\n### RECURRING BILLING TESTS ###\n"
+
+# Test 14: Create Billing Plan
+puts "\n14. Testing Create Billing Plan..."
+result = FigpayGateway::Recurring.new.create_plan(
+  plan_id: "test-plan-#{Time.now.to_i}",
+  plan_name: 'Test Monthly Plan',
+  plan_amount: 29.99,
+  month_frequency: 1,
+  day_of_month: 1
+)
+results[:create_plan] = display_result("Create Billing Plan", result)
+plan_id = result.plan_id if result.success? && result.respond_to?(:plan_id)
+
+# Test 15: Add Subscription to Plan (if we have both plan and customer)
+if plan_id && customer_vault_id
+  puts "\n15. Testing Subscribe Customer to Plan..."
+  result = FigpayGateway::Recurring.new.add_subscription_to_plan(
+    plan_id: plan_id,
+    customer_vault_id: customer_vault_id
+  )
+  results[:add_subscription] = display_result("Subscribe to Plan", result)
+  subscription_id = result.subscription_id if result.success? && result.respond_to?(:subscription_id)
+elsif !plan_id
+  puts "\n15. Skipping Subscribe to Plan (no plan ID)"
+elsif !customer_vault_id
+  puts "\n15. Skipping Subscribe to Plan (no customer vault ID)"
+end
+
+# Test 16: Create Custom Subscription (if we have customer vault ID)
+if customer_vault_id && !subscription_id
+  puts "\n16. Testing Create Custom Subscription..."
+  result = FigpayGateway::Recurring.new.add_custom_subscription(
+    customer_vault_id: customer_vault_id,
+    plan_amount: 19.99,
+    month_frequency: 1,
+    day_of_month: 15
+  )
+  results[:custom_subscription] = display_result("Create Custom Subscription", result)
+  subscription_id = result.subscription_id if result.success? && result.respond_to?(:subscription_id)
+else
+  puts "\n16. Skipping Custom Subscription (no customer or already subscribed)"
+end
+
+# Test 17: Update Subscription (if we have subscription ID)
+if subscription_id
+  puts "\n17. Testing Update Subscription..."
+  result = FigpayGateway::Recurring.new.update_subscription(
+    subscription_id: subscription_id,
+    plan_amount: 24.99
+  )
+  results[:update_subscription] = display_result("Update Subscription", result)
+else
+  puts "\n17. Skipping Update Subscription (no subscription ID)"
+end
+
+# Test 18: Cancel Subscription (if we have subscription ID)
+if subscription_id
+  puts "\n18. Testing Cancel Subscription..."
+  result = FigpayGateway::Recurring.new.delete_subscription(
+    subscription_id: subscription_id
+  )
+  results[:delete_subscription] = display_result("Cancel Subscription", result)
+else
+  puts "\n18. Skipping Cancel Subscription (no subscription ID)"
+end
+
+# Test 19: Delete Customer (if we have customer vault ID)
+if customer_vault_id
+  puts "\n19. Testing Delete Customer..."
+  result = FigpayGateway::CustomerVault.new.destroy(
+    customer_vault_id: customer_vault_id
+  )
+  results[:delete_customer] = display_result("Delete Customer", result)
+else
+  puts "\n19. Skipping Delete Customer (no customer vault ID)"
+end
+
+# Summary
+puts "\n\n"
+puts "=" * 80
+puts "TEST SUMMARY"
+puts "=" * 80
+
+successful = results.select { |k, v| v.success? }.count
+total = results.count
+
+puts "Total Tests Run: #{total}"
+puts "Successful: #{successful}"
+puts "Failed: #{total - successful}"
+puts "\nSuccess Rate: #{(successful.to_f / total * 100).round(2)}%"
+
+puts "\nDetailed Results:"
+results.each do |name, result|
+  status = result.success? ? "✓ PASS" : "✗ FAIL"
+  puts "  #{status} - #{name}"
+end
+
+puts "=" * 80

data/figpay_gateway.gemspec

@@ -0,0 +1,47 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'figpay_gateway/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "figpay_gateway"
+  spec.version       = FigpayGateway::VERSION
+  spec.authors       = ["Ben Eggett"]
+  spec.email         = ["beneggett@gmail.com"]
+
+  spec.summary       = %q{ FigPay Gateway (NMI) Api }
+  spec.description   = %q{ Ruby wrapper for interacting with FigPay Gateway. FigPay is a white label gateway for NMI. Built with portability in mind for other NMI white-label providers. }
+  spec.homepage      = "https://github.com/beneggett/figpay_gateway"
+  spec.license       = "MIT"
+
+  spec.required_ruby_version = ">= 3.0.0"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = "https://rubygems.org"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against public gem pushes."
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", ">= 2.0"
+  spec.add_development_dependency "rake", ">= 13.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "vcr"
+  spec.add_development_dependency "webmock"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "guard"
+  spec.add_development_dependency "guard-minitest"
+  spec.add_development_dependency "coveralls"
+  spec.add_development_dependency "simplecov"
+  spec.add_development_dependency "minitest-focus"
+  spec.add_development_dependency "dotenv"
+  spec.add_dependency "httparty", ">= 0.14.0"
+  spec.add_dependency "activesupport"
+
+end

data/lib/figpay_gateway/version.rb

@@ -0,0 +1,3 @@
+module FigpayGateway
+  VERSION = "1.0.0"
+end

data/lib/figpay_gateway.rb

@@ -0,0 +1,3 @@
+# FigPay Gateway is a wrapper around the NMI Gateway
+# This allows the gem to be portable across different NMI white-label providers
+require "nmi_gateway"

data/lib/nmi_gateway/api.rb

@@ -0,0 +1,195 @@
+module NMIGateway
+  class Api
+    TRANSACTION_URL = ENV.fetch("NMI_TRANSACTION_URL", "https://figpay.transactiongateway.com/api/transact.php")
+    QUERY_URL = ENV.fetch("NMI_QUERY_URL", "https://figpay.transactiongateway.com/api/query.php")
+    include HTTParty
+
+    attr_accessor :security_key, :query
+
+    def initialize(options = {})
+      @security_key = options[:security_key] || ENV["NMI_SECURITY_KEY"]
+    end
+
+    def get(options={})
+      response = self.class.get(QUERY_URL, query: options.merge(credentials), timeout: 30, headers: headers)
+      api_type = options[:type] || options[:report_type]
+      handle_response(response, api_type)
+    end
+
+    def post(options={})
+      response = self.class.get(TRANSACTION_URL, query: options.merge(credentials), timeout: 30, headers: headers)
+      api_type = options[:type] || options[:customer_vault]
+      handle_response(response, api_type)
+    end
+
+    private
+
+    def handle_response(response, api_type)
+      if response.success?
+        NMIGateway::Response.new(response, api_type)
+      else
+        NMIGateway::Error.new(response.code, response.message, response)
+      end
+    end
+
+    def headers
+      {'Content-Type' => "application/xml", 'Accept' => "application/xml"}
+    end
+
+    def credentials
+      creds = {security_key: security_key}
+      creds[:test_mode] = ENV['NMI_TEST_MODE'] if ENV['NMI_TEST_MODE']
+      creds
+    end
+
+    def set_query(options = {})
+      query = {}
+      query[:customer_vault]               = options[:customer_vault] # add_customer or update_customer
+      query[:customer_vault_id]            = options[:customer_vault_id]
+      query[:transactionid]                = options[:transactionid]
+      query[:billing_id]                   = options[:billing_id]
+
+      # Query params
+      query[:condition]                    = options[:condition]  # pending, pendingsettlement, failed, canceled, complete, unknown. Can be stringed together.
+      query[:transaction_type]             = options[:transaction_type] # cc, ck
+      query[:action_type]                  = options[:action_type] # sale, refund, credit, auth, capture, void, return
+
+      query[:transaction_id]               = options[:transaction_id] # can me multiple together
+      query[:cc_number]                    = options[:cc_number] # You can use either the full number or the last 4 digits of the credit card number.
+      query[:end_date]                     = options[:end_date] # YYYYMMDDhhmmss
+      query[:report_type]                  = options[:report_type] # receipt or customer_vault
+      query[:mobile_device_license]        = options[:mobile_device_license]
+      query[:mobile_device_nickname]       = options[:mobile_device_nickname]
+
+
+      # Credit Cards
+      query[:ccnumber]                     = options[:ccnumber]
+      query[:ccexp]                        = options[:ccexp] # FORMAT MMYY
+      query[:cvv]                          = options[:cvv] # Recommended
+
+      # Payment
+      query[:amount]                       = options[:amount]
+      query[:currency]                     = options[:currency] || 'USD'
+      query[:payment]                      = options[:payment] || 'creditcard' # creditcard or check
+      query[:processor_id]                 = options[:processor_id]
+      query[:dup_seconds]                  = options[:dup_seconds]
+      query[:billing_method]               = options[:billing_method] # recurring
+      query[:customer_receipt]             = options[:customer_receipt] # true, false
+
+      # Advanced Payment
+      query[:tax]                          = options[:tax]
+      query[:shipping]                     = options[:shipping]
+
+      # Recurring Billing
+      query[:recurring]                    = options[:recurring ] # add_subscription
+      query[:plan_id]                      = options [:plan_id]
+      query[:plan_name]                      = options [:plan_name]
+      query[:plan_payments]                = options [:plan_payments] # 0 until canceled
+      query[:plan_amount]                  = options [:plan_amount]
+      query[:day_frequency]                = options [:day_frequency]
+      query[:month_frequency]              = options [:month_frequency] # 1-24
+      query[:day_of_month]                 = options [:day_of_month] # 1-31
+      query[:start_date]                   = options [:start_date] #YYYYMMDD
+      query[:subscription_id]              = options [:subscription_id]
+
+
+      # Customer Billing
+      query[:first_name]                   = options[:first_name]
+      query[:last_name]                    = options[:last_name]
+      query[:company]                      = options[:company]
+      query[:address1]                     = options[:address1]
+      query[:address2]                     = options[:address2]
+      query[:city]                         = options[:city]
+      query[:state]                        = options[:state]
+      query[:zip]                          = options[:zip]
+      query[:country]                      = options[:country]
+      query[:phone]                        = options[:phone]
+      query[:fax]                          = options[:fax]
+      query[:email]                        = options[:email]
+      query[:ipaddress]                    = options[:ipaddress] # Recommended
+
+      # Additional Customer Info
+      query[:social_security_number]       = options[:social_security_number]
+      query[:drivers_license_number]       = options[:drivers_license_number]
+      query[:drivers_license_dob]          = options[:drivers_license_dob]
+      query[:drivers_license_state]        = options[:drivers_license_state]
+
+      # Customer Shipping
+      query[:shipping_id]                  = options[:shipping_id]
+      query[:shipping_first_name]          = options[:shipping_first_name]
+      query[:shipping_last_name]           = options[:shipping_last_name]
+      query[:shipping_company]             = options[:shipping_company]
+      query[:shipping_address1]            = options[:shipping_address1]
+      query[:shipping_address2]            = options[:shipping_address2]
+      query[:shipping_city]                = options[:shipping_city]
+      query[:shipping_state]               = options[:shipping_state]
+      query[:shipping_zip]                 = options[:shipping_zip]
+      query[:shipping_country]             = options[:shipping_country]
+      query[:shipping_phone]               = options[:shipping_phone]
+      query[:shipping_fax]                 = options[:shipping_fax]
+      query[:shipping_email]               = options[:shipping_email]
+
+      # For ACH
+      query[:checkname]                    = options[:check_name]
+      query[:checkaba]                     = options[:check_routing_number] # routing_number
+      query[:checkaccount]                 = options[:check_account_number]
+      query[:account_holder_type]          = options[:account_holder_type] # personal or 'business'
+      query[:account_type]                 = options[:account_type]  # checking or savings
+      query[:sec_code]                     = options[:sec_code] #  'PPD', 'WEB', 'TEL', or 'CCD'
+
+      # Optional order fields
+      query[:orderid]                      = options[:orderid]
+      query[:order_description]            = options[:order_description]
+      query[:order_date]                   = options[:order_date]
+      query[:ponumber]                     = options[:ponumber]
+      query[:tracking_number]              = options[:tracking_number]
+
+      # order update fields
+      query[:shipping_carrier]             = options[:shipping_carrier] #  ups, fedex, dhl, or usps
+      query[:shipping_postal]              = options[:shipping_postal]
+      query[:ship_from_postal]             = options[:ship_from_postal]
+      query[:shipping_date]                = options[:shipping_date]
+      query[:summary_commodity_code]       = options[:summary_commodity_code]
+      query[:duty_amount]                  = options[:duty_amount]
+      query[:discount_amount]              = options[:discount_amount]
+      query[:tax]                          = options[:tax]
+      query[:national_tax_amount]          = options[:national_tax_amount]
+      query[:alternate_tax_amount]         = options[:alternate_tax_amount]
+      query[:alternate_tax_id]             = options[:alternate_tax_id]
+      query[:vat_tax_amount]               = options[:vat_tax_amount]
+      query[:vat_tax_rate]                 = options[:vat_tax_rate]  #  1% = 1.00.
+      query[:vat_invoice_reference_number] = options[:vat_invoice_reference_number]
+      query[:merchant_vat_registration]    = options[:merchant_vat_registration]
+      # merchant_defined_field_#  Merchant Defined Fields.
+
+
+
+      # Descriptor fields
+      query[:descriptor]                   = options[:descriptor]
+      query[:descriptor_phone]             = options[:descriptor_phone]
+      query[:descriptor_address]           = options[:descriptor_address]
+      query[:descriptor_city]              = options[:descriptor_city]
+      query[:descriptor_state]             = options[:descriptor_state]
+      query[:descriptor_postal]            = options[:descriptor_postal]
+      query[:descriptor_country]           = options[:descriptor_country]
+      query[:descriptor_mcc]               = options[:descriptor_mcc]
+      query[:descriptor_merchant_id]       = options[:descriptor_merchant_id]
+      query[:descriptor_url]               = options[:descriptor_url]
+
+      1..20.to_a.each do |i|
+        query["merchant_defined_field_#{i}".to_sym] = options["merchant_defined_field_#{i}".to_sym]
+      end if options.select {|k,v| k.to_s.starts_with? 'merchant_defined_field' }.any?
+
+      @query = query.select {|k,v| !v.nil?}
+
+    end
+
+    def require_fields(*fields)
+      if query.values_at(*fields).include?(nil)
+        missing_fields = fields - query.keys
+        raise Error::MissingParameters.new("Missing required keys: #{missing_fields.to_s.gsub(']', '').gsub('[', '')}") if missing_fields.any?
+      end
+    end
+  end
+end
+

data/lib/nmi_gateway/customer_vault.rb

@@ -0,0 +1,38 @@
+module NMIGateway
+  class CustomerVault < Api
+
+    # NMIGateway::CustomerVault.new.create ccnumber: '4111111111111111', ccexp: "0219", first_name: "John", last_name: "Doe"
+    def create(options = {})
+      query = set_query(options)
+      query[:customer_vault] = 'add_customer'
+
+      require_fields(:ccnumber, :ccexp)
+      post query
+    end
+
+    # NMIGateway::CustomerVault.new.update customer_vault_id: 481397475, ccnumber: '4111111111111111', ccexp: "0220", first_name: "Jane", last_name: "Doe"
+    def update(options = {})
+      query = set_query(options)
+      query[:customer_vault] = 'update_customer'
+      require_fields(:customer_vault_id)
+      post query
+    end
+
+    # NMIGateway::CustomerVault.new.destroy customer_vault_id: 481397475
+    def destroy(options = {})
+      query = set_query(options)
+      query[:customer_vault] = 'delete_customer'
+      require_fields(:customer_vault_id)
+      post query
+    end
+
+    # NMIGateway::CustomerVault.new.find customer_vault_id: 481397475
+    def find(options = {})
+      query = set_query(options)
+      query[:report_type] = 'customer_vault'
+      require_fields(:customer_vault_id)
+      get query
+    end
+
+  end
+end

data/lib/nmi_gateway/data.rb

@@ -0,0 +1,15 @@
+module NMIGateway
+  class Data
+
+    # Attributes that have a value
+    def attributes
+      all_attributes.select {|x| !self.send(x).nil? }
+    end
+
+    def all_attributes
+      self.instance_variables.map{|attribute| attribute.to_s.gsub('@', '').to_sym }
+    end
+
+  end
+
+end

data/lib/nmi_gateway/error.rb

@@ -0,0 +1,20 @@
+module NMIGateway
+  class Error
+    class AuthenticationError < StandardError; end
+    class NoApiKey < AuthenticationError; end
+    class InvalidResponseFormat < TypeError; end
+    class MissingParameters < TypeError; end
+    class Timeout < Timeout::Error ; end
+    class NoData < EOFError; end
+
+    attr_reader :message, :code, :response
+
+    def initialize( code, message, response)
+      @code = response_code
+      @message = response_message
+      @response = response
+    end
+
+  end
+end
+