Package com.blockchyp.client.dto

Class TermsAndConditionsRequest

java.lang.Object
com.blockchyp.client.dto.TermsAndConditionsRequest
All Implemented Interfaces:
ICoreRequest, IPreviousTransaction, ISignatureRequest, ITerminalReference, ITimeoutRequest
public class TermsAndConditionsRequest extends Object implements ITimeoutRequest, ICoreRequest, IPreviousTransaction, ISignatureRequest, ITerminalReference
The fields needed for custom Terms and Conditions prompts.

  • Constructor Summary

    Constructors
    Constructor
    Description
    TermsAndConditionsRequest()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    String
    getContentHash()
    Gets a hash of the terms and conditions content that can be used for caching.
    String
    getDestinationAccount()
    Gets the settlement account for merchants with split settlements.
    String
    getOrderRef()
    Gets an identifier from an external point of sale system.
    String
    getSigFile()
    Gets a location on the filesystem which a customer signature should be written to.
    SignatureFormat
    getSigFormat()
    Gets the image format to be used for returning signatures.
    int
    getSigWidth()
    Gets the width that the signature image should be scaled to, preserving the aspect ratio.
    String
    getTcAlias()
    Gets an alias for a Terms and Conditions template configured in the BlockChyp dashboard.
    String
    getTcContent()
    Gets the content of the terms and conditions that will be presented to the user.
    String
    getTcName()
    Gets the name of the Terms and Conditions the user is accepting.
    String
    getTerminalName()
    Gets the name of the target payment terminal.
    String
    getTestCase()
    Gets can include a code used to trigger simulated conditions for the purposes of testing and certification.
    int
    getTimeout()
    Gets the request timeout in seconds.
    String
    getTransactionId()
    Gets the ID of the previous transaction being referenced.
    String
    getTransactionRef()
    Gets a user-assigned reference that can be used to recall or reverse transactions.
    boolean
    isAsync()
    Gets defers the response to the transaction and returns immediately.
    boolean
    isAutogeneratedRef()
    Gets that the transaction reference was autogenerated and should be ignored for the purposes of duplicate detection.
    boolean
    isDisableSignature()
    Gets whether or not signature prompt should be skipped on the terminal.
    boolean
    isForce()
    Gets override any in-progress transactions.
    boolean
    isQueue()
    Gets adds the transaction to the queue and returns immediately.
    boolean
    isResetConnection()
    Gets forces the terminal cloud connection to be reset while a transactions is in flight.
    boolean
    isSigRequired()
    Gets that a signature should be requested.
    boolean
    isTest()
    Gets whether or not to route transaction to the test gateway.
    boolean
    isWaitForRemovedCard()
    Gets whether or not the request should block until all cards have been removed from the card reader.
    void
    setAsync(boolean value)
    Sets defers the response to the transaction and returns immediately.
    void
    setAutogeneratedRef(boolean value)
    Sets that the transaction reference was autogenerated and should be ignored for the purposes of duplicate detection.
    void
    setContentHash(String value)
    Sets a hash of the terms and conditions content that can be used for caching.
    void
    setDestinationAccount(String value)
    Sets the settlement account for merchants with split settlements.
    void
    setDisableSignature(boolean value)
    Sets whether or not signature prompt should be skipped on the terminal.
    void
    setForce(boolean value)
    Sets override any in-progress transactions.
    void
    setOrderRef(String value)
    Sets an identifier from an external point of sale system.
    void
    setQueue(boolean value)
    Sets adds the transaction to the queue and returns immediately.
    void
    setResetConnection(boolean value)
    Sets forces the terminal cloud connection to be reset while a transactions is in flight.
    void
    setSigFile(String value)
    Sets a location on the filesystem which a customer signature should be written to.
    void
    setSigFormat(SignatureFormat value)
    Sets the image format to be used for returning signatures.
    void
    setSigRequired(boolean value)
    Sets that a signature should be requested.
    void
    setSigWidth(int value)
    Sets the width that the signature image should be scaled to, preserving the aspect ratio.
    void
    setTcAlias(String value)
    Sets an alias for a Terms and Conditions template configured in the BlockChyp dashboard.
    void
    setTcContent(String value)
    Sets the content of the terms and conditions that will be presented to the user.
    void
    setTcName(String value)
    Sets the name of the Terms and Conditions the user is accepting.
    void
    setTerminalName(String value)
    Sets the name of the target payment terminal.
    void
    setTest(boolean value)
    Sets whether or not to route transaction to the test gateway.
    void
    setTestCase(String value)
    Sets can include a code used to trigger simulated conditions for the purposes of testing and certification.
    void
    setTimeout(int value)
    Sets the request timeout in seconds.
    void
    setTransactionId(String value)
    Sets the ID of the previous transaction being referenced.
    void
    setTransactionRef(String value)
    Sets a user-assigned reference that can be used to recall or reverse transactions.
    void
    setWaitForRemovedCard(boolean value)
    Sets whether or not the request should block until all cards have been removed from the card reader.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Constructor Details

    • TermsAndConditionsRequest

      public TermsAndConditionsRequest()

  • Method Details

    • setTimeout

      public void setTimeout(int value)
      Sets the request timeout in seconds.
      Parameters:
      value - the request timeout in seconds.

    • getTimeout

      public int getTimeout()
      Gets the request timeout in seconds.
      Specified by:
      getTimeout in interface ITimeoutRequest
      Returns:
      the request timeout in seconds.

    • setTest

      public void setTest(boolean value)
      Sets whether or not to route transaction to the test gateway.
      Parameters:
      value - whether or not to route transaction to the test gateway.

    • isTest

      public boolean isTest()
      Gets whether or not to route transaction to the test gateway.
      Specified by:
      isTest in interface ITimeoutRequest
      Returns:
      whether or not to route transaction to the test gateway.

    • setTransactionRef

      public void setTransactionRef(String value)
      Sets a user-assigned reference that can be used to recall or reverse transactions.
      Parameters:
      value - a user-assigned reference that can be used to recall or reverse transactions.

    • getTransactionRef

      public String getTransactionRef()
      Gets a user-assigned reference that can be used to recall or reverse transactions.
      Specified by:
      getTransactionRef in interface ICoreRequest
      Returns:
      a user-assigned reference that can be used to recall or reverse transactions.

    • setAutogeneratedRef

      public void setAutogeneratedRef(boolean value)
      Sets that the transaction reference was autogenerated and should be ignored for the purposes of duplicate detection.
      Parameters:
      value - that the transaction reference was autogenerated and should be ignored for the purposes of duplicate detection.

    • isAutogeneratedRef

      public boolean isAutogeneratedRef()
      Gets that the transaction reference was autogenerated and should be ignored for the purposes of duplicate detection.
      Specified by:
      isAutogeneratedRef in interface ICoreRequest
      Returns:
      that the transaction reference was autogenerated and should be ignored for the purposes of duplicate detection.

    • setAsync

      public void setAsync(boolean value)
      Sets defers the response to the transaction and returns immediately.
      Parameters:
      value - defers the response to the transaction and returns immediately. Callers should retrive the transaction result using the Transaction Status API.

    • isAsync

      public boolean isAsync()
      Gets defers the response to the transaction and returns immediately.
      Specified by:
      isAsync in interface ICoreRequest
      Returns:
      defers the response to the transaction and returns immediately. Callers should retrive the transaction result using the Transaction Status API.

    • setQueue

      public void setQueue(boolean value)
      Sets adds the transaction to the queue and returns immediately.
      Parameters:
      value - adds the transaction to the queue and returns immediately. Callers should retrive the transaction result using the Transaction Status API.

    • isQueue

      public boolean isQueue()
      Gets adds the transaction to the queue and returns immediately.
      Specified by:
      isQueue in interface ICoreRequest
      Returns:
      adds the transaction to the queue and returns immediately. Callers should retrive the transaction result using the Transaction Status API.

    • setWaitForRemovedCard

      public void setWaitForRemovedCard(boolean value)
      Sets whether or not the request should block until all cards have been removed from the card reader.
      Parameters:
      value - whether or not the request should block until all cards have been removed from the card reader.

    • isWaitForRemovedCard

      public boolean isWaitForRemovedCard()
      Gets whether or not the request should block until all cards have been removed from the card reader.
      Specified by:
      isWaitForRemovedCard in interface ICoreRequest
      Returns:
      whether or not the request should block until all cards have been removed from the card reader.

    • setForce

      public void setForce(boolean value)
      Sets override any in-progress transactions.
      Parameters:
      value - override any in-progress transactions.

    • isForce

      public boolean isForce()
      Gets override any in-progress transactions.
      Specified by:
      isForce in interface ICoreRequest
      Returns:
      override any in-progress transactions.

    • setOrderRef

      public void setOrderRef(String value)
      Sets an identifier from an external point of sale system.
      Parameters:
      value - an identifier from an external point of sale system.

    • getOrderRef

      public String getOrderRef()
      Gets an identifier from an external point of sale system.
      Specified by:
      getOrderRef in interface ICoreRequest
      Returns:
      an identifier from an external point of sale system.

    • setDestinationAccount

      public void setDestinationAccount(String value)
      Sets the settlement account for merchants with split settlements.
      Parameters:
      value - the settlement account for merchants with split settlements.

    • getDestinationAccount

      public String getDestinationAccount()
      Gets the settlement account for merchants with split settlements.
      Specified by:
      getDestinationAccount in interface ICoreRequest
      Returns:
      the settlement account for merchants with split settlements.

    • setTestCase

      public void setTestCase(String value)
      Sets can include a code used to trigger simulated conditions for the purposes of testing and certification.
      Parameters:
      value - can include a code used to trigger simulated conditions for the purposes of testing and certification. Valid for test merchant accounts only.

    • getTestCase

      public String getTestCase()
      Gets can include a code used to trigger simulated conditions for the purposes of testing and certification.
      Specified by:
      getTestCase in interface ICoreRequest
      Returns:
      can include a code used to trigger simulated conditions for the purposes of testing and certification. Valid for test merchant accounts only.

    • setTransactionId

      public void setTransactionId(String value)
      Sets the ID of the previous transaction being referenced.
      Parameters:
      value - the ID of the previous transaction being referenced.

    • getTransactionId

      public String getTransactionId()
      Gets the ID of the previous transaction being referenced.
      Specified by:
      getTransactionId in interface IPreviousTransaction
      Returns:
      the ID of the previous transaction being referenced.

    • setSigFile

      public void setSigFile(String value)
      Sets a location on the filesystem which a customer signature should be written to.
      Parameters:
      value - a location on the filesystem which a customer signature should be written to.

    • getSigFile

      public String getSigFile()
      Gets a location on the filesystem which a customer signature should be written to.
      Specified by:
      getSigFile in interface ISignatureRequest
      Returns:
      a location on the filesystem which a customer signature should be written to.

    • setSigFormat

      public void setSigFormat(SignatureFormat value)
      Sets the image format to be used for returning signatures.
      Parameters:
      value - the image format to be used for returning signatures.

    • getSigFormat

      public SignatureFormat getSigFormat()
      Gets the image format to be used for returning signatures.
      Specified by:
      getSigFormat in interface ISignatureRequest
      Returns:
      the image format to be used for returning signatures.

    • setSigWidth

      public void setSigWidth(int value)
      Sets the width that the signature image should be scaled to, preserving the aspect ratio.
      Parameters:
      value - the width that the signature image should be scaled to, preserving the aspect ratio. If not provided, the signature is returned in the terminal's max resolution.

    • getSigWidth

      public int getSigWidth()
      Gets the width that the signature image should be scaled to, preserving the aspect ratio.
      Specified by:
      getSigWidth in interface ISignatureRequest
      Returns:
      the width that the signature image should be scaled to, preserving the aspect ratio. If not provided, the signature is returned in the terminal's max resolution.

    • setDisableSignature

      public void setDisableSignature(boolean value)
      Sets whether or not signature prompt should be skipped on the terminal.
      Parameters:
      value - whether or not signature prompt should be skipped on the terminal. The terminal will indicate whether or not a signature is required by the card in the receipt suggestions response.

    • isDisableSignature

      public boolean isDisableSignature()
      Gets whether or not signature prompt should be skipped on the terminal.
      Specified by:
      isDisableSignature in interface ISignatureRequest
      Returns:
      whether or not signature prompt should be skipped on the terminal. The terminal will indicate whether or not a signature is required by the card in the receipt suggestions response.

    • setTerminalName

      public void setTerminalName(String value)
      Sets the name of the target payment terminal.
      Parameters:
      value - the name of the target payment terminal.

    • getTerminalName

      public String getTerminalName()
      Gets the name of the target payment terminal.
      Specified by:
      getTerminalName in interface ITerminalReference
      Returns:
      the name of the target payment terminal.

    • setResetConnection

      public void setResetConnection(boolean value)
      Sets forces the terminal cloud connection to be reset while a transactions is in flight.
      Parameters:
      value - forces the terminal cloud connection to be reset while a transactions is in flight. This is a diagnostic settings that can be used only for test transactions.

    • isResetConnection

      public boolean isResetConnection()
      Gets forces the terminal cloud connection to be reset while a transactions is in flight.
      Specified by:
      isResetConnection in interface ITerminalReference
      Returns:
      forces the terminal cloud connection to be reset while a transactions is in flight. This is a diagnostic settings that can be used only for test transactions.

    • setTcAlias

      public void setTcAlias(String value)
      Sets an alias for a Terms and Conditions template configured in the BlockChyp dashboard.
      Parameters:
      value - an alias for a Terms and Conditions template configured in the BlockChyp dashboard.

    • getTcAlias

      public String getTcAlias()
      Gets an alias for a Terms and Conditions template configured in the BlockChyp dashboard.
      Returns:
      an alias for a Terms and Conditions template configured in the BlockChyp dashboard.

    • setTcName

      public void setTcName(String value)
      Sets the name of the Terms and Conditions the user is accepting.
      Parameters:
      value - the name of the Terms and Conditions the user is accepting.

    • getTcName

      public String getTcName()
      Gets the name of the Terms and Conditions the user is accepting.
      Returns:
      the name of the Terms and Conditions the user is accepting.

    • setTcContent

      public void setTcContent(String value)
      Sets the content of the terms and conditions that will be presented to the user.
      Parameters:
      value - the content of the terms and conditions that will be presented to the user.

    • getTcContent

      public String getTcContent()
      Gets the content of the terms and conditions that will be presented to the user.
      Returns:
      the content of the terms and conditions that will be presented to the user.

    • setContentHash

      public void setContentHash(String value)
      Sets a hash of the terms and conditions content that can be used for caching.
      Parameters:
      value - a hash of the terms and conditions content that can be used for caching.

    • getContentHash

      public String getContentHash()
      Gets a hash of the terms and conditions content that can be used for caching.
      Returns:
      a hash of the terms and conditions content that can be used for caching.

    • setSigRequired

      public void setSigRequired(boolean value)
      Sets that a signature should be requested.
      Parameters:
      value - that a signature should be requested.

    • isSigRequired

      public boolean isSigRequired()
      Gets that a signature should be requested.
      Returns:
      that a signature should be requested.