blockchyp 2.2.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 86d27e3160740596687ca591054e375b984d84685874fe628d778d57a2693a16
+  data.tar.gz: b9dfdf70be0b995ae1507194a994050b41831c21c757211373c3d8db1395f3b7
+SHA512:
+  metadata.gz: bd19a88cad2c75ea351fda2e2db1d3b5aeb9b21f8042f690bc5504a8c22a0bb1db3016598eb6171ec1e2e3c5870030603dbc8fc55dd89991946e669728ef5b4d
+  data.tar.gz: e8c99dc0f04805c73378303cf19cad3a6e9419f9eb24034e4604ce30cbba9435b4edefd37050c4c2b882ca874f772c1d78df10228a9abffc378ef3c5d81e9575

data/Makefile

@@ -0,0 +1,71 @@
+# Version config
+TAG := $(shell git tag --points-at HEAD | sort --version-sort | tail -n 1)
+LASTTAG := $(or $(shell git tag -l | sort -r -V | head -n 1),0.1.0)
+SNAPINFO := $(shell date +%Y%m%d%H%M%S)git$(shell git log -1 --pretty=%h)
+RELEASE := $(or $(BUILD_NUMBER), 1)
+VERSION := $(or $(TAG:v%=%),$(LASTTAG:v%=%))-$(or $(BUILD_NUMBER), 1)$(if $(TAG),,.$(SNAPINFO))
+
+# Executables
+DOCKER = docker
+BUNDLE = bundle
+SED = sed
+
+# Integration test config
+export BC_TEST_DELAY := 5
+IMAGE := circleci/ruby
+SCMROOT := $(shell git rev-parse --show-toplevel)
+PWD := $(shell pwd)
+CACHE := $(HOME)/.local/share/blockchyp/itest-cache
+CONFIGFILE := $(HOME)/.config/blockchyp/sdk-itest-config.json
+CACHEPATHS := $(dir $(CONFIGFILE)) $(HOME)/.bundle
+ifeq ($(shell uname -s), Linux)
+HOSTIP = $(shell ip -4 addr show docker0 | grep -Po 'inet \K[\d.]+')
+else
+HOSTIP = host.docker.internal
+endif
+
+# Default target
+.PHONY: all
+all: clean build test
+
+# Clean build artifacts
+.PHONY: clean
+clean:
+	$(RM) ./*.gem
+
+# Build compiles the package
+.PHONY: build
+build:
+	$(BUNDLE) exec rake build
+
+# Runs unit tests
+.PHONY: test
+test:
+
+# Runs integration tests
+.PHONY: integration
+integration:
+	$(if $(LOCALBUILD), \
+		$(BUNDLE) exec rake test $(if $(TEST),TEST=$(TEST),,), \
+		$(foreach path,$(CACHEPATHS),mkdir -p $(CACHE)/$(path) ; ) \
+		sed 's/localhost/$(HOSTIP)/' $(CONFIGFILE) >$(CACHE)/$(CONFIGFILE) ; \
+		$(DOCKER) run \
+		-u $(shell id -u):$(shell id -g) \
+		-v $(SCMROOT):$(SCMROOT):Z \
+		-v /etc/passwd:/etc/passwd:ro \
+		$(foreach path,$(CACHEPATHS),-v $(CACHE)/$(path):$(path):Z) \
+		-e BC_TEST_DELAY=$(BC_TEST_DELAY) \
+		-e HOME=$(HOME) \
+		-w $(PWD) \
+		--rm -it $(IMAGE) \
+		bash -c "$(BUNDLE) install --path $(HOME)/.bundle/vendor && $(BUNDLE) exec rake test $(if $(TEST),TEST=$(TEST),)")
+
+# Performs any tasks necessary before a release build
+.PHONY: stage
+stage:
+	$(SED) -i "s/VERSION = '.*'/VERSION = '$(shell sed 's/-/.pre./' <<<$(VERSION))'/" lib/blockchyp/version.rb
+
+# Publish
+.PHONY: publish
+publish:
+	$(BUNDLE) exec rake publish

data/README.md

@@ -0,0 +1,997 @@
+# BlockChyp Ruby SDK
+
+[![Build Status](https://circleci.com/gh/blockchyp/blockchyp-ruby/tree/master.svg?style=shield)](https://circleci.com/gh/blockchyp/blockchyp-ruby/tree/master)
+[![Gem](https://img.shields.io/gem/v/blockchyp)](https://rubygems.org/gems/blockchyp)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/blockchyp/blockchyp-ruby/blob/master/LICENSE)
+
+This is the SDK for Ruby. Like all BlockChyp SDKs, it provides a full client
+for the BlockChyp gateway and BlockChyp payment terminals.
+
+## Installation
+
+This SDK is best consumed as a Ruby Gem. Type the following command to install
+the BlockChyp Gem in your project.
+
+```
+gem install blockchyp
+```
+
+## A Simple Example
+
+Running your first transaction is easy. Make sure you have a BlockChyp terminal,
+activate it, and generate a set of API keys. The sample code below show how
+to run a basic terminal transaction.
+
+```ruby
+require 'blockchyp'
+
+blockchyp = BlockChyp.new("SPBXTSDAQVFFX5MGQMUMIRINVI", "7BXBTBUPSL3BP7I6Z2CFU6H3WQ", "bcae3708938cb8004ab1278e6c0fcd68f9d815e1c3c86228d028242b147af58e")
+
+# setup request object
+request = Hash.new
+request["test"] = true
+request["terminalName"] = "Test Terminal"
+request["amount"] = "55.00"
+
+response = blockchyp.charge(request)
+
+if (response["approved"])
+  puts "Approved"
+  puts "authCode:" + response["authCode"]
+  puts "authorizedAmount:" + response["authorizedAmount"]
+end
+```
+
+
+
+## The Rest APIs
+
+All BlockChyp SDKs provide a convenient way of accessing the BlockChyp REST APIs.
+You can checkout the REST API documentation via the links below.
+
+[Terminal REST API Docs](https://docs.blockchyp.com/rest-api/terminal/index.html)
+
+[Gateway REST API Docs](https://docs.blockchyp.com/rest-api/gateway/index.html)
+
+## Other SDKs
+
+BlockChyp has officially supported SDKs for eight different development platforms and counting.
+Here's the full list with links to their GitHub repositories.
+
+[Go SDK](https://github.com/blockchyp/blockchyp-go)
+
+[Node.js/JavaScript SDK](https://github.com/blockchyp/blockchyp-js)
+
+[Java SDK](https://github.com/blockchyp/blockchyp-java)
+
+[.net/C# SDK](https://github.com/blockchyp/blockchyp-csharp)
+
+[Ruby SDK](https://github.com/blockchyp/blockchyp-ruby)
+
+[PHP SDK](https://github.com/blockchyp/blockchyp-php)
+
+[Python SDK](https://github.com/blockchyp/blockchyp-python)
+
+[iOS (Objective-C/Swift) SDK](https://github.com/blockchyp/blockchyp-ios)
+
+## Getting a Developer Kit
+
+In order to test your integration with real terminals, you'll need a BlockChyp
+Developer Kit. Our kits include a fully functioning payment terminal with
+test pin encryption keys. Every kit includes a comprehensive set of test
+cards with test cards for every major card brand and entry method, including
+Contactless and Contact EMV and mag stripe cards. Each kit also includes
+test gift cards for our blockchain gift card system.
+
+Access to BlockChyp's developer program is currently invite only, but you
+can request an invitation by contacting our engineering team at **nerds@blockchyp.com**.
+
+You can also view a number of long form demos and learn more about us on our [YouTube Channel](https://www.youtube.com/channel/UCE-iIVlJic_XArs_U65ZcJg).
+
+## Transaction Code Examples
+
+You don't want to read words. You want examples. Here's a quick rundown of the
+stuff you can do with the BlockChyp Ruby SDK and a few basic examples.
+
+#### Charge
+
+Executes a standard direct preauth and capture.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['test'] = true
+request['terminalName'] = 'Test Terminal'
+request['amount'] = '55.00'
+
+response = blockchyp.charge(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Preauthorization
+
+Executes a preauthorization intended to be captured later.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['test'] = true
+request['terminalName'] = 'Test Terminal'
+request['amount'] = '27.00'
+
+response = blockchyp.preauth(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Terminal Ping
+
+Tests connectivity with a payment terminal.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['terminalName'] = 'Test Terminal'
+
+response = blockchyp.ping(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Balance
+
+Checks the remaining balance on a payment method.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['test'] = true
+request['terminalName'] = 'Test Terminal'
+request['cardType'] = CardType::EBT
+
+response = blockchyp.balance(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Terminal Clear
+
+Clears the line item display and any in progress transaction.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['test'] = true
+request['terminalName'] = 'Test Terminal'
+
+response = blockchyp.clear(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Terms & Conditions Capture
+
+Prompts the user to accept terms and conditions.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['test'] = true
+request['terminalName'] = 'Test Terminal'
+request['tcAlias'] = 'hippa'
+request['tcName'] = 'HIPPA Disclosure'
+request['tcContent'] = 'Full contract text'
+request['sigFormat'] = SignatureFormat::PNG
+request['sigWidth'] = 200
+request['sigRequired'] = true
+
+response = blockchyp.termsAndConditions(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Update Transaction Display
+
+Appends items to an existing transaction display.  Subtotal, Tax, and Total are
+overwritten by the request. Items with the same description are combined into
+groups.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['test'] = true
+request['terminalName'] = 'Test Terminal'
+request['transaction'] = new_transaction_display_transaction
+
+response = blockchyp.updateTransactionDisplay(request)
+
+puts "Response: #{response.inspect}"
+def new_transaction_display_transaction
+  val = {}
+  val['subtotal'] = '60.00'
+  val['tax'] = '5.00'
+  val['total'] = '65.00'
+  val['items'] = new_transaction_display_items
+  val
+end
+
+def new_transaction_display_items
+  val = []
+  val = val.push(new_transaction_display_item_2)
+  val
+end
+
+def new_transaction_display_item_2
+  val = {}
+  val['description'] = 'Leki Trekking Poles'
+  val['price'] = '35.00'
+  val['quantity'] = 2
+  val['extended'] = '70.00'
+  val['discounts'] = new_transaction_display_discounts
+  val
+end
+
+def new_transaction_display_discounts
+  val = []
+  val = val.push(new_transaction_display_discount_2)
+  val
+end
+
+def new_transaction_display_discount_2
+  val = {}
+  val['description'] = 'memberDiscount'
+  val['amount'] = '10.00'
+  val
+end
+
+
+
+```
+
+#### New Transaction Display
+
+Displays a new transaction on the terminal.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['test'] = true
+request['terminalName'] = 'Test Terminal'
+request['transaction'] = new_transaction_display_transaction
+
+response = blockchyp.newTransactionDisplay(request)
+
+puts "Response: #{response.inspect}"
+def new_transaction_display_transaction
+  val = {}
+  val['subtotal'] = '60.00'
+  val['tax'] = '5.00'
+  val['total'] = '65.00'
+  val['items'] = new_transaction_display_items
+  val
+end
+
+def new_transaction_display_items
+  val = []
+  val = val.push(new_transaction_display_item_2)
+  val
+end
+
+def new_transaction_display_item_2
+  val = {}
+  val['description'] = 'Leki Trekking Poles'
+  val['price'] = '35.00'
+  val['quantity'] = 2
+  val['extended'] = '70.00'
+  val['discounts'] = new_transaction_display_discounts
+  val
+end
+
+def new_transaction_display_discounts
+  val = []
+  val = val.push(new_transaction_display_discount_2)
+  val
+end
+
+def new_transaction_display_discount_2
+  val = {}
+  val['description'] = 'memberDiscount'
+  val['amount'] = '10.00'
+  val
+end
+
+
+
+```
+
+#### Text Prompt
+
+Asks the consumer a text based question.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['test'] = true
+request['terminalName'] = 'Test Terminal'
+request['promptType'] = PromptType::EMAIL
+
+response = blockchyp.textPrompt(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Boolean Prompt
+
+Asks the consumer a yes/no question.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['test'] = true
+request['terminalName'] = 'Test Terminal'
+request['prompt'] = 'Would you like to become a member?'
+request['yesCaption'] = 'Yes'
+request['noCaption'] = 'No'
+
+response = blockchyp.booleanPrompt(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Display Message
+
+Displays a short message on the terminal.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['test'] = true
+request['terminalName'] = 'Test Terminal'
+request['message'] = 'Thank you for your business.'
+
+response = blockchyp.message(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Refund
+
+Executes a refund.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['terminalName'] = 'Test Terminal'
+request['transactionId'] = '<PREVIOUS TRANSACTION ID>'
+request['amount'] = '5.00'
+
+response = blockchyp.refund(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Enroll
+
+Adds a new payment method to the token vault.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['test'] = true
+request['terminalName'] = 'Test Terminal'
+
+response = blockchyp.enroll(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Gift Card Activation
+
+Activates or recharges a gift card.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['test'] = true
+request['terminalName'] = 'Test Terminal'
+request['amount'] = '50.00'
+
+response = blockchyp.giftActivate(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Time Out Reversal
+
+Executes a manual time out reversal.
+
+We love time out reversals. Don't be afraid to use them whenever a request to a
+BlockChyp terminal times out. You have up to two minutes to reverse any
+transaction. The only caveat is that you must assign transactionRef values when
+you build the original request. Otherwise, we have no real way of knowing which
+transaction you're trying to reverse because we may not have assigned it an id
+yet. And if we did assign it an id, you wouldn't know what it is because your
+request to the terminal timed out before you got a response.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['terminalName'] = 'Test Terminal'
+request['transactionRef'] = '<LAST TRANSACTION REF>'
+
+response = blockchyp.reverse(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Capture Preauthorization
+
+Captures a preauthorization.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['test'] = true
+request['transactionId'] = '<PREAUTH TRANSACTION ID>'
+
+response = blockchyp.capture(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Close Batch
+
+Closes the current credit card batch.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['test'] = true
+
+response = blockchyp.closeBatch(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Void Transaction
+
+Discards a previous preauth transaction.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['test'] = true
+request['transactionId'] = '<PREVIOUS TRANSACTION ID>'
+
+response = blockchyp.void(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Terminal Status
+
+Returns the current status of a terminal.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['terminalName'] = 'Test Terminal'
+
+response = blockchyp.terminalStatus(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Capture Signature.
+
+Captures and returns a signature.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['terminalName'] = 'Test Terminal'
+request['sigFormat'] = SignatureFormat::PNG
+request['sigWidth'] = 200
+
+response = blockchyp.captureSignature(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Update Customer
+
+Updates or creates a customer record.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['customer'] = new_customer
+
+response = blockchyp.updateCustomer(request)
+
+puts "Response: #{response.inspect}"
+def new_customer
+  val = {}
+  val['id'] = 'ID of the customer to update'
+  val['customerRef'] = 'Customer reference string'
+  val['firstName'] = 'FirstName'
+  val['lastName'] = 'LastName'
+  val['companyName'] = 'Company Name'
+  val['emailAddress'] = 'support@blockchyp.com'
+  val['smsNumber'] = '(123) 123-1231'
+  val
+end
+
+
+
+```
+
+#### Retrieve Customer
+
+Retrieves a customer by id.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['customerId'] = 'ID of the customer to retrieve'
+
+response = blockchyp.customer(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Search Customer
+
+Searches the customer database.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['query'] = '(123) 123-1234'
+
+response = blockchyp.customerSearch(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Transaction Status
+
+Retrieves the current status of a transaction.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['transactionId'] = 'ID of transaction to retrieve'
+
+response = blockchyp.transactionStatus(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Send Payment Link
+
+Creates and send a payment link to a customer.
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# setup request object
+request = {}
+request['amount'] = '199.99'
+request['description'] = 'Widget'
+request['subject'] = 'Widget invoice'
+request['transaction'] = new_transaction_display_transaction
+request['autoSend'] = true
+request['customer'] = new_customer
+
+response = blockchyp.sendPaymentLink(request)
+
+puts "Response: #{response.inspect}"
+def new_transaction_display_transaction
+  val = {}
+  val['subtotal'] = '195.00'
+  val['tax'] = '4.99'
+  val['total'] = '199.99'
+  val['items'] = new_transaction_display_items
+  val
+end
+
+def new_transaction_display_items
+  val = []
+  val = val.push(new_transaction_display_item_2)
+  val
+end
+
+def new_transaction_display_item_2
+  val = {}
+  val['description'] = 'Widget'
+  val['price'] = '195.00'
+  val['quantity'] = 1
+  val
+end
+
+def new_customer
+  val = {}
+  val['customerRef'] = 'Customer reference string'
+  val['firstName'] = 'FirstName'
+  val['lastName'] = 'LastName'
+  val['companyName'] = 'Company Name'
+  val['emailAddress'] = 'support@blockchyp.com'
+  val['smsNumber'] = '(123) 123-1231'
+  val
+end
+
+
+
+```
+
+## Running Integration Tests
+
+If you'd like to run the integration tests, create a new file on your system
+called `sdk-itest-config.json` with the API credentials you'll be using as
+shown in the example below.
+
+```
+{
+ "gatewayHost": "https://api.blockchyp.com",
+ "testGatewayHost": "https://test.blockchyp.com",
+ "apiKey": "PZZNEFK7HFULCB3HTLA7HRQDJU",
+ "bearerToken": "QUJCHIKNXOMSPGQ4QLT2UJX5DI",
+ "signingKey": "f88a72d8bc0965f193abc7006bbffa240663c10e4d1dc3ba2f81e0ca10d359f5"
+}
+```
+
+This file can be located in a few different places, but is usually located
+at `<USER_HOME>/.config/blockchyp/sdk-itest-config.json`. All BlockChyp SDKs
+use the same configuration file.
+
+To run the integration test suite via `make`, type the following command:
+
+`make integration`
+
+
+## Running Integration Tests Via Rake or Ruby
+
+If you'd like to bypass make and run the integration test suite directly,
+you can run the entire test suite with Rake using the following command:
+
+`BC_TEST_DELAY=5 rake test`
+
+You can run individual tests by adding executing them as normal Ruby files.
+
+`ruby test/terminal_charge_test.rb`
+
+
+
+
+
+## Contributions
+
+BlockChyp welcomes contributions from the open source community, but bear in mind
+that this repository has been generated by our internal SDK Generator tool. If
+we choose to accept a PR or contribution, your code will be moved into our SDK
+Generator project, which is a private repository.
+
+## License
+
+Copyright BlockChyp, Inc., 2019
+
+Distributed under the terms of the [MIT] license, blockchyp-ruby is free and open source software.
+
+[MIT]: https://github.com/blockchyp/blockchyp-ruby/blob/master/LICENSE