net.authorize.aim

Class Transaction

java.lang.Object

net.authorize.Transaction

net.authorize.aim.Transaction

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

Transaction

public class Transaction
extends Transaction
implements java.io.Serializable

Container to hold all payment related information that gets passed back and forth to the payment gateway.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	MD5Value
protected java.util.Map<java.lang.String,java.lang.String>	merchantDefinedMap
protected java.util.Map<java.lang.String,java.lang.String>	requestMap
protected TransactionType	transactionType

Fields inherited from class net.authorize.Transaction

BRACKET_PIPE_DELIMITER, CURRENCY_DECIMAL_PLACES, EMPTY_STRING, ENCAP_CHAR_DELIMITER, FALSE, MAX_AUTH_CODE_LENGTH, QUANTITY_DECIMAL_PLACES, TRANSACTION_FIELD_DELIMITER, TRUE, VERSION, ZERO_AMOUNT, ZERO_STRING

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Transaction(Merchant merchant, TransactionType transactionType, java.math.BigDecimal amount) Constructor for creation a transaction with typed objects.

Method Summary

Methods

Modifier and Type	Method and Description
static Transaction	createTransaction(Merchant merchant, TransactionType transactionType, java.math.BigDecimal amount) Create a Transaction for a merchant.
static Transaction	createTransaction(Transaction transaction, BasicXmlDocument response) Create a transaction from a response XML doc.
static Transaction	createTransaction(Transaction transaction, java.util.Map<ResponseField,java.lang.String> responseMap) Create a transaction from a responseMap.
java.lang.String	getAuthorizationCode() Get the authorization code of the transaction.
CreditCard	getCreditCard() Get the CreditCard associated with the transaction.
java.lang.String	getCurrencyCode() Get the currency code for Card Present transactions.
BasicXmlDocument	getCurrentResponse() Return a response XML doc if the transaction was a Card Present transaction.
Customer	getCustomer() Get the Customer information associated with the transaction.
ECheck	getECheck()
EmailReceipt	getEmailReceipt() Get the EmailReceipt associated with the transaction.
java.lang.String	getMD5Value()
java.lang.String	getMerchantDefinedField(java.lang.String field) Get a merchant defined field.
java.util.Map<java.lang.String,java.lang.String>	getMerchantDefinedMap() Get the merchant defined data map.
Order	getOrder() Get the Order associated with the transaction.
java.util.Map<java.lang.String,java.lang.String>	getRequestMap()
java.lang.String	getResponseField(ResponseField responseField) Returns the payment gateway response data for a specific ResponseField.
java.util.Map<ResponseField,java.lang.String>	getResponseMap() Return the payment gateway response data map.
ShippingAddress	getShippingAddress() Get the ShippingAddress for the transaction request.
ShippingCharges	getShippingCharges() Get the ShippingCharges associated with the transaction.
Solution	getSolutionField() Get a solution field.
java.lang.String	getTransactionId() Return the payment gateway assigned transaction ID of the transaction.
TransactionType	getTransactionType() Get the transaction type.
boolean	isCardPresent() Return true if the transaction is a Card Present type transaction.
void	setAuthorizationCode(java.lang.String authCode) The authorization code of an original transaction not captured on the payment gateway.
void	setCreditCard(CreditCard creditCard) Set the CreditCard information for the transaction request.
void	setCurrencyCode(java.lang.String currencyCode) Set the currency code for Card Present transactions.
void	setCustomer(Customer customer) Set the Customer information for the transaction request.
void	setDuplicateWindow(int seconds) The window of time after the submission of a transaction that a duplicate transaction can not be submitted.
void	setECheck(ECheck eCheck)
void	setEmailReceipt(EmailReceipt emailReceipt) Set the EmailReceipt information for the transaction request.
void	setMerchantDefinedField(java.lang.String field, java.lang.String value) Set a merchant defined field.
void	setOrder(Order order) Set the Order (and OrderItems) for the transaction request.
void	setRecurringBilling(boolean recurringBillingStatus) Indicating marker used by merchant account providers to identify transactions which originate from merchant hosted recurring billing applications.
void	setShippingAddress(ShippingAddress shippingAddress) Set the ShippingAddress for the transaction request.
void	setShippingCharges(ShippingCharges shippingCharges) Set the ShippingCharges for the transaction request.
void	setSolutionField(Solution solution) Set a solution field.
void	setSplitTenderId(java.lang.String splitTenderId) The payment gateway assigned slit tender ID of an original transaction.
void	setTransactionId(java.lang.String transactionId) The payment gateway assigned transaction ID of an original transaction.
java.lang.String	toNVPString() Prepare the name/value pair mapping based on the Map(s) provided.

Methods inherited from class net.authorize.Transaction

getDecodedString, getEncodedString, setEncapCharDelimiter, setTransactionFieldDelimiter, toXMLString

Methods inherited from class java.lang.Object

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

Field Detail

requestMap

protected java.util.Map<java.lang.String,java.lang.String> requestMap

merchantDefinedMap

protected java.util.Map<java.lang.String,java.lang.String> merchantDefinedMap

transactionType

protected TransactionType transactionType

MD5Value

protected java.lang.String MD5Value

Constructor Detail

Transaction

protected Transaction(Merchant merchant,
           TransactionType transactionType,
           java.math.BigDecimal amount)

Constructor for creation a transaction with typed objects.

Parameters:

merchant -

transactionType -

amount -

Method Detail

createTransaction

public static final Transaction createTransaction(Transaction transaction,
                            java.util.Map<ResponseField,java.lang.String> responseMap)

Create a transaction from a responseMap.

Parameters:

transaction -

responseMap -

Returns:

a Transaction

createTransaction

public static final Transaction createTransaction(Transaction transaction,
                            BasicXmlDocument response)

Create a transaction from a response XML doc.

Parameters:

transaction -

response -

Returns:

Transaction object

createTransaction

public static Transaction createTransaction(Merchant merchant,
                            TransactionType transactionType,
                            java.math.BigDecimal amount)

Create a Transaction for a merchant.

Parameters:

merchant -

transactionType -

amount -

getRequestMap

public java.util.Map<java.lang.String,java.lang.String> getRequestMap()

Returns:

the transactionRequestHash

getResponseMap

public java.util.Map<ResponseField,java.lang.String> getResponseMap()

Return the payment gateway response data map.

Returns:

a map of response data

setTransactionId

public void setTransactionId(java.lang.String transactionId)

The payment gateway assigned transaction ID of an original transaction.

Parameters:

transactionId -

setSplitTenderId

public void setSplitTenderId(java.lang.String splitTenderId)

The payment gateway assigned slit tender ID of an original transaction.

Parameters:

splitTenderId -

getTransactionId

public java.lang.String getTransactionId()

Return the payment gateway assigned transaction ID of the transaction.

Returns:

The transaction id.

getTransactionType

public TransactionType getTransactionType()

Get the transaction type.

Returns:

the transactionType

setAuthorizationCode

public void setAuthorizationCode(java.lang.String authCode)

The authorization code of an original transaction not captured on the payment gateway.

Parameters:

authCode -

getAuthorizationCode

public java.lang.String getAuthorizationCode()

Get the authorization code of the transaction.

Returns:

authorizationCode

setCreditCard

public void setCreditCard(CreditCard creditCard)

Set the CreditCard information for the transaction request.

Parameters:

creditCard -

getCreditCard

public CreditCard getCreditCard()

Get the CreditCard associated with the transaction.

Returns:

credit card object

setECheck

public void setECheck(ECheck eCheck)

Parameters:

eCheck - the eCheck to set

getECheck

public ECheck getECheck()

Returns:

the eCheck

setCustomer

public void setCustomer(Customer customer)

Set the Customer information for the transaction request.

Parameters:

customer -

getCustomer

public Customer getCustomer()

Get the Customer information associated with the transaction.

Returns:

The Customer

setEmailReceipt

public void setEmailReceipt(EmailReceipt emailReceipt)

Set the EmailReceipt information for the transaction request.

Parameters:

emailReceipt -

getEmailReceipt

public EmailReceipt getEmailReceipt()

Get the EmailReceipt associated with the transaction.

Returns:

The EmailReceipt.

setOrder

public void setOrder(Order order)

Set the Order (and OrderItems) for the transaction request.

Parameters:

order -

getOrder

public Order getOrder()

Get the Order associated with the transaction.

Returns:

The Order.

setShippingAddress

public void setShippingAddress(ShippingAddress shippingAddress)

Set the ShippingAddress for the transaction request.

Parameters:

shippingAddress -

getShippingAddress

public ShippingAddress getShippingAddress()

Get the ShippingAddress for the transaction request.

Returns:

The ShippingAddress

setShippingCharges

public void setShippingCharges(ShippingCharges shippingCharges)

Set the ShippingCharges for the transaction request.

Parameters:

shippingCharges -

getShippingCharges

public ShippingCharges getShippingCharges()

Get the ShippingCharges associated with the transaction.

Returns:

The ShippingCharges

setDuplicateWindow

public void setDuplicateWindow(int seconds)

The window of time after the submission of a transaction that a duplicate transaction can not be submitted.

Parameters:

seconds -

setCurrencyCode

public void setCurrencyCode(java.lang.String currencyCode)

Set the currency code for Card Present transactions.

Parameters:

currencyCode -

getCurrencyCode

public java.lang.String getCurrencyCode()

Get the currency code for Card Present transactions.

Returns:

the currencyCode used in the transaction.

setRecurringBilling

public void setRecurringBilling(boolean recurringBillingStatus)

Indicating marker used by merchant account providers to identify transactions which originate from merchant hosted recurring billing applications. This value is not affiliated with Automated Recurring Billing.

Parameters:

recurringBillingStatus -

setMerchantDefinedField

public void setMerchantDefinedField(java.lang.String field,
                           java.lang.String value)

Set a merchant defined field.

Parameters:

field -

value -

getMerchantDefinedField

public java.lang.String getMerchantDefinedField(java.lang.String field)

Get a merchant defined field.

Parameters:

field -

Returns:

Return the value found in the merchant defined hash by a field.

getMerchantDefinedMap

public java.util.Map<java.lang.String,java.lang.String> getMerchantDefinedMap()

Get the merchant defined data map.

Returns:

a map of merchant defined data

getResponseField

public java.lang.String getResponseField(ResponseField responseField)

Returns the payment gateway response data for a specific ResponseField.

Parameters:

responseField -

Returns:

the value found in the map identified by the response field

toNVPString

public java.lang.String toNVPString()

Prepare the name/value pair mapping based on the Map(s) provided.

Overrides:

toNVPString in class Transaction

Returns:

String

isCardPresent

public boolean isCardPresent()

Return true if the transaction is a Card Present type transaction.

Returns:

the cardPresent

getCurrentResponse

public BasicXmlDocument getCurrentResponse()

Return a response XML doc if the transaction was a Card Present transaction.

Returns:

the responseXml

getMD5Value

public java.lang.String getMD5Value()

Returns:

the mD5Value

setSolutionField

public void setSolutionField(Solution solution)

Set a solution field.

Parameters:

solution -

getSolutionField

public Solution getSolutionField()

Get a solution field.

Returns:

Return the solution field.