BlockChypClient (com.blockchyp:blockchyp-java 2.3.1 API)

java.lang.Object
- com.blockchyp.client.BlockChypClient

```
public class BlockChypClient
extends Object
```
This is the main class Java developers will interact with. You can instantiate this class directly or use it with a dependency injection framework like Spring or Guice. Most developers will only need to inject credentials, but you may also want to override default endpoints if you're targeting non production BlockChyp systems (which is unlikely). You can inject settings via the constructors or via setters depending on your preferences. You'll also notice that we're not using generics or any features from Java 1.7 or later. This is just to maintain as much backward compatibility as possible with older systems (1.6 or later). The underlying REST API's are invoked using commons-httpclient 3.1 and we use Jackson for JSON serialization. Most internal methods are scoped as protected in order to give developers the ability to override things if they need special behavior or have weird classpath issues.

Field Summary

Fields
Modifier and Type Field and Description

static long MS_PER_HOUR

static String OFFLINE_CACHE

static String OFFLINE_FIXED_KEY

Fields
Modifier and Type	Field and Description
`static long`	`MS_PER_HOUR`
`static String`	`OFFLINE_CACHE`
`static String`	`OFFLINE_FIXED_KEY`

Constructor Summary

Constructors
Constructor and Description
`BlockChypClient()` Default constructor.
`BlockChypClient(APICredentials defaultCredentials)` Provided as a convenience to support constructor based dependency injection.
`BlockChypClient(String gatewayHost)` Provided as a convenience to support constructor based dependency injection.
`BlockChypClient(String gatewayHost, APICredentials defaultCredentials)` Provided as a convenience to support constructor based dependency injection.
`BlockChypClient(String gatewayHost, String testGatewayHost, APICredentials defaultCredentials)` Provided as a convenience to support constructor based dependency injection.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`BalanceResponse`	`balance(BalanceRequest request)` Checks the remaining balance on a payment method.
`BooleanPromptResponse`	`booleanPrompt(BooleanPromptRequest request)` Asks the consumer a yes/no question.
`CaptureResponse`	`capture(CaptureRequest request)` Captures a preauthorization.
`CaptureSignatureResponse`	`captureSignature(CaptureSignatureRequest request)` Captures and returns a signature.
`CashDiscountResponse`	`cashDiscount(CashDiscountRequest request)` Calculates the discount for actual cash transactions.
`AuthorizationResponse`	`charge(AuthorizationRequest request)` Executes a standard direct preauth and capture.
`Acknowledgement`	`clear(ClearTerminalRequest request)` Clears the line item display and any in progress transaction.
`CloseBatchResponse`	`closeBatch(CloseBatchRequest request)` Closes the current credit card batch.
`CustomerResponse`	`customer(CustomerRequest request)` Retrieves a customer by id.
`CustomerSearchResponse`	`customerSearch(CustomerSearchRequest request)` Searches the customer database.
`protected APICredentials`	`decrypt(APICredentials creds)` Decrypts API credentials using the offline cache key.
`protected byte[]`	`deriveOfflineKey()` Generates the encryption key used for offline cache records.
`protected void`	`dumpSignatureFile(Object request, Object response)` Writes the signature to a file if a signature is present and the caller has requested it.
`protected APICredentials`	`encrypt(APICredentials creds)` Encrypts API credentials using the offline cache key.
`EnrollResponse`	`enroll(EnrollRequest request)` Adds a new payment method to the token vault.
`protected Object`	`finishGatewayRequest(org.apache.commons.httpclient.HttpMethod method, Class responseType)` Executes a previously assembled HttpMethod against the gateway.
`protected Object`	`finishTerminalRequest(TerminalRouteResponse route, Object request, org.apache.commons.httpclient.methods.EntityEnclosingMethod method, Class responseType)` This handles all the common logic associated with processing terminal http requests.
`protected Object`	`getGateway(String path, boolean test, Class responseType)` Executes an http get request against the gateway with a timeout override.
`protected Object`	`getGateway(String path, boolean test, Class responseType, int requestTimeout)` Executes an http get request against the gateway with a timeout override.
`protected org.apache.commons.httpclient.HttpClient`	`getGatewayClient()` Returns the gateway client singleton.
`TerminalRouteResponse`	`getOfflineCache(String terminalName)` Returns the route stored in the offline cache for the given terminal.
`String`	`getOfflineRouteCacheLocation()` Returns the offline route cache location.
`protected org.apache.commons.httpclient.HttpClient`	`getTerminalClient()` Returns the terminal client singleton.
`GiftActivateResponse`	`giftActivate(GiftActivateRequest request)` Activates or recharges a gift card.
`HeartbeatResponse`	`heartbeat(boolean test)` Tests communication with the Gateway.
`protected void`	`initObjectMapper()` Initializes the JSON encoder and parser.
`boolean`	`isTerminalHttps()` Gets the terminal https flag.
`protected boolean`	`isTerminalRouted(ITerminalReference terminalName)` Returns true if transaction for the given terminal reference should be routed over the local subnet.
`Acknowledgement`	`message(MessageRequest request)` Displays a short message on the terminal.
`protected TerminalRequest`	`newTerminalRequestForRoute(TerminalRouteResponse route)` Assembles a new terminal request and populates the credentials, using transient credentials if available.
`Acknowledgement`	`newTransactionDisplay(TransactionDisplayRequest request)` Displays a new transaction on the terminal.
`PingResponse`	`ping(PingRequest request)` Tests connectivity with a payment terminal.
`protected Object`	`postGateway(String path, ICoreRequest request, Class responseClass)` Executes a post HTTP request against the gateway.
`protected Object`	`postTerminal(String path, Object request, Class responseType)` Posts an http request to the terminal API.
`AuthorizationResponse`	`preauth(AuthorizationRequest request)` Executes a preauthorization intended to be captured later.
`protected Object`	`putGateway(String path, ICoreRequest request, Class responseClass)` Executes a put HTTP request against the gateway.
`protected Object`	`putTerminal(String path, Object request, Class responseType)` Executes a put http request against the terminal API.
`AuthorizationResponse`	`refund(RefundRequest request)` Executes a refund.
`protected String`	`resolveOfflineRouteCacheLocation(String terminalName)` Returns the offline cache location.
`protected String`	`resolveTerminalHost(TerminalRouteResponse route)` Assembles the scheme, ip address, and port number bits of a terminal URL.
`protected TerminalRouteResponse`	`resolveTerminalRoute(String terminalName)` Finds the terminal route record for the given terminal name.
`AuthorizationResponse`	`reverse(AuthorizationRequest request)` Executes a manual time out reversal.
`protected TerminalRouteResponse`	`routeCacheGet(String terminalName)` Looks up a terminal route from the cache.
`protected void`	`routeCachePut(TerminalRouteResponse route)` Puts a terminal route in the cache (both caches).
`PaymentLinkResponse`	`sendPaymentLink(PaymentLinkRequest request)` Creates and send a payment link to a customer.
`void`	`setDefaultCredentials(APICredentials defaultCredentials)` Sets the default root API credentials for the client.
`void`	`setGatewayHost(String gatewayHost)` Used to override the live gateway host.
`void`	`setOfflineRouteCacheEnabled(boolean offlineRouteCacheEnabled)` Enables or disables offline terminal route caching.
`void`	`setOfflineRouteCacheLocation(String offlineRouteCacheLocation)` Sets the offline route cache location if you want to override the default.
`void`	`setPaymentLogger(PaymentLogger paymentLogger)` Sets the payment logger.
`void`	`setTerminalHttps(boolean terminalHttps)` Sets the terminal https flag.
`void`	`setTestGatewayHost(String testGatewayHost)` Used to override the test gateway host.
`TerminalStatusResponse`	`terminalStatus(TerminalStatusRequest request)` Returns the current status of a terminal.
`TermsAndConditionsResponse`	`termsAndConditions(TermsAndConditionsRequest request)` Prompts the user to accept terms and conditions.
`TextPromptResponse`	`textPrompt(TextPromptRequest request)` Asks the consumer a text based question.
`protected String`	`toFullyQualifiedGatewayPath(String path, boolean test)` Converts path to the fully qualified URL for a gateway API call.
`protected String`	`toFullyQualifiedTerminalPath(TerminalRouteResponse route, String path)` Assembles a full path to the terminal for an API call.
`protected String`	`toTerminalRouteKey(String terminalName)` Creates a cache key for terminal routes.
`AuthorizationResponse`	`transactionStatus(TransactionStatusRequest request)` Retrieves the current status of a transaction.
`CustomerResponse`	`updateCustomer(UpdateCustomerRequest request)` Updates or creates a customer record.
`Acknowledgement`	`updateTransactionDisplay(TransactionDisplayRequest request)` Appends items to an existing transaction display.
`VoidResponse`	`voidTx(VoidRequest request)` Discards a previous preauth transaction.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - OFFLINE_CACHE
```
public static final String OFFLINE_CACHE
```
    See Also:
    
    Constant Field Values
  - OFFLINE_FIXED_KEY
```
public static final String OFFLINE_FIXED_KEY
```
    See Also:
    
    Constant Field Values
  - MS_PER_HOUR
```
public static final long MS_PER_HOUR
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - BlockChypClient
```
public BlockChypClient()
```
    Default constructor.
  - BlockChypClient
```
public BlockChypClient(String gatewayHost)
```
    Provided as a convenience to support constructor based dependency injection.
    
    Parameters:
    
    gatewayHost - alternate gateway endpoint.
  - BlockChypClient
```
public BlockChypClient(APICredentials defaultCredentials)
```
    Provided as a convenience to support constructor based dependency injection.
    
    Parameters:
    
    defaultCredentials - APICredentials
  - BlockChypClient
```
public BlockChypClient(String gatewayHost,
                       APICredentials defaultCredentials)
```
    Provided as a convenience to support constructor based dependency injection.
    
    Parameters:
    
    gatewayHost - alternate gateway endpoint.
    
    defaultCredentials - APICredentials
  - BlockChypClient
```
public BlockChypClient(String gatewayHost,
                       String testGatewayHost,
                       APICredentials defaultCredentials)
```
    Provided as a convenience to support constructor based dependency injection.
    
    Parameters:
    
    gatewayHost - alternate gateway endpoint.
    
    testGatewayHost - alternate gateway endpoint.
    
    defaultCredentials - APICredentials
- Method Detail
  - setGatewayHost
```
public void setGatewayHost(String gatewayHost)
```
    Used to override the live gateway host. Unless you work at BlockChyp, you probably won't ever need to do this.
    
    Parameters:
    
    gatewayHost - alternate gateway endpoint.
  - setTestGatewayHost
```
public void setTestGatewayHost(String testGatewayHost)
```
    Used to override the test gateway host. Unless you work at BlockChyp, you probably won't ever need to do this.
    
    Parameters:
    
    testGatewayHost - alternate gateway endpoint.
  - setDefaultCredentials
```
public void setDefaultCredentials(APICredentials defaultCredentials)
```
    Sets the default root API credentials for the client.
    
    Parameters:
    
    defaultCredentials - APICredentials
  - setOfflineRouteCacheEnabled
```
public void setOfflineRouteCacheEnabled(boolean offlineRouteCacheEnabled)
```
    Enables or disables offline terminal route caching. Offline route caching is really meant as a defense for situations where developers are creating new BlockChypClient instances over and over for each request and therefore making the in memory cache useless. The BlockChypClient is thread safe so we encourage you to only create one instance and share it for all requests. If you're doing this, you can safely disable offline route caching and we recommend it. Defaults to enabled.
    
    Parameters:
    
    offlineRouteCacheEnabled - true if offline route caching is enabled.
  - setPaymentLogger
```
public void setPaymentLogger(PaymentLogger paymentLogger)
```
    Sets the payment logger. Can be used to override that default System.out based logging.
    
    Parameters:
    
    paymentLogger - an implementation of PaymentLogger
  - initObjectMapper
```
protected void initObjectMapper()
```
    Initializes the JSON encoder and parser.
  - heartbeat
```
public HeartbeatResponse heartbeat(boolean test)
                            throws Exception
```
    Tests communication with the Gateway. If authentication is successful, a merchantPk value is returned.
    
    Parameters:
    
    test - whether or not to route the the transaction to the test gateway.
    
    Returns:
    
    Acknowledgement
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - reverse
```
public AuthorizationResponse reverse(AuthorizationRequest request)
                              throws Exception
```
    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.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    AuthorizationResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - capture
```
public CaptureResponse capture(CaptureRequest request)
                        throws Exception
```
    Captures a preauthorization.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    CaptureResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - closeBatch
```
public CloseBatchResponse closeBatch(CloseBatchRequest request)
                              throws Exception
```
    Closes the current credit card batch.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    CloseBatchResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - voidTx
```
public VoidResponse voidTx(VoidRequest request)
                    throws Exception
```
    Discards a previous preauth transaction.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    VoidResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - updateCustomer
```
public CustomerResponse updateCustomer(UpdateCustomerRequest request)
                                throws Exception
```
    Updates or creates a customer record.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    CustomerResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - customer
```
public CustomerResponse customer(CustomerRequest request)
                          throws Exception
```
    Retrieves a customer by id.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    CustomerResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - customerSearch
```
public CustomerSearchResponse customerSearch(CustomerSearchRequest request)
                                      throws Exception
```
    Searches the customer database.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    CustomerSearchResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - cashDiscount
```
public CashDiscountResponse cashDiscount(CashDiscountRequest request)
                                  throws Exception
```
    Calculates the discount for actual cash transactions.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    CashDiscountResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - transactionStatus
```
public AuthorizationResponse transactionStatus(TransactionStatusRequest request)
                                        throws Exception
```
    Retrieves the current status of a transaction.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    AuthorizationResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - sendPaymentLink
```
public PaymentLinkResponse sendPaymentLink(PaymentLinkRequest request)
                                    throws Exception
```
    Creates and send a payment link to a customer.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    PaymentLinkResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - charge
```
public AuthorizationResponse charge(AuthorizationRequest request)
                             throws Exception
```
    Executes a standard direct preauth and capture.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    AuthorizationResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - preauth
```
public AuthorizationResponse preauth(AuthorizationRequest request)
                              throws Exception
```
    Executes a preauthorization intended to be captured later.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    AuthorizationResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - ping
```
public PingResponse ping(PingRequest request)
                  throws Exception
```
    Tests connectivity with a payment terminal.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    PingResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - balance
```
public BalanceResponse balance(BalanceRequest request)
                        throws Exception
```
    Checks the remaining balance on a payment method.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    BalanceResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - clear
```
public Acknowledgement clear(ClearTerminalRequest request)
                      throws Exception
```
    Clears the line item display and any in progress transaction.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    Acknowledgement
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - termsAndConditions
```
public TermsAndConditionsResponse termsAndConditions(TermsAndConditionsRequest request)
                                              throws Exception
```
    Prompts the user to accept terms and conditions.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    TermsAndConditionsResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - updateTransactionDisplay
```
public Acknowledgement updateTransactionDisplay(TransactionDisplayRequest request)
                                         throws Exception
```
    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.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    Acknowledgement
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - newTransactionDisplay
```
public Acknowledgement newTransactionDisplay(TransactionDisplayRequest request)
                                      throws Exception
```
    Displays a new transaction on the terminal.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    Acknowledgement
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - textPrompt
```
public TextPromptResponse textPrompt(TextPromptRequest request)
                              throws Exception
```
    Asks the consumer a text based question.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    TextPromptResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - booleanPrompt
```
public BooleanPromptResponse booleanPrompt(BooleanPromptRequest request)
                                    throws Exception
```
    Asks the consumer a yes/no question.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    BooleanPromptResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - message
```
public Acknowledgement message(MessageRequest request)
                        throws Exception
```
    Displays a short message on the terminal.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    Acknowledgement
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - refund
```
public AuthorizationResponse refund(RefundRequest request)
                             throws Exception
```
    Executes a refund.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    AuthorizationResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - enroll
```
public EnrollResponse enroll(EnrollRequest request)
                      throws Exception
```
    Adds a new payment method to the token vault.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    EnrollResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - giftActivate
```
public GiftActivateResponse giftActivate(GiftActivateRequest request)
                                  throws Exception
```
    Activates or recharges a gift card.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    GiftActivateResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - terminalStatus
```
public TerminalStatusResponse terminalStatus(TerminalStatusRequest request)
                                      throws Exception
```
    Returns the current status of a terminal.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    TerminalStatusResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - captureSignature
```
public CaptureSignatureResponse captureSignature(CaptureSignatureRequest request)
                                          throws Exception
```
    Captures and returns a signature.
    
    Parameters:
    
    request - the request parameters.
    
    Returns:
    
    CaptureSignatureResponse
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - decrypt
```
protected APICredentials decrypt(APICredentials creds)
```
    Decrypts API credentials using the offline cache key.
    
    Parameters:
    
    creds - blockchyp API credentials.
    
    Returns:
    
    a decrypted copy of the original credentials.
  - encrypt
```
protected APICredentials encrypt(APICredentials creds)
```
    Encrypts API credentials using the offline cache key.
    
    Parameters:
    
    creds - blockchyp API credentials.
    
    Returns:
    
    an encrypted copy of the original credentials.
  - deriveOfflineKey
```
protected byte[] deriveOfflineKey()
```
    Generates the encryption key used for offline cache records.
    
    Returns:
    
    the key in bytes.
  - routeCacheGet
```
protected TerminalRouteResponse routeCacheGet(String terminalName)
```
    Looks up a terminal route from the cache.
    
    Parameters:
    
    terminalName - terminal name assigned at activation.
    
    Returns:
    
    the terminal route record.
  - routeCachePut
```
protected void routeCachePut(TerminalRouteResponse route)
```
    Puts a terminal route in the cache (both caches).
    
    Parameters:
    
    route - the terminal route record.
  - toTerminalRouteKey
```
protected String toTerminalRouteKey(String terminalName)
```
    Creates a cache key for terminal routes.
    
    Parameters:
    
    terminalName - terminal name.
    
    Returns:
    
    terminal cache key.
  - dumpSignatureFile
```
protected void dumpSignatureFile(Object request,
                                 Object response)
```
    Writes the signature to a file if a signature is present and the caller has requested it. Notice this does not throw exceptions in order to prevent the calling application from losing track of the authorization.
    
    Parameters:
    
    request - ISignatureRequest
    
    response - ISignatureResponse
  - resolveTerminalRoute
```
protected TerminalRouteResponse resolveTerminalRoute(String terminalName)
```
    Finds the terminal route record for the given terminal name. First the local in memory cache is checked, then the offline cache (if enabled). If the first two cache lookups come up empty or the cache is over an hour old, the gateway route API is invoked. If we have a stale cache entry and the gateway route lookup fails or times out, we fall back to the stale cache entry.
    
    Parameters:
    
    terminalName - name of the terminal assigned at activation.
    
    Returns:
    
    the terminal route record.
  - getGatewayClient
```
protected org.apache.commons.httpclient.HttpClient getGatewayClient()
```
    Returns the gateway client singleton.
    
    Returns:
    
    HttpClient configured for gateway requests.
  - getTerminalClient
```
protected org.apache.commons.httpclient.HttpClient getTerminalClient()
```
    Returns the terminal client singleton.
    
    Returns:
    
    HttpClient configured for terminal requests.
  - resolveTerminalHost
```
protected String resolveTerminalHost(TerminalRouteResponse route)
```
    Assembles the scheme, ip address, and port number bits of a terminal URL.
    
    Parameters:
    
    route - the terminal route record.
    
    Returns:
    
    scheme, ip addres, and port number.
  - toFullyQualifiedTerminalPath
```
protected String toFullyQualifiedTerminalPath(TerminalRouteResponse route,
                                              String path)
```
    Assembles a full path to the terminal for an API call.
    
    Parameters:
    
    route - the terminal route record.
    
    path - API path relative to the root (e.g. "/api/charge")
    
    Returns:
    
    the fully qualified URI.
  - isTerminalRouted
```
protected boolean isTerminalRouted(ITerminalReference terminalName)
```
    Returns true if transaction for the given terminal reference should be routed over the local subnet.
    
    Parameters:
    
    terminalName - reference to the terminal.
    
    Returns:
    
    true, if terminal (local subnet) routed.
  - finishTerminalRequest
```
protected Object finishTerminalRequest(TerminalRouteResponse route,
                                       Object request,
                                       org.apache.commons.httpclient.methods.EntityEnclosingMethod method,
                                       Class responseType)
                                throws Exception
```
    This handles all the common logic associated with processing terminal http requests.
    
    Parameters:
    
    route - the terminal route record
    
    request - the request payload, if put or post
    
    method - the HttpMethod prepopulated
    
    responseType - expected response type.
    
    Returns:
    
    a response of type specified by responseClass
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - putTerminal
```
protected Object putTerminal(String path,
                             Object request,
                             Class responseType)
                      throws Exception
```
    Executes a put http request against the terminal API.
    
    Parameters:
    
    path - api path relative to the root (e.g. "/api/charge")
    
    request - the request payload object.
    
    responseType - expected response type.
    
    Returns:
    
    a response of type specified by responseClass
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - newTerminalRequestForRoute
```
protected TerminalRequest newTerminalRequestForRoute(TerminalRouteResponse route)
```
    Assembles a new terminal request and populates the credentials, using transient credentials if available.
    
    Parameters:
    
    route - the terminal route record.
    
    Returns:
    
    TerminalRequest
  - postTerminal
```
protected Object postTerminal(String path,
                              Object request,
                              Class responseType)
                       throws Exception
```
    Posts an http request to the terminal API.
    
    Parameters:
    
    path - api path relative to the root (e.g. "/api/charge")
    
    request - the request payload object.
    
    responseType - expected response type.
    
    Returns:
    
    a response of type specified by responseClass
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - getGateway
```
protected Object getGateway(String path,
                            boolean test,
                            Class responseType)
                     throws Exception
```
    Executes an http get request against the gateway with a timeout override.
    
    Parameters:
    
    path - api path relative to the root (e.g. "/api/heartbeat")
    
    test - whether or not this request should go to the test gateway
    
    responseType - expected response type.
    
    Returns:
    
    a response of type specified by responseClass
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - getGateway
```
protected Object getGateway(String path,
                            boolean test,
                            Class responseType,
                            int requestTimeout)
                     throws Exception
```
    Executes an http get request against the gateway with a timeout override.
    
    Parameters:
    
    path - API path relative to the root (e.g. "/api/heartbeat")
    
    test - whether or not this request should go to the test gateway
    
    responseType - expected response type.
    
    requestTimeout - timeout for the request in milliseconds
    
    Returns:
    
    a response of type specified by responseClass
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - finishGatewayRequest
```
protected Object finishGatewayRequest(org.apache.commons.httpclient.HttpMethod method,
                                      Class responseType)
                               throws Exception
```
    Executes a previously assembled HttpMethod against the gateway. Aggregates common logic associated with hitting the gateway.
    
    Parameters:
    
    method - the HttpMethod to execute.
    
    responseType - expected response type.
    
    Returns:
    
    a response of type specified by responseClass
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - postGateway
```
protected Object postGateway(String path,
                             ICoreRequest request,
                             Class responseClass)
                      throws Exception
```
    Executes a post HTTP request against the gateway.
    
    Parameters:
    
    path - API path from root (e.g. "/api/charge")
    
    request - the request object.
    
    responseClass - expected response type.
    
    Returns:
    
    a response of type specified by responseClass
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - putGateway
```
protected Object putGateway(String path,
                            ICoreRequest request,
                            Class responseClass)
                     throws Exception
```
    Executes a put HTTP request against the gateway.
    
    Parameters:
    
    path - API path from root (e.g. "/api/charge")
    
    request - the request object.
    
    responseClass - expected response type.
    
    Returns:
    
    a reponse of type specified by responseClass
    
    Throws:
    
    Exception - exception if any errors occurred processing the request.
  - resolveOfflineRouteCacheLocation
```
protected String resolveOfflineRouteCacheLocation(String terminalName)
```
    Returns the offline cache location. This will be the value of offlineRouteCacheLocation if specified and the operation system default tmp folder otherwise.
    
    Parameters:
    
    terminalName - the target terminal name.
    
    Returns:
    
    local path.
  - getOfflineCache
```
public TerminalRouteResponse getOfflineCache(String terminalName)
```
    Returns the route stored in the offline cache for the given terminal.
    
    Parameters:
    
    terminalName - the target terminal name.
    
    Returns:
    
    terminal route, null if not found.
  - getOfflineRouteCacheLocation
```
public String getOfflineRouteCacheLocation()
```
    Returns the offline route cache location.
    
    Returns:
    
    offline route cache location.
  - setOfflineRouteCacheLocation
```
public void setOfflineRouteCacheLocation(String offlineRouteCacheLocation)
```
    Sets the offline route cache location if you want to override the default. Defaults to your operation system's tmp file location.
    
    Parameters:
    
    offlineRouteCacheLocation - offline route cache location.
  - toFullyQualifiedGatewayPath
```
protected String toFullyQualifiedGatewayPath(String path,
                                             boolean test)
```
    Converts path to the fully qualified URL for a gateway API call.
    
    Parameters:
    
    path - path relative to the root (e.g. "/api/charge")
    
    test - whether or not this should route to the test transaction.
    
    Returns:
    
    fully qualified URI.
  - isTerminalHttps
```
public boolean isTerminalHttps()
```
    Gets the terminal https flag. The Java SDK defaults to using http for terminal communication because installing custom root certificate authorities in Java is quite tricky and cannot be done programmatically. We strongly recommend that all developers install our root CA in your local keystores and then turn https on in production. Our terminal root CA can be found here: https://docs.blockchyp.com/rest-api/terminal/index.html#ssl-tls
    
    Returns:
    
    https flag.
  - setTerminalHttps
```
public void setTerminalHttps(boolean terminalHttps)
```
    Sets the terminal https flag. The Java SDK defaults to using http for terminal communication because installing custom root certificate authorities in Java is quite tricky and cannot be done programmatically. We strongly recommend that all developers install our root CA in your local keystores and then turn https on in production. Our terminal root CA can be found here: https://docs.blockchyp.com/rest-api/terminal/index.html#ssl-tls
    
    Parameters:
    
    terminalHttps - https flag.

Class BlockChypClient

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

OFFLINE_CACHE

OFFLINE_FIXED_KEY

MS_PER_HOUR

Constructor Detail

BlockChypClient

BlockChypClient

BlockChypClient

BlockChypClient

BlockChypClient

Method Detail

setGatewayHost

setTestGatewayHost

setDefaultCredentials

setOfflineRouteCacheEnabled

setPaymentLogger

initObjectMapper

heartbeat

reverse

capture

closeBatch

voidTx

updateCustomer

customer

customerSearch

cashDiscount

transactionStatus

sendPaymentLink

charge

preauth

ping

balance

clear

termsAndConditions

updateTransactionDisplay

newTransactionDisplay

textPrompt

booleanPrompt

message

refund

enroll

giftActivate

terminalStatus

captureSignature

decrypt

encrypt

deriveOfflineKey

routeCacheGet

routeCachePut

toTerminalRouteKey

dumpSignatureFile

resolveTerminalRoute

getGatewayClient

getTerminalClient

resolveTerminalHost

toFullyQualifiedTerminalPath

isTerminalRouted

finishTerminalRequest

putTerminal

newTerminalRequestForRoute

postTerminal

getGateway

getGateway

finishGatewayRequest

postGateway

putGateway

resolveOfflineRouteCacheLocation

getOfflineCache

getOfflineRouteCacheLocation

setOfflineRouteCacheLocation

toFullyQualifiedGatewayPath

isTerminalHttps

setTerminalHttps