figpay_gateway 1.0.0 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f0a09ef25c0277c79ba548c7dea0845e8bcbdc85b98ce4b744f68b38cf3f6a7c
-  data.tar.gz: 8bc4a5747095180ee934641f4a7519a1770bffa72336b38a5a6c6a5896bb21a1
+  metadata.gz: d59cba6b47a82b9e89b53596dfacbab9d878a5d4d9cea9d8203c7b86f16437ad
+  data.tar.gz: a1c7b968a83539aff97dd6ca9ecbcb036b7618ade945572ac6221a3c4aaf96ed
 SHA512:
-  metadata.gz: 586f04f067969ed8ed10712642c0a35a0cae7db3e312f92a2b1fa492ae8ca06e5ebe2e5b08899ef1251cf32954c28cab75e26d8f07305f4ec381e31086990749
-  data.tar.gz: dced5d25b7e481f951bb6e29236b5536eb35822c5ba666e1a817b1065f1c8a765bb70cc997e843e1517d654773031319aaa9db982084b1cd007fc9c83508f9f8
+  metadata.gz: 38b028203836e1051721ea735c616c331632833cda9eb0f15e15d9b0fa73236db8d433eb1f6715c8c692db56b918b45e3381c5d30f6738d4a214520fb6c1e8f3
+  data.tar.gz: cc42df57043042e8daa71c4648d0698af797432390d8f00fb2df31f6fbc39c7ef7ac0355d4ec140ab8bccab6613d2b0f9b95b89dbad5acaf00a34eef3928f538

data/.gitignore

@@ -17,7 +17,7 @@ mkmf.log
 
 .DS_Store
 .env
-.ruby-version
+# .ruby-version # used in ci.yml
 .ruby-gemset
 
 # Editor tags files

data/.ruby-version

@@ -0,0 +1 @@
+3.4.5

data/README.md

@@ -86,6 +86,17 @@ The FigPay Gateway library is organized around three main API sets:
 
 Process credit card transactions including sales, authorizations, captures, and refunds.
 
+#### Recommendation - use collect.js to tokenize cards client side
+
+The payment gateway supports credit card tokenization via [Collect.js](https://figpay.transactiongateway.com//merchants/resources/integration/integration_portal.php#cjs_methodology). The benefit of this approach is that sensitive PCI information will be submitted directly to payment processor servers, they will return a token that you would send back to your servers, and reduce the PCI SAQ compliance requirements from SAQ-C or SAQ-D to SAQ-A. This greatly simplifies compliance, as no credit information would ever touch your logs or servers.
+
+Test Token example: `00000000-000000-000000-000000000000`
+This is tied to a test card: `Card: 4111111111111111, Expiration: October 2025, CVV: 999`
+
+Usage, in all examples, rather than passing in `ccnumber` and `ccexp`, these can be updated to use the token obtained via Collect.js and passed in as a `payment_token` param instead.
+
+There is a Test Public Key that can be used with Collect.js: `48r3R6-M39Jx5-467srN-VWVbD3`
+
 #### Create a Sale
 
 Process a direct sale (authorization and capture combined):
@@ -186,7 +197,7 @@ Retrieve transaction details:
 
 ```ruby
 details = FigpayGateway::Transaction.new.find(
-  transactionid: '3261844010'
+  transaction_id: '3261844010'
 )
 ```
 

data/lib/figpay_gateway/version.rb

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

data/lib/nmi_gateway/api.rb

@@ -67,6 +67,9 @@ module NMIGateway
       query[:ccexp]                        = options[:ccexp] # FORMAT MMYY
       query[:cvv]                          = options[:cvv] # Recommended
 
+      # Payment Token
+      query[:payment_token]                = options[:payment_token] # from Collect.js
+
       # Payment
       query[:amount]                       = options[:amount]
       query[:currency]                     = options[:currency] || 'USD'
@@ -83,7 +86,7 @@ module NMIGateway
       # Recurring Billing
       query[:recurring]                    = options[:recurring ] # add_subscription
       query[:plan_id]                      = options [:plan_id]
-      query[:plan_name]                      = options [:plan_name]
+      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]

data/lib/nmi_gateway/customer_vault.rb

@@ -2,11 +2,15 @@ module NMIGateway
   class CustomerVault < Api
 
     # NMIGateway::CustomerVault.new.create ccnumber: '4111111111111111', ccexp: "0219", first_name: "John", last_name: "Doe"
+    # NMIGateway::CustomerVault.new.create payment_token: "00000000-000000-000000-000000000000", first_name: "John", last_name: "Doe"
     def create(options = {})
       query = set_query(options)
       query[:customer_vault] = 'add_customer'
-
-      require_fields(:ccnumber, :ccexp)
+      if query[:payment_token]
+        require_fields(:payment_token, :first_name, :last_name)
+      else
+        require_fields(:ccnumber, :ccexp, :first_name, :last_name)
+      end
       post query
     end
 

data/lib/nmi_gateway/response.rb

@@ -1,7 +1,7 @@
 module NMIGateway
   class Response
 
-    attr_accessor  :response, :success, :code, :api_type, :transactions, :customers, :response_text, :response_message, :customer_vault_id, :subscription_id, :plan_id, :plan_amount, :orderid, :transactionid, :authcode, :response_code
+    attr_accessor  :response, :success, :code, :api_type, :transactions, :customers, :response_text, :response_message, :customer_vault_id, :subscription_id, :plan_id, :plan_amount, :orderid, :transactionid, :authcode, :response_code, :avs_response_code, :cvv_response_code, :response_code_message, :avs_response_code_message, :cvv_response_code_message
 
     def initialize(response, api_type)
       @response = response
@@ -39,6 +39,11 @@ module NMIGateway
           @subscription_id = parsed['subscription_id'].first if parsed['subscription_id'].first.present?
           @orderid = parsed['orderid'].first if parsed['orderid'].first.present?
           @transactionid = parsed['transactionid'].first if parsed['transactionid'].first.present?
+          @avs_response_code = parsed['avsresponse'].first if parsed['avsresponse']&.first.present?
+          @cvv_response_code = parsed['cvvresponse'].first if parsed['cvvresponse']&.first.present?
+          @response_code_message = response_codes.dig(response_code) if response_code.present?
+          @avs_response_code_message = avs_response_codes.dig(avs_response_code) if avs_response_code.present?
+          @cvv_response_code_message = cvv_response_codes.dig(cvv_response_code) if cvv_response_code.present?
           parsed
         end
       else

data/lib/nmi_gateway/transaction.rb

@@ -65,7 +65,7 @@ module NMIGateway
       post query
     end
 
-    # NMIGateway::Transaction.new.find transactionid: 3261844010
+    # NMIGateway::Transaction.new.find transaction_id: 3261844010
     def find(options = {})
       query = set_query(options)
       query[:report_type] ||= 'transaction'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: figpay_gateway
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.3
 platform: ruby
 authors:
 - Ben Eggett
@@ -217,6 +217,7 @@ files:
 - ".env.sample"
 - ".github/workflows/ci.yml"
 - ".gitignore"
+- ".ruby-version"
 - ".tool-versions"
 - Gemfile
 - Guardfile