transact_pro 0.9.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 645ba37a51c3535eeab929d2f895de23781a90fd
+  data.tar.gz: 538bfa9d7043a9c363621cc09e1d0bf229783411
+SHA512:
+  metadata.gz: 942111d185f8a9788f57f5e046561cc09e60930a77d7befd9c71eaa93877632428562197184dd3d5e5817c5ed198727047254a70d3ac2d1e11a465b6e6e2de4d
+  data.tar.gz: b73c4b1102249947015b3f5f10a86a31bc159a49bd1b67f5740997944809913bb3cfb13c2a8013c78712d5c45f0508acf690a24b9041915887f8ed0ed225d567

data/.circleci/config.yml

@@ -0,0 +1,27 @@
+version: 2
+jobs:
+  build:
+    working_directory: ~/transact_pro
+    docker:           
+      #- image: circleci/ruby:2.1.10      
+      - image: circleci/ruby@sha256:e49f95920f6294593e99cd6401556a36a8b47703b5bdac0b094b66ae1cdd6569
+        timezone: "Europe/Riga"
+        environment:
+          USER_IP: "78.23.51.103"
+      
+    steps:
+      - checkout
+      
+      - run: gem install bundler -v 1.16.0 --no-doc      
+
+      - restore_cache:
+         key: transact_pro-v1-{{ checksum "Gemfile.lock" }}
+
+      - run: bundle install --path vendor/bundle
+
+      - save_cache:
+         key: transact_pro-v1-{{ checksum "Gemfile.lock" }}
+         paths:
+           - vendor/bundle      
+
+      - run: bundle exec rspec

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at augusts.bautra@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in transact_pro.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,89 @@
+PATH
+  remote: .
+  specs:
+    transact_pro (0.9.0)
+      rest-client (~> 2.0.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.5.2)
+      public_suffix (>= 2.0.2, < 4.0)
+    coderay (1.1.2)
+    coveralls (0.7.1)
+      multi_json (~> 1.3)
+      rest-client
+      simplecov (>= 0.7)
+      term-ansicolor
+      thor
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.3)
+    docile (1.1.5)
+    domain_name (0.5.20170404)
+      unf (>= 0.0.5, < 1.0.0)
+    hashdiff (0.3.7)
+    http-cookie (1.0.3)
+      domain_name (~> 0.5)
+    json (2.1.0)
+    method_source (0.9.0)
+    mime-types (3.1)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2016.0521)
+    multi_json (1.12.2)
+    netrc (0.11.0)
+    pry (0.11.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    public_suffix (2.0.5)
+    rake (10.5.0)
+    rest-client (2.0.2)
+      http-cookie (>= 1.0.2, < 2.0)
+      mime-types (>= 1.16, < 4.0)
+      netrc (~> 0.8)
+    rspec (3.7.0)
+      rspec-core (~> 3.7.0)
+      rspec-expectations (~> 3.7.0)
+      rspec-mocks (~> 3.7.0)
+    rspec-core (3.7.1)
+      rspec-support (~> 3.7.0)
+    rspec-expectations (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-mocks (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-support (3.7.0)
+    safe_yaml (1.0.4)
+    simplecov (0.15.1)
+      docile (~> 1.1.0)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.2)
+    term-ansicolor (1.6.0)
+      tins (~> 1.0)
+    thor (0.20.0)
+    tins (1.16.3)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.7.4)
+    webmock (3.2.1)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  coveralls (~> 0.7.1)
+  pry (~> 0.11.3)
+  rake (~> 10.0)
+  rspec (~> 3.7)
+  simplecov (~> 0.15.1)
+  transact_pro!
+  webmock
+
+BUNDLED WITH
+   1.16.1

data/LICENSE.txt

@@ -0,0 +1,28 @@
+BSD 3-clause "New" or "Revised" License
+
+Copyright (c) 2017 Creative.gs . All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation and/or
+other materials provided with the distribution.
+
+3. Neither the name of Creative.gs, TransactPro, 1stpayments.new nor the names of its contributors
+may be used to endorse or promote products derived from this software without
+specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY Creative.gs AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,145 @@
+[![Version](https://badge.fury.io/rb/transact_pro.svg)](https://badge.fury.io/rb/transact_pro)
+[![Build](https://circleci.com/gh/CreativeGS/transact_pro/tree/master.svg?style=shield)](https://circleci.com/gh/CreativeGS/transact_pro/tree/master)
+[![Coverage](https://coveralls.io/repos/github/CreativeGS/transact_pro/badge.svg?branch=master)](https://coveralls.io/github/CreativeGS/transact_pro?branch=master)
+
+# TransactPro
+Lightweight Ruby wrapper for communicating with TransactPro 1stpayments.net card payment API.  
+
+### What can this gem do?
+Currently core functionality is supported - single and recurring SMS payments with card details entered gateway-side (zero hassle with [PCI compliance](https://www.pcisecuritystandards.org)), and payment outcome check request.     
+As of v1.0.0 (2018-01-04) the full functionality status list is:
+
+| Functionality  | method name | Page in doc  | Support in gem  | response data  |
+|---|---|---|---|---|
+| SMS transaction init, card details entered merchant-side | *init | 12 | ✗ | - |
+| SMS transaction init, card details entered gateway-side | *init | 21 | ✓ | `tid` & `redirect link` |
+| SMS transaction init with card data save flag, card details entered gateway-side | *init_recurring_registration | 42 | ✓ | - |
+| DMS init, card details entered merchant-side | make_hold | 37 | ✗ | - |
+| DMS init, card details entered gateway-side | init_dms | 37 | ✗ | - |
+| DMS execute | charge_hold | 37 | ✗ | - |
+| Save card details for subsequent recurring payments, details entered gateway-side | init_store_card_sms | 45 | ✗ | - |
+| Recurrent SMS, init a recurring payment | init_recurrent | 46 | ✓ | `tid` |
+| Recurrent SMS, execute a recurring payment | charge_recurrent | 48 | ✓ | Status:Success... |
+| Credit transaction init | init_credit | 17 | ✗ | - |
+| Credit transaction execute | do_credit | 17 | ✗ | - |
+| P2P transaction init | init_p2p | 18 | ✗ | - |
+| P2P transaction execute | do_p2p | 18 | ✗ | - |
+| MOTO transaction init | **moto_init | 48 | ✗ | - |
+| MOTO payment execute | **moto_charge | 48 | ✗ | - |
+| Payment cancellation | cancel_request | 23  | ✗ | - |
+| DMS cancellation | cancel_dms | 38 | ✗ | - |
+| Payment execution (charge) | charge | 24 | ✗ | - |
+| Payment status request | status_request | 31 | ✓ | Status:Success... |
+| Payment refund | ***refund | 34 | ✗ | "Refund Success" |
+| Card verification | verify_card | 39 | ✗ | - |
+| Terminal Limits | get_terminal_limits | 41 | ✗ | - |
+| Reconciled Transactions | rt_api | 43 | ✗ | - |
+
+*init request is the same for both card data entry strategies, since the receiving Merchant __Account__ determines what sort of response to give.     
+**moto methods are recurring payments performed on card data saved in a special manner. They use `init` and `charge` endpoints with tweaked parameters.  
+***refunding can be done via the panel in merchantarea.  
+
+## Installation
+Bundle or manually install the latest version of the gem:
+
+```ruby
+gem 'transact_pro'
+```
+
+## Usage
+The gem implements `gateway`, `request` and `response` objects that handle communication with the remote API for you.  
+All communication is done synchroniously and without failsafes, so if something goes wrong during the remote request (HTTP timeout etc.), you get the raw error and get to handle it.  
+
+Please note that in this gem all configuration option hash keys are constant-case symbols like `:GUID` whereas all parameter keys for requests to the API are snake-case symbols like `:merchant_transaction_id`.
+
+### 1. `TransactPro::Gateway`
+
+![TransactPro account structure](assets/account_structure.png)
+
+The gateway object encapsulates a _Merchant_ with GUID and a password, and at least one _Account_ with a routing string.  
+
+To this end, initialize gateway instances like so:
+
+```rb
+options = {
+  TEST: false, # defaults to false, pass `true` if you want the gem to make requests to the sandbox endpoints 
+  API_URI: "https://something.new" # gem has the endpoint uri in defaults, you may only need this if the domains used suddeny change
+  GUID: "CAZY-7319-WI00-0C40", # mandatory
+  PASSWORD: "g44B/pAENO2E", # mandatory
+  ACCOUNT_3D: "CS01", # default routing string of Account to be used for 3D transactions
+  ACCOUNT_NON3D: "CS02", # default routing string of Account to be used for non-3D transactions
+  ACCOUNT_RECURRING: "CS03", # default routing string of Account to be used for recurring payment execution
+  custom_return_url: "https://www.example.com/pay/transactpro/response?merchant_transaction_id=ZZZZZZZ" # can be overridden in transaction init request
+  custom_callback_url: "https://www.example.com/pay/transactpro/response?merchant_transaction_id=ZZZZZZZ" # can be overridden in transaction init request
+}
+
+gateway = TransactPro::Gateway.new(options)
+```
+
+### 2. `TransactPro::Request`
+
+Use the `Gateway` instance's `#request` method to perform requests.  
+
+```rb
+options = {
+  method: :status_request, # mandatory, exclusively symbol objects for value
+  request_type: 'transaction_status',
+  init_transaction_id: "abc123",
+  # Note that passing :guid and :pwd is possible and `#call` will always override any defaults with the latest passed values, but generally you should rely on these values being set correctly from GUID and PASSWORD in gateway configuration. 
+  guid: "..."
+  pwd: "..."
+  # Note that :rs is optional and will be inferred from gateway defaults, preferring 3D accounts to NON3D, where applicable.
+  rs: "..."
+}
+
+request_instance = gateway.request(options)
+request_instance.call #=> response
+
+# TransactPro::Request instances also have #to_s method to inspect what parameters are used in the request.
+```
+
+### 3. `TransactPro::Response`
+`Response` objects are thin wrappers around the response bodies received from communicating with the TransactPro API.  
+Use `#to_s` on them to get the raw body and do any handling yourslef.   
+The gem provides a couple methods for ease of use:
+
+```rb
+response = request_instance.call
+
+response.redirect_link #=> "https://..." link to redirect users to for checkout, nil if not applicable
+
+response.status #=> "OK" if all went well, "FAIL" if a payment status response and it did not go through, "ERROR" if API said request was bad
+
+response.tid #=> the 40-symbol long hexdigit transaction ID, nil if not applicable
+
+response.to_s #=> raw body
+
+response.to_h #=> splits the response on "~" and then on first ":" to make key-value pairs, string keys!
+```
+
+## Contributing
+Bug reports and pull requests are welcome on GitHub at https://github.com/CreativeGS/transact_pro. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+The project uses TDD approach to software development, follow these steps to set up:
+1. fork and clone the repo on github
+2. Install appropriate Ruby and Bundler
+3. `bundle`
+4. See if all specs are green with `rspec`
+5. (optional) Run specs with `USE_LIVE_SANDBOX=true rspec` to disable mocking of remote requests and make live requests to sandbox instead.  
+5. TDD new features
+6. Make a Pull Request in github
+
+## Releasing a new version
+
+```
+gem push # to set credentials
+rake release
+```
+
+## License
+
+The gem is available as open source under the terms of the [BSD-3-Clause License](https://opensource.org/licenses/BSD-3-Clause).
+
+## Code of Conduct
+
+Everyone interacting in the TransactPro project’s codebases and issue trackers is expected to follow the [code of conduct](https://github.com/CreativeGS/transact_pro/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "transact_pro"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/transact_pro.rb

@@ -0,0 +1,26 @@
+require "digest"
+require "rest-client"
+
+require "transact_pro/request_specs"
+require "transact_pro/gateway"
+require "transact_pro/request"
+require "transact_pro/response"
+require "transact_pro/version"
+
+module TransactPro
+  extend self
+
+  DEFAULTS = {
+    TEST: false,
+    PRODUCTION_ENV: {
+      API_URI: "https://www2.1stpayments.net/gwprocessor2.php"
+    },
+    TEST_ENV: {
+      API_URI: "https://gw2sandbox.tpro.lv:8443/gw2test/gwprocessor2.php"
+    }
+  }.freeze
+
+  def root
+    @@root ||= Pathname.new(Gem::Specification.find_by_name("transact_pro").gem_dir)
+  end
+end

data/lib/transact_pro/gateway.rb

@@ -0,0 +1,34 @@
+class TransactPro::Gateway
+  attr_reader :options
+
+  def initialize(options)
+    test = TransactPro::DEFAULTS[:TEST] || !!options[:TEST]
+
+    env_key = (test ? :TEST_ENV : :PRODUCTION_ENV)
+
+    @options = {
+      TEST: test,
+      API_URI: TransactPro::DEFAULTS[env_key][:API_URI],
+      pwd: Digest::SHA1.hexdigest(options[:PASSWORD].to_s),
+      guid: options[:GUID].to_s
+    }
+
+    @options.merge!(options)
+
+    unless @options[:GUID].to_s[%r'\A(?:\w){4}-(?:\w){4}-(?:\w){4}-(?:\w){4}\z']
+      raise ArgumentError.new("'#{@options[:GUID]}' is not a valid GUID for a gateway")
+    end
+
+    unless @options[:PASSWORD].to_s.size > 0
+      raise ArgumentError.new("'#{@options[:PASSWORD]}' is not a valid PASSWORD for a gateway")
+    end
+
+    if @options[:ACCOUNT_3D].to_s.size < 1 && @options[:ACCOUNT_NON3D].to_s.size < 1
+      raise ArgumentError.new("As a minimum specify a ACCOUNT_3D or a ACCOUNT_NON3D for a gateway")
+    end
+  end
+
+  def request(request_options)
+    TransactPro::Request.new(options.merge(request_options))
+  end
+end

data/lib/transact_pro/request.rb

@@ -0,0 +1,97 @@
+class TransactPro::Request
+  class ValidationError < RuntimeError
+  end
+
+  SUPPORTED_METHODS = %i|
+    init init_recurring_registration init_recurrent charge_recurrent
+    status_request
+  |.freeze
+
+  RECURRING_METHODS = %i|init_recurrent charge_recurrent|.freeze
+
+  attr_reader :options, :method
+
+  # Do not use this default initializer!
+  # Instead, initialize a Gateway and call #request method on that.
+  def initialize(options)
+    @options = options
+    @method = @options[:method]
+
+    unless SUPPORTED_METHODS.include?(@method)
+      raise ArgumentError.new(
+        "'#{@method}' is not a supported API request method"
+      )
+    end
+  end
+
+  def call
+    @defaults ||= TransactPro::RequestSpecs.const_get(
+      "#{method.to_s.upcase}_DEFAULTS"
+    )
+
+    @request_options ||= @defaults.merge(options)
+    @request_options[:rs] = routing_string
+
+    @spec ||= TransactPro::RequestSpecs.const_get(
+      "#{method.to_s.upcase}_SPEC"
+    )
+
+    @postable_params = {}
+    @spec.each do |k, spec|
+      do_validation =
+        if spec[:mandatory]
+          # mandatory key, always validate
+          @postable_params[k] = @request_options[k]
+          true
+        else
+          # non-mandatory key, include and validate only if it is present
+          if @request_options[k].to_s.size > 0
+            @postable_params[k] = @request_options[k]
+            true
+          else
+            false
+          end
+        end
+
+      validate(k, @postable_params[k], spec[:format]) if do_validation
+    end
+
+    @url = "#{@request_options[:API_URI]}?a=#{sendable_method}"
+
+    @raw_response = RestClient.post(@url, @postable_params)
+    @response = TransactPro::Response.new(@raw_response.to_s)
+  end
+
+  private
+    def validate(key, string, regex)
+      unless string[regex]
+        raise TransactPro::Request::ValidationError.new(
+          ":#{key} with value '#{string}' is invalid for request, "\
+          "expected a match for regex #{regex.inspect}"
+        )
+      end
+    end
+
+    def routing_string
+      @routing_string =
+        if options[:rs].to_s.size > 0
+          options[:rs]
+        elsif recurring_method?
+          options[:ACCOUNT_RECURRING]
+        else
+          # a regular user-facing method, preferring 3D account
+          options[:ACCOUNT_3D].to_s.size > 0 ?
+            options[:ACCOUNT_3D] :
+            options[:ACCOUNT_NON3D]
+        end
+    end
+
+    def recurring_method?
+      RECURRING_METHODS.include?(method)
+    end
+
+    def sendable_method
+      method == :init_recurring_registration ? :init : method
+    end
+
+end

data/lib/transact_pro/request_specs.rb

@@ -0,0 +1,169 @@
+module TransactPro
+  module RequestSpecs
+    # Contants ending with _SPEC here describe the request body fields
+    # (whether the field is mandatory and supposed format)
+
+    # set of allowed characters:
+	  # a: alphabetic characters are the upper case letters A through Z; the lower case letters a through z, and the blank (space) character.
+    #	h: hexadecimal number.
+	  # n: numeric characters are the numbers zero (0) through nine (9).
+	  # s: special printable characters are any printable characters that are neither alphabetic nor numeric,
+    #    have an ASCII hexadecimal value greater than 20, or an EBCDIC hexadecimal value greater than 40.
+    #    Occurrences of values ASCII 00 – 1F and EBCDIC 00 – 3F are not valid. Not all special characters are
+    #    usually enabled. See fields’ description for details."
+    # u: Unicode alphabetic characters.
+
+    GUID_REGEX = %r'\A[[:alnum:]]{4}-[[:alnum:]]{4}-[[:alnum:]]{4}-[[:alnum:]]{4}\z'
+    PASSWORD_DIGEST_REGEX = %r'\A.{40}\z'
+    ROUTING_REGEX = %r'\A[[:alnum:]]{1,12}\z' # an(1..12)
+    MERCHANT_TRANSACTION_ID = %r'\A.{5,50}\z' # ans(5..50)
+    TID_REGEX = %r'\A[0-9a-f]+\z'i # h(40)
+    USER_IP = %r'\A
+      (
+        ([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.
+      ){3}
+      ([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])
+    \z'x # ns(7..15)
+    DESCRIPTION = %r'\A.{5,255}\z' # uns(5..255)
+    AMOUNT = %r'\A[1-9]\d{2,}\z' # n
+    CURRENCY = %r'\A[[:upper:]]{3}\z' # a(3)
+    NAME_ON_CARD = %r'\A.{2,100}\z' # ans(2..100)
+    STREET = %r'\A.{2,50}\z' # ans(2..50)
+    ZIP = %r'\A.{2,15}\z' # ans(2..15)
+    CITY = %r'\A.{2,25}\z' # ans(2..25)
+    COUNTRY = %r'\A[[:alpha:]]{2}\z' # a(2)
+    STATE = %r'\A.{2,20}\z' # ans(2..20)
+    EMAIL = %r'\A.{1,100}\z' # ans(1..100)
+    PHONE = %r'\A[0-9\-_]{5,25}\z' # ns(5..25)
+    CARD_BIN = %r'\A\d{6}\z' # n(6)
+    BIN_NAME = %r'\A.{3,50}\z' # uns(3..50)
+    BIN_PHONE = %r'\A[0-9\-_]{3,25}\z' # ns(3..25)
+    MERCHANT_SITE_URL = %r'\A.{1,255}\z' # ans(1..255)
+    MERCHANT_REFERRING_NAME = %r'\A.{1,21}\z' # ans(1..21)
+    F_EXTENDED = %r'\A\d+\z' # n
+
+    # 10. Table
+    # Field Format Description
+    # guid ans(19) Your merchant GUID.
+    # pwd h(40) SHA1 hash of your processing password.
+    # rs an(1..12) Your routing string.
+    # merchant_transaction_id ans(5..50) Your transaction ID, must be unique for every transaction you submit to
+    # the gateway. The transaction ID must be from 5 to 50 characters.
+    # user_ip ns(7..15) Cardholder's IP, as string (AA.BB.CC.DD).
+    # description uns(5..255) Order items description, from 5 to 255 characters (Example: SDHC
+    # Memory card x 2, AAA battery pack x 1).
+    # amount n Transaction amount, in MINOR units (i.e. 2150 for $21.50 transaction).
+    # Notice: check JPY exception notice below!
+    # currency a(3) Transaction currency, ISO 4217 3-character code, USD, EUR, CHF etc.
+    # name_on_card ans(2..100) Cardholder name, as printed on a card (pass client name if card data
+    # collected at gateway side)
+    # street ans(2..50) Cardholder address – street. (min 2 symbols)
+    # zip ans(2..15) Cardholder address – ZIP. (min 2 symbols)
+    # city as(2..25) Cardholder address – City. (min 2 symbols)
+    # country a(2) Cardholder address – country, 2-letter ISO 3166-1-Alpha 2 code.
+    # state ans(2..20) Cardholder address – state (send NA if you don't have state information).
+    # email ans(1..100) Cardholder address – email
+    # phone ns(5..25) Cardholder phone number (min. 5 symbols).
+    # card_bin n(6) Cardholder card BIN (first 6 characters of CC number). - not required if
+    # card data collected at gateway side.
+    # bin_name uns(3..50) Cardholder bank name (non-mandatory).
+    # bin_phone ns(3..25) Cardholder bank phone given on a back side of used card
+    # (non-mandatory).
+    # merchant_site_url ans(1..255) Purchase site URL.
+    # merchant_referring_name ans(1..21) Must not be send by default. See chapter 3.5 for description if you need
+    # to use it.
+    INIT_SPEC = {
+      guid: {mandatory: true, format: GUID_REGEX},
+      pwd: {mandatory: true, format: PASSWORD_DIGEST_REGEX},
+      rs: {mandatory: true, format: ROUTING_REGEX},
+      merchant_transaction_id: {mandatory: true, format: MERCHANT_TRANSACTION_ID},
+      user_ip: {mandatory: true, format: USER_IP},
+      description: {mandatory: true, format: DESCRIPTION},
+      amount: {mandatory: true, format: AMOUNT},
+      currency: {mandatory: true, format: CURRENCY},
+      name_on_card: {mandatory: true, format: NAME_ON_CARD},
+      street: {mandatory: true, format: STREET},
+      zip: {mandatory: true, format: ZIP},
+      city: {mandatory: true, format: CITY},
+      country: {mandatory: true, format: COUNTRY},
+      state: {mandatory: true, format: STATE},
+      email: {mandatory: true, format: EMAIL},
+      phone: {mandatory: true, format: PHONE},
+      card_bin: {mandatory: false, format: CARD_BIN},
+      bin_name: {mandatory: false, format: BIN_NAME},
+      bin_phone: {mandatory: false, format: BIN_PHONE},
+      merchant_site_url: {mandatory: true, format: MERCHANT_SITE_URL},
+      merchant_referring_name: {mandatory: false, format: MERCHANT_REFERRING_NAME}
+    }.freeze
+
+    INIT_DEFAULTS = {
+      name_on_card: "John Doe",
+      street: "NA", zip: "NA", city: "NA", country: "NA", state: "NA",
+      email: "john_doe@example.com", phone: "00371000000"
+    }.freeze
+
+    INIT_RECURRING_REGISTRATION_SPEC = INIT_SPEC.
+      dup.merge(save_card: {mandatory: true, format: %r'\d+'}).freeze
+    INIT_RECURRING_REGISTRATION_DEFAULTS = INIT_DEFAULTS.
+      dup.merge(save_card: "1").freeze
+
+    # 32. Table
+    # Field Format Description
+    # guid ans(19) Your merchant GUID
+    # pwd h(40) SHA1 hash of your processing password
+    # rs an(1..12) Routing string
+    # original_init_id h(40) init_transaction_id of your original transaction
+    # merchant_transaction_id ans(5..50) Your transaction ID
+    # amount n Transaction amount, in MINOR units (i.e. 2150 for $21.50 transaction)
+    # description uns(5..255) Order items description
+    INIT_RECURRENT_SPEC = {
+      guid: {mandatory: true, format: GUID_REGEX},
+      pwd: {mandatory: true, format: PASSWORD_DIGEST_REGEX},
+      rs: {mandatory: true, format: ROUTING_REGEX},
+      original_init_id: {mandatory: true, format: TID_REGEX},
+      merchant_transaction_id: {mandatory: true, format: MERCHANT_TRANSACTION_ID},
+      amount: {mandatory: true, format: AMOUNT},
+      description: {mandatory: true, format: DESCRIPTION},
+    }.freeze
+
+    INIT_RECURRENT_DEFAULTS = {
+      # none
+    }.freeze
+
+    # 34. Table
+    # Field Format Description
+    # init_transaction_id h(40) init_transaction_id received for this recurrent transaction
+    # f_extended n Return extended charge details (optional)
+    CHARGE_RECURRENT_SPEC = {
+      guid: {mandatory: true, format: GUID_REGEX},
+      pwd: {mandatory: true, format: PASSWORD_DIGEST_REGEX},
+      init_transaction_id: {mandatory: true, format: TID_REGEX},
+      f_extended: {mandatory: false, format: F_EXTENDED},
+    }.freeze
+
+    CHARGE_RECURRENT_DEFAULTS = {
+      f_extended: "100" # determines the verbosity of responses
+    }.freeze
+
+    # 19. Table
+    # Field Format Value
+    # request_type as 'transaction_status'
+    # init_transaction_id h(40) Gateway Transaction ID
+    # f_extended n Return extended charge details, see section 2.4 of this manual for more details
+    # (optional)
+    # guid ans(19) Your GUID
+    # pwd h(40) SHA1 hash of your processing password
+    STATUS_REQUEST_SPEC = {
+      guid: {mandatory: true, format: GUID_REGEX},
+      pwd: {mandatory: true, format: PASSWORD_DIGEST_REGEX},
+      request_type: {mandatory: true, format: 'transaction_status'},
+      init_transaction_id: {mandatory: true, format: TID_REGEX},
+      f_extended: {mandatory: false, format: F_EXTENDED}
+    }.freeze
+
+    STATUS_REQUEST_DEFAULTS = {
+      request_type: 'transaction_status',
+      f_extended: "100", # determines the verbosity of responses
+    }.freeze
+  end
+end

data/lib/transact_pro/response.rb

@@ -0,0 +1,57 @@
+class TransactPro::Response
+  attr_reader :body
+
+  def initialize(body)
+    @body = body
+  end
+
+  def to_s
+    body
+  end
+
+  def to_h
+    @to_h ||= body.split("~").inject({}) do |mem, portion|
+      match = portion.match(%r'\A([^\:]+?)\:(.*)')
+      mem[match[1]] = match[2]
+      mem
+    end
+  end
+
+  def redirect_link
+    link_portion = body.split("~").detect do |portion|
+      portion[%r'\ARedirectOnsite:']
+    end
+
+    link_portion.nil? ?
+      nil :
+      link_portion.match(%r'\ARedirectOnsite:(https?://.*?tid=[[:alnum:]]+)'i)[1]
+  end
+
+  def status
+    status_portion = body.split("~").detect do |portion|
+      portion[%r'\A(OK)|(Status)\:']
+    end
+
+    if status_portion.nil?
+      "ERROR"
+    elsif status_portion[%r'\AOK']
+      "OK"
+    elsif status_portion[%r'\AStatus']
+      status = status_portion.match(%r'\AStatus:(.*)')[1]
+      status == "Success" ? "OK" : "FAIL"
+    else
+      "ERROR"
+    end
+  end
+
+  def tid
+    tid_portion = body.split("~").detect do |portion|
+      portion[%r'\AOK\:']
+    end
+
+    tid_portion.nil? ?
+      nil :
+      tid_portion.match(%r'\A(.*?)\:(.*)')[2]
+  end
+
+end

data/lib/transact_pro/version.rb

@@ -0,0 +1,3 @@
+module TransactPro
+  VERSION = "0.9.0"
+end

data/transact_pro.gemspec

@@ -0,0 +1,35 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "transact_pro/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "transact_pro"
+  spec.required_ruby_version = '>= 2'
+  spec.date          = "2018-01-04"
+  spec.version       = TransactPro::VERSION
+  spec.authors       = ["Epigene"]
+  spec.email         = ["cto@creative.gs", "augusts.bautra@gmail.com"]
+
+  spec.summary       = "Ruby wrapper for communicating with TransactPro 1stpayments.net card payment API."
+  spec.homepage      = "https://github.com/CreativeGS/transact_pro"
+  spec.license       = "BSD-3-Clause"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "rest-client", "~> 2.0.2"
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.7"
+  spec.add_development_dependency "webmock"#, "~> 3.7"
+  spec.add_development_dependency "pry", "~> 0.11.3"
+  spec.add_development_dependency "simplecov", "~> 0.15.1"
+  spec.add_development_dependency "coveralls", "~> 0.7.1"
+
+end

metadata

@@ -0,0 +1,177 @@
+--- !ruby/object:Gem::Specification
+name: transact_pro
+version: !ruby/object:Gem::Version
+  version: 0.9.0
+platform: ruby
+authors:
+- Epigene
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-01-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.7'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.11.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.11.3
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.15.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.15.1
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+description: 
+email:
+- cto@creative.gs
+- augusts.bautra@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .circleci/config.yml
+- .gitignore
+- .rspec
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- assets/account_structure.png
+- bin/console
+- bin/setup
+- lib/transact_pro.rb
+- lib/transact_pro/gateway.rb
+- lib/transact_pro/request.rb
+- lib/transact_pro/request_specs.rb
+- lib/transact_pro/response.rb
+- lib/transact_pro/version.rb
+- transact_pro.gemspec
+homepage: https://github.com/CreativeGS/transact_pro
+licenses:
+- BSD-3-Clause
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Ruby wrapper for communicating with TransactPro 1stpayments.net card payment
+  API.
+test_files: []