Some countries have regulations on the use of cryptographic libraries like the ones embedded in TCLink. It may be unlawful to download TCLink in these countries.

                            TCLink v4.2.0
                        Ruby Implementation
                   copyright (C) TrustCommerce 2010
                     http://www.trustcommerce.com
                     techsupport@trustcommerce.com

                           June 1, 2016

Description

TCLink is a thin client library to allow your e-commerce servers to connect to the TrustCommerce payment gateway easily and consistently. The protocol (which is the same across all platforms and languages) is well-documented in the Web Developer's Guide, so please consult it for any questions you may have about the protocol syntax itself.

License

TCLink for Ruby is released under the GNU LGPL. Please read LICENSE for details.

Requirements

You need to have the OpenSSL development libraries installed. (Note that OS X El Capitan and later do not ship with these libraries.) It is recommended that you use the latest version provided by the vendor for PCI reasons.

Besides the normal Ruby install, you'll need the ruby-devel package, which contains files needed for building Ruby extensions.

Installation

[sudo] gem install tclink

OS X El Capitan and Later

If you have difficulty on OS X El Capitan or later, you may need to

• Install OpenSSL through Homebrew (see https://solitum.net/openssl-os-x-el-capitan-and-brew/)
• Specify the path to Homebrew OpenSSL's headers via --with-cppflags=-I/usr/local/opt/openssl/include
• Specify the path to Homebrew OpenSSL's certificate bundle via SSL_CERT_PATH=/usr/local/etc/openssl/cert.pem

Putting it all together:

SSL_CERT_PATH=/usr/local/etc/openssl/cert.pem gem install tclink -- --with-cppflags=-I/usr/local/opt/openssl/include

Testing

rake test

This script will run a test transaction and print the results.

Usage

The tctest.rb script shows a simple example of running transactions through the TCLink API. For further information, please consult the TC Developer's Guide, located in the doc subdirectory.

NOTE

I forked this from a fork of the original repository whose creator writes:

"I packaged this up as a gem for my own uses. I am not affiliated with Trust Commerce and have not modified any of the C code.

If you have trouble building this, you can download a tarball of the source from Trust Commerce's vault. "

--Phillip Birmingham phillip.birmingham@fidelitylife.com