blockchyp 2.3.3 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a82102fd9132353d457d08fdaf7aabd9cb4c6392ddb515925f309c753fd21eef
-  data.tar.gz: '09186f6df35dd8fadfd87b4db9343f76cf4a53285b7dc2aea4b5a219ad27c41a'
+  metadata.gz: 49dc32372aabccb3d15971f69deb80b427934ddc9c810fa5e9132c6856b12b90
+  data.tar.gz: 21ad4be26072a746a7db7494ae60c624f0aab00f17dd6c49e60a3a442578251e
 SHA512:
-  metadata.gz: 5af4709a88f893d915ece0dde84482ee60fa7595f874be3a546da99a721f114e3cb41927906b937c0c241db6f794f254bc28f4ff5933de3cd1577ac4ea518d98
-  data.tar.gz: fb1c3cd21d5af92e2c1c1cb010b20d7521ea0493c1d5e67140e4c4155570c5cf3638ebb08c81a50b024674c36b32354355241bf9d8752518d85ac3faa04a5913
+  metadata.gz: b9871571c1d25f338af7a5419ef5c369ab41428d373fa7fabed9d5e94aafea9e5cefa06350bcc65c20d13bcbedd8ef0fe25682c8f1a58e58b70ec6763ff938a8
+  data.tar.gz: b899f32df715af449cd2a00e8d1c3f0e2d88118259a7d27ccd3708f792da3f04e23dcefd8da27f9a85c6b142e84a2c92a75cdb0e4bd5547cb42374a298499d56

data/README.md

@@ -86,7 +86,7 @@ If you get a positive response, you've successfully verified all of the followin
 
 * The terminal is online.
 * There is a valid route to the terminal.
-* The API Credential are valid.
+* The API Credentials are valid.
 
 
 
@@ -104,7 +104,7 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "terminalName": 'Test Terminal'
+  terminalName: 'Test Terminal'
 }
 
 response = blockchyp.ping(request)
@@ -147,7 +147,7 @@ might be maliciously running on the point-of-sale system.
 * **Cash Back**: To enable cash back for debit transactions, set the `cashBack` flag.  If the card presented isn't a debit card, the `cashBack` flag will be ignored.
 * **Manual Card Entry**: Set the `manual` flag to enable manual card entry.  Good as a backup when chips and MSR's don't work or for more secure phone orders.  You can even combine the `manual` flag with the `ebt` flag for manual EBT card entry.
 * **Inline Tokenization**: You can enroll the payment method in the token vault inline with a charge transaction by setting the `enroll` flag.  You'll get a token back in the response.  You can even bind the token to a customer record if you also pass in customer data.
-* **Prompting for Tips**: Set the `promptForTips` flag if you'd like to prompt the customer for a tip before authorization.  Good for pay-at-the-table and other services related scenarios.
+* **Prompting for Tips**: Set the `promptForTips` flag if you'd like to prompt the customer for a tip before authorization.  Good for pay-at-the-table and other service related scenarios.
 * **Cash Discounting and Surcharging**:  The `surcharge` and `cashDiscount` flags can be used together to support cash discounting or surcharge problems. Consult the Cash Discount documentation for more details.
 
 
@@ -166,9 +166,9 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "test": true,
-  "terminalName": 'Test Terminal',
-  "amount": '55.00'
+  test: true,
+  terminalName: 'Test Terminal',
+  amount: '55.00'
 }
 
 response = blockchyp.charge(request)
@@ -182,8 +182,8 @@ puts "Response: #{response.inspect}"
 
 
 A preauthorization puts a hold on funds and must be captured later.  This is used
-in scenarios where the final transaction amount might change.  Examples would
-be fine dining where a tip adjustment is required prior to capture or hotels
+in scenarios where the final transaction amount might change.  A common examples would
+be fine dining where a tip adjustment is required prior to final settlement.
 
 Another use case for preauthorization is e-commerce.  Typically, an online order
 is preauthorized at the time of the order and then captured when the order ships.
@@ -230,9 +230,9 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "test": true,
-  "terminalName": 'Test Terminal',
-  "amount": '27.00'
+  test: true,
+  terminalName: 'Test Terminal',
+  amount: '27.00'
 }
 
 response = blockchyp.preauth(request)
@@ -270,8 +270,8 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "test": true,
-  "transactionId": '<PREAUTH TRANSACTION ID>'
+  test: true,
+  transactionId: '<PREAUTH TRANSACTION ID>'
 }
 
 response = blockchyp.capture(request)
@@ -293,14 +293,14 @@ returned in a BlockChyp response.  To refund the full amount of the previous tra
 
 **Partial Refunds**
 
-For a partial refund, just passing an amount along with the Transaction ID.
+For a partial refund, just pass in an amount along with the Transaction ID.
 The only rule is that the amount has to be equal to or less than the original
-transaction.  You can even execute multiple partial refunds against the same
-original transaction as long as the total refunded amount doesn't exceed the original transaction.
+transaction.  You can execute multiple partial refunds against the same
+original transaction as long as the total refunded amount doesn't exceed the original amount.
 
 **Tokenized Refunds**
 
-You can also use a token to execute a refund.  Just pass in a token instead
+You can also use a token to execute a refund.  Pass in a token instead
 of the Transaction ID along with the desired refund amount.
 
 **Free Range Refunds**
@@ -308,10 +308,10 @@ of the Transaction ID along with the desired refund amount.
 When you execute a refund without referencing a previous transaction, we
 call this a *free range refund*.
 
-We don't recommend it, but it is permitted.  Just pass in a
-Terminal Name and an amount.
+We don't recommend it, but it is permitted.  If you absolutely insist on
+doing it, pass in a Terminal Name and an amount.
 
-You can even execute a manual or keyed refund by passing the `manual` flag
+You can execute a manual or keyed refund by passing the `manual` flag
 to a free range refund request.
 
 **Gift Card Refunds**
@@ -346,11 +346,10 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "terminalName": 'Test Terminal',
-  "transactionId": '<PREVIOUS TRANSACTION ID>',
+  transactionId: '<PREVIOUS TRANSACTION ID>',
 
   # Optional amount for partial refunds.
-  "amount": '5.00'
+  amount: '5.00'
 }
 
 response = blockchyp.refund(request)
@@ -395,8 +394,8 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "test": true,
-  "terminalName": 'Test Terminal'
+  test: true,
+  terminalName: 'Test Terminal'
 }
 
 response = blockchyp.enroll(request)
@@ -432,8 +431,8 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "test": true,
-  "transactionId": '<PREVIOUS TRANSACTION ID>'
+  test: true,
+  transactionId: '<PREVIOUS TRANSACTION ID>'
 }
 
 response = blockchyp.void(request)
@@ -455,13 +454,13 @@ are retried during shaky network conditions.
 We highly recommend developers use this API whenever a charge, preauth, or refund transaction times out.  If you don't receive a definitive response
 from BlockChyp, you can't be certain about whether or not the transaction went through.
 
-A best practice in this situation is to send a time out reversal request.  Time out reversals check for a transaction and void it if it exists.
+The best practice in this situation is to send a time out reversal request.  Time out reversals check for a transaction and void it if it exists.
 
 The only caveat is that developers must use the `transactionRef` property (`txRef` for the CLI) when executing charge, preauth, and refund transactions.
 
 The reason for this requirement is that if a system never receives a definitive
 response for a transaction, the system would never have received the BlockChyp
-generated Transaction ID.  We have to fallback to transaction ref to identify
+generated Transaction ID.  We have to fallback to Transaction Ref to identify
 a transaction.
 
 
@@ -480,7 +479,7 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "transactionRef": '<LAST TRANSACTION REF>'
+  transactionRef: '<LAST TRANSACTION REF>'
 }
 
 response = blockchyp.reverse(request)
@@ -498,7 +497,7 @@ Just pass in the terminal name and the amount to add to the card.
 Once the customer swipes their card, the terminal will use keys
 on the mag stripe to add value to the card.
 
-You don't need to handle a new gift card or a gift card recharge any
+You don't need to handle a new gift card activation or a gift card recharge any
 differently.  The terminal firmware will figure out what to do on its
 own and also returns the new balance for the gift card.
 
@@ -508,8 +507,7 @@ use gift card numbers.  This means they can't be stolen.
 
 BlockChyp identifies cards with an elliptic curve public key instead.
 Gift card transactions are actually blocks signed with those keys.
-This means there are no shared secrets sent over the network with
-BlockChyp gift cards.
+This means there are no shared secrets sent over the network.
 To keep track of a BlockChyp gift card, hang on to the **public key** returned
 during gift card activation.  That's the gift card's elliptic curve public key.
 
@@ -531,7 +529,7 @@ voiding or reversing a conventional payment transaction.
 BlockChyp does have the ability to import gift card liability from
 conventional gift card platforms.  Unfortunately, BlockChyp does not
 support activating cards on third party systems, but you can import
-your outstanding gift cards and customerSearch can swipe them on the
+your outstanding gift cards and customers can swipe them on the
 terminals just like BlockChyp's standard gift cards.
 
 No special coding is required to access this feature.  The gateway and
@@ -540,8 +538,10 @@ terminal firmware handle everything for you.
 **Third Party Gift Card Networks**
 
 BlockChyp does not currently provide any native support for other gift card
-platforms beyond importing gift card liability.  We do have a white listing system however that be used support your own custom gift card implementations.  We have a security review
-process before we allow a BIN range to be white listed, so contact support@blockchyp.com if you need to white list a BIN range.
+platforms beyond importing gift card liability.  We do have a white listing system
+that can be used to support your own custom gift card implementations.  We have a security review
+process before we allow a BIN range to be white listed, so contact
+support@blockchyp.com if you need to white list a BIN range.
 
 
 
@@ -559,9 +559,9 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "test": true,
-  "terminalName": 'Test Terminal',
-  "amount": '50.00'
+  test: true,
+  terminalName: 'Test Terminal',
+  amount: '50.00'
 }
 
 response = blockchyp.giftActivate(request)
@@ -588,11 +588,11 @@ briefly on the terminal screen and the API response will include the gift card's
 All EBT transactions require a PIN, so in order to check an EBT card balance,
 you need to pass in the `ebt` flag just like you would for a normal EBT
 charge transaction.  The customer will be prompted to swipe their card and
-enter a PIN code.  If everything checks out, the remaining balance on the card will be displayed on terminal for the customer and returned in the API.
+enter a PIN code.  If everything checks out, the remaining balance on the card will be displayed on the terminal for the customer and returned in the API.
 
 **Testing Gift Card Balance Checks**
 
-Test gift card balance checks works no differently than live gift cards.  You
+Test gift card balance checks work no differently than live gift cards.  You
 must activate a test gift card first in order to test balance checks.  Test
 gift cards are real blockchain cards that live on our parallel test blockchain.
 
@@ -617,9 +617,9 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "test": true,
-  "terminalName": 'Test Terminal',
-  "cardType": CardType::EBT
+  test: true,
+  terminalName: 'Test Terminal',
+  cardType: CardType::EBT
 }
 
 response = blockchyp.balance(request)
@@ -632,7 +632,7 @@ puts "Response: #{response.inspect}"
 #### Close Batch
 
 
-This API will close the merchant's batch, if it's currently open.
+This API will close the merchant's batch if it's currently open.
 
 By default, merchant batches will close automatically at 3 AM in their
 local time zone.  The automatic batch closure time can be changed
@@ -656,7 +656,7 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "test": true
+  test: true
 }
 
 response = blockchyp.closeBatch(request)
@@ -679,43 +679,59 @@ more control over the look of the email message, you can omit the `autoSend`
 flag and send the customer email yourself.
 
 There are a lot of optional parameters for this API, but at a minimum
-you'll need to pass in a total, customer name, and email address.
+you'll need to pass in a total, customer name, and email address. (Unless
+you use the `cashier` flag.)
 
 **Customer Info**
 
-You must specify a customer, either by creating a new customer record inline
-or by passing in an existing Customer ID or Customer Ref.
+Unless you're using the `cashier` flag, you must specify a customer, either by
+creating a new customer record inline or by passing in an existing Customer ID or Customer Ref.
 
 **Line Item Level Data**
 
 It's not strictly required, but we strongly recommend sending line item level
-data with every request.  It will make the invoice look a little more complete
+detail with every request.  It will make the invoice look a little more complete
 and the data format for line item level data is the exact same format used
 for terminal line item display, so the same code can be used to support both areas.
 
 **Descriptions**
 
-You can also send a free form description or message that's displayed near
+You can also provide a free form description or message that's displayed near
 the bottom of the invoice.  Usually this is some kind of thank you note
-or instructions.
+or instruction.
 
 **Terms and Conditions**
 
 You can include long form contract language with a request and capture
 terms and conditions acceptance at the same time payment is captured.
 
-The interface is identical to that used for the terminal based terms and
-conditions API in that you can pass in content directly via `tcContent` or via
-a preconfigured template via `tcAlias`.  The terms and conditions log will also be updated when
-terms and conditions acceptance is incorporated into a send link request.
+The interface is identical to that used for the terminal based Terms and
+Conditions API in that you can pass in content directly via `tcContent` or via
+a preconfigured template via `tcAlias`.  The Terms and Conditions log will also be updated when
+agreement acceptance is incorporated into a send link request.
 
 **Auto Send**
 
-By default, BlockChyp does not send the email notification automatically.  This is
-really just a safeguard to prevent real emails from going out when you may not expect it.
+BlockChyp does not send the email notification automatically.  This is
+a safeguard to prevent real emails from going out when you may not expect it.
 If you want BlockChyp to send the email for you, just add the `autoSend` flag with
 all requests.
 
+**Tokenization**
+
+Add the `enroll` flag to a send link request to enroll the payment method
+in the token vault.
+
+**Cashier Facing Card Entry**
+
+BlockChyp can be used to generate internal/cashier facing card entry pages as well.  This is
+designed for situations where you might need to take a phone order and you don't
+have a terminal.
+
+If you pass in the `cashier` flag, no email will be sent and you'll be be able to
+load the link in a browser or iframe for payment entry.  When the `cashier` flag
+is used, the `autoSend` flag will be ignored.
+
 **Payment Notifications**
 
 When a customer successfully submits payment, the merchant will receive an email
@@ -723,7 +739,7 @@ notifying them that the payment was received.
 
 **Real Time Callback Notifications**
 
-Email notifications are fine, but you may also want your system to be informed
+Email notifications are fine, but you may want your system to be informed
 immediately whenever a payment event occurs.  By using the optional `callbackUrl` request
 property, you can specify a URL to which the Authorization Response will be posted
 every time the user submits a payment, whether approved or otherwise.
@@ -733,7 +749,7 @@ same format as all BlockChyp charge and preauth transaction responses.
 
 **Status Polling**
 
-If real time callbacks aren't practical or necesary in your environment, you can
+If real time callbacks aren't practical or necessary in your environment, you can
 always use the Transaction Status API described below.
 
 A common use case for the send link API with status polling is curbside pickup.
@@ -757,29 +773,29 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "amount": '199.99',
-  "description": 'Widget',
-  "subject": 'Widget invoice',
-  "transaction": {
-    "subtotal": '195.00',
-    "tax": '4.99',
-    "total": '199.99',
-    "items": [
+  amount: '199.99',
+  description: 'Widget',
+  subject: 'Widget invoice',
+  transaction: {
+    subtotal: '195.00',
+    tax: '4.99',
+    total: '199.99',
+    items: [
       {
-        "description": 'Widget',
-        "price": '195.00',
-        "quantity": 1
+        description: 'Widget',
+        price: '195.00',
+        quantity: 1
       }
     ]
   },
-  "autoSend": true,
-  "customer": {
-    "customerRef": 'Customer reference string',
-    "firstName": 'FirstName',
-    "lastName": 'LastName',
-    "companyName": 'Company Name',
-    "emailAddress": 'support@blockchyp.com',
-    "smsNumber": '(123) 123-1231'
+  autoSend: true,
+  customer: {
+    customerRef: 'Customer reference string',
+    firstName: 'FirstName',
+    lastName: 'LastName',
+    companyName: 'Company Name',
+    emailAddress: 'support@blockchyp.com',
+    smsNumber: '(123) 123-1231'
   }
 }
 
@@ -817,7 +833,7 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "transactionId": 'ID of transaction to retrieve'
+  transactionId: 'ID of transaction to retrieve'
 }
 
 response = blockchyp.transactionStatus(request)
@@ -851,8 +867,8 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "test": true,
-  "terminalName": 'Test Terminal'
+  test: true,
+  terminalName: 'Test Terminal'
 }
 
 response = blockchyp.clear(request)
@@ -875,7 +891,7 @@ will also return the timestamp of the last status change in the `since` field.
 
 If the system is running a payment transaction and you wisely passed in a
 Transaction Ref, this API will also return the Transaction Ref of the in progress
-transaction in the response.
+transaction.
 
 
 
@@ -893,7 +909,7 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "terminalName": 'Test Terminal'
+  terminalName: 'Test Terminal'
 }
 
 response = blockchyp.terminalStatus(request)
@@ -908,7 +924,7 @@ puts "Response: #{response.inspect}"
 
 
 This API allows you to prompt a customer to accept a legal agreement on the terminal
-and optionally capture their signature.
+and (usually) capture their signature.
 
 Content for the agreement can be specified in two ways.  You can reference a
 previously configured T&C template or pass in the full agreement text with every request.
@@ -929,12 +945,12 @@ pass in the contract text.  Note that only plain text is supported.
 **Bypassing Signatures**
 
 Signature images are captured by default.  If for some reason this doesn't fit your
-use case and you'd like to capture acceptance without actually capturing a signature image set
+use case and you'd like to capture acceptance without actually capturing a signature image, set
 the `disableSignature` flag in the request.
 
 **Terms & Conditions Log**
 
-Every time a user accepts an agreement on the terminal the signature image (if captured),
+Every time a user accepts an agreement on the terminal, the signature image (if captured),
 will be uploaded to the gateway and added to the log along with the full text of the
 agreement.  This preserves the historical record in the event that standard agreements
 or templates change over time.
@@ -961,27 +977,27 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "test": true,
-  "terminalName": 'Test Terminal',
+  test: true,
+  terminalName: 'Test Terminal',
 
   # Alias for a Terms and Conditions template configured in the BlockChyp
   # dashboard.
-  "tcAlias": 'hippa',
+  tcAlias: 'hippa',
 
   # Name of the contract or document if not using an alias.
-  "tcName": 'HIPPA Disclosure',
+  tcName: 'HIPPA Disclosure',
 
   # Full text of the contract or disclosure if not using an alias.
-  "tcContent": 'Full contract text',
+  tcContent: 'Full contract text',
 
   # File format for the signature image.
-  "sigFormat": SignatureFormat::PNG,
+  sigFormat: SignatureFormat::PNG,
 
   # Width of the signature image in pixels.
-  "sigWidth": 200,
+  sigWidth: 200,
 
   # Whether or not a signature is required. Defaults to true.
-  "sigRequired": true
+  sigRequired: true
 }
 
 response = blockchyp.termsAndConditions(request)
@@ -1030,13 +1046,13 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "terminalName": 'Test Terminal',
+  terminalName: 'Test Terminal',
 
   # File format for the signature image.
-  "sigFormat": SignatureFormat::PNG,
+  sigFormat: SignatureFormat::PNG,
 
   # Width of the signature image in pixels.
-  "sigWidth": 200
+  sigWidth: 200
 }
 
 response = blockchyp.captureSignature(request)
@@ -1086,22 +1102,22 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "test": true,
-  "terminalName": 'Test Terminal',
-  "transaction": {
-    "subtotal": '60.00',
-    "tax": '5.00',
-    "total": '65.00',
-    "items": [
+  test: true,
+  terminalName: 'Test Terminal',
+  transaction: {
+    subtotal: '60.00',
+    tax: '5.00',
+    total: '65.00',
+    items: [
       {
-        "description": 'Leki Trekking Poles',
-        "price": '35.00',
-        "quantity": 2,
-        "extended": '70.00',
-        "discounts": [
+        description: 'Leki Trekking Poles',
+        price: '35.00',
+        quantity: 2,
+        extended: '70.00',
+        discounts: [
           {
-            "description": 'memberDiscount',
-            "amount": '10.00'
+            description: 'memberDiscount',
+            amount: '10.00'
           }
         ]
       }
@@ -1164,22 +1180,22 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "test": true,
-  "terminalName": 'Test Terminal',
-  "transaction": {
-    "subtotal": '60.00',
-    "tax": '5.00',
-    "total": '65.00',
-    "items": [
+  test: true,
+  terminalName: 'Test Terminal',
+  transaction: {
+    subtotal: '60.00',
+    tax: '5.00',
+    total: '65.00',
+    items: [
       {
-        "description": 'Leki Trekking Poles',
-        "price": '35.00',
-        "quantity": 2,
-        "extended": '70.00',
-        "discounts": [
+        description: 'Leki Trekking Poles',
+        price: '35.00',
+        quantity: 2,
+        extended: '70.00',
+        discounts: [
           {
-            "description": 'memberDiscount',
-            "amount": '10.00'
+            description: 'memberDiscount',
+            amount: '10.00'
           }
         ]
       }
@@ -1218,9 +1234,9 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "test": true,
-  "terminalName": 'Test Terminal',
-  "message": 'Thank you for your business.'
+  test: true,
+  terminalName: 'Test Terminal',
+  message: 'Thank you for your business.'
 }
 
 response = blockchyp.message(request)
@@ -1263,11 +1279,11 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "test": true,
-  "terminalName": 'Test Terminal',
-  "prompt": 'Would you like to become a member?',
-  "yesCaption": 'Yes',
-  "noCaption": 'No'
+  test: true,
+  terminalName: 'Test Terminal',
+  prompt: 'Would you like to become a member?',
+  yesCaption: 'Yes',
+  noCaption: 'No'
 }
 
 response = blockchyp.booleanPrompt(request)
@@ -1319,12 +1335,12 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "test": true,
-  "terminalName": 'Test Terminal',
+  test: true,
+  terminalName: 'Test Terminal',
 
   # Type of prompt. Can be 'email', 'phone', 'customer-number', or
   # 'rewards-number'.
-  "promptType": PromptType::EMAIL
+  promptType: PromptType::EMAIL
 }
 
 response = blockchyp.textPrompt(request)
@@ -1341,7 +1357,7 @@ puts "Response: #{response.inspect}"
 Adds or updates a customer record.
 
 If you pass in customer information including `firstName`, `lastName`, `email`,
-`email`, or `sms` without any Customer ID or Customer Ref, a new record will
+or `sms` without any Customer ID or Customer Ref, a new record will
 be created.
 
 If you pass in `customerRef` and `customerId`, the customer record will be updated
@@ -1378,14 +1394,14 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "customer": {
-    "id": 'ID of the customer to update',
-    "customerRef": 'Customer reference string',
-    "firstName": 'FirstName',
-    "lastName": 'LastName',
-    "companyName": 'Company Name',
-    "emailAddress": 'support@blockchyp.com',
-    "smsNumber": '(123) 123-1231'
+  customer: {
+    id: 'ID of the customer to update',
+    customerRef: 'Customer reference string',
+    firstName: 'FirstName',
+    lastName: 'LastName',
+    companyName: 'Company Name',
+    emailAddress: 'support@blockchyp.com',
+    smsNumber: '(123) 123-1231'
   }
 }
 
@@ -1421,7 +1437,7 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "customerId": 'ID of the customer to retrieve'
+  customerId: 'ID of the customer to retrieve'
 }
 
 response = blockchyp.customer(request)
@@ -1456,7 +1472,7 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "query": '(123) 123-1234'
+  query: '(123) 123-1234'
 }
 
 response = blockchyp.customerSearch(request)
@@ -1492,9 +1508,9 @@ blockchyp = BlockChyp::BlockChyp.new(
 
 # Set request parameters
 request = {
-  "amount": '100.00',
-  "cashDiscount": true,
-  "surcharge": true
+  amount: '100.00',
+  cashDiscount: true,
+  surcharge: true
 }
 
 response = blockchyp.cashDiscount(request)
@@ -1502,6 +1518,198 @@ response = blockchyp.cashDiscount(request)
 puts "Response: #{response.inspect}"
 
 
+```
+
+#### Batch History
+
+
+
+This endpoint allows developers to query the gateway for the merchant's batch history.
+The data will be returned in descending order of open date with the most recent
+batch returned first.  The results will include basic information about the batch.
+For more detail about a specific batch, consider using the Batch Details API.
+
+**Limiting Results**
+
+This API will return a maximum of 250 results.  Use the `maxResults` property to
+limit maximum results even further and use the `startIndex` property to
+page through results that span multiple queries.
+
+For example, if you want the ten most recent batches, just pass in a value of
+`10` for `maxResults`.  Also note that `startIndex` is zero based. Use a value of `0` to
+get the first batch in the dataset.
+
+**Filtering By Date Range**
+
+You can also filter results by date.  Use the `startDate` and `endDate`
+properties to return only those batches opened between those dates.
+You can use either `startDate` and `endDate` and you can use date filters
+in conjunction with `maxResults` and `startIndex`
+
+
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# Set request parameters
+request = {
+  maxResults: 250,
+  startIndex: 1
+}
+
+response = blockchyp.batchHistory(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Batch Details
+
+
+
+This endpoint allows developers to pull down details for a specific batch,
+including captured volume, gift card activity, expected deposit, and
+captured volume broken down by terminal.
+
+The only required request parameter is `batchId`.  Batch IDs are returned
+with every transaction response and can also be discovered using the Batch
+History API.
+
+
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# Set request parameters
+request = {
+  batchId: 'BATCHID'
+}
+
+response = blockchyp.batchDetails(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Transaction History
+
+
+
+This endpoint provides a number of different methods to sift through
+transaction history.
+
+By default with no filtering properties, this endpoint will return the 250
+most recent transactions.
+
+**Limiting Results**
+
+This API will return a maximum of 250 results in a single query.  Use the `maxResults` property
+to limit maximum results even further and use the `startIndex` property to
+page through results that span multiple queries.
+
+For example, if you want the ten most recent batches, just pass in a value of
+`10` for `maxResults`.  Also note that `startIndex` is zero based. Use a value of `0` to
+get the first transaction in the dataset.
+
+**Filtering By Date Range**
+
+You can also filter results by date.  Use the `startDate` and `endDate`
+properties to return only transactions run between those dates.
+You can use either `startDate` or `endDate` and you can use date filters
+in conjunction with `maxResults` and `startIndex`
+
+**Filtering By Batch**
+
+To restrict results to a single batch, pass in the `batchId` parameter.
+
+**Filtering By Terminal**
+
+To restrict results to those executed on a single terminal, just
+pass in the terminal name.
+
+**Combining Filters**
+
+None of the above filters are mutually exclusive.  You can combine any of the
+above properties in a single request to restrict transaction results to a
+narrower set of results.
+
+
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# Set request parameters
+request = {
+  maxResults: 10
+}
+
+response = blockchyp.transactionHistory(request)
+
+puts "Response: #{response.inspect}"
+
+
+```
+
+#### Merchant Profile
+
+
+
+Returns detailed metadata about the merchant's configuraton, including
+basic identity information, terminal settings, store and forward settings,
+and bank account information for merchants that support split settlement.
+
+
+
+
+```ruby
+# frozen_string_literal: true
+
+require 'blockchyp'
+
+blockchyp = BlockChyp::BlockChyp.new(
+  ENV['BC_API_KEY'],
+  ENV['BC_BEARER_TOKEN'],
+  ENV['BC_SIGNING_KEY']
+)
+
+# Set request parameters
+request = {
+}
+
+response = blockchyp.merchantProfile(request)
+
+puts "Response: #{response.inspect}"
+
+
 ```
 
 ## Running Integration Tests