com.blockchyp.client.dto

Class LocateRequest

java.lang.Object

com.blockchyp.client.dto.LocateRequest

All Implemented Interfaces:

ICoreRequest, ITerminalReference, ITimeoutRequest

public class LocateRequest
extends Object
implements ITimeoutRequest, ICoreRequest, ITerminalReference

Information needed to retrieve location information for a terminal.

Constructor Summary

Constructors

Constructor and Description
LocateRequest()

Method Summary

Modifier and Type	Method and Description
String	getDestinationAccount() Gets the settlement account for merchants with split settlements.
String	getOrderRef() Gets an identifier from an external point of sale system.
String	getTerminalName() Gets the name of the target payment terminal.
int	getTimeout() Gets the request timeout in seconds.
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	isForce() Gets override any in-progress transactions.
boolean	isQueue() Gets adds the transaction to the queue and returns immediately.
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	setDestinationAccount(String value) Sets the settlement account for merchants with split settlements.
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	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	setTimeout(int value) Sets the request timeout in seconds.
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 Detail

LocateRequest

public LocateRequest()

Method Detail

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.

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.

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.