com.beasys.commerce.ebusiness.payment
Interface PaymentTransaction

All Superinterfaces
BusinessSmartComponent, javax.ejb.EJBObject, Entity, Remote, RemoteRelationalReference, Serializable

Deprecated See BEA Commerce product offering

@Deprecated
public interface PaymentTransaction
extends Entity

A PaymentTransaction is an Entity EJB that maintains the state of an individual Credit Card transaction. This includes the credit card, amount, status, and date of last modification. It also maintains a journal of the actions in the form of TransactionEntry objects taken as the transaction is moved through authorization, capture, and settlement.

The transaction workflow is dictated by the PaymentWorkflow state machine.

See Also
PaymentTransactionPk, PaymentTransactionHome, PaymentTransactionValue, TransactionEntry, PaymentWorkflow

Method Summary
 boolean addTransactionEntry(TransactionEntry element)
          Deprecated See BEA Commerce product offering
 boolean addTransactionEntryCollection(Collection collection)
          Deprecated See BEA Commerce product offering
 void authorize()
          Deprecated See BEA Commerce product offering
 void clearTransactionEntryCollection()
          Deprecated See BEA Commerce product offering
 boolean containsTransactionEntry(TransactionEntry element)
          Deprecated See BEA Commerce product offering
 boolean containsTransactionEntryCollection(Collection c)
          Deprecated See BEA Commerce product offering
 boolean equalsTransactionEntryCollection(Object object)
          Deprecated See BEA Commerce product offering
 void failRetry()
          Deprecated See BEA Commerce product offering
 void failSettle()
          Deprecated See BEA Commerce product offering
 String getBatchId()
          Deprecated See BEA Commerce product offering
 com.beasys.commerce.axiom.contact.CreditCard getCreditCard()
          Deprecated See BEA Commerce product offering
 PaymentTransactionValue getPaymentTransactionByValue()
          Deprecated See BEA Commerce product offering
 String getStatus()
          Deprecated See BEA Commerce product offering
 Price getTransactionAmount()
          Deprecated See BEA Commerce product offering
 Date getTransactionDate()
          Deprecated See BEA Commerce product offering
 Collection getTransactionEntryCollection()
          Deprecated See BEA Commerce product offering
 String getTransactionId()
          Deprecated See BEA Commerce product offering
 boolean isTransactionEntryCollectionEmpty()
          Deprecated See BEA Commerce product offering
 void markForSettle()
          Deprecated See BEA Commerce product offering
 void pendingSettle()
          Deprecated See BEA Commerce product offering
 void queryFail()
          Deprecated See BEA Commerce product offering
 void querySuccess()
          Deprecated See BEA Commerce product offering
 void reject()
          Deprecated See BEA Commerce product offering
 boolean removeTransactionEntry(TransactionEntry element)
          Deprecated See BEA Commerce product offering
 boolean removeTransactionEntryCollection(Collection collection)
          Deprecated See BEA Commerce product offering
 boolean retainTransactionEntryCollection(Collection collection)
          Deprecated See BEA Commerce product offering
 void setBatchId(String batchId)
          Deprecated See BEA Commerce product offering
 void setCreditCard(com.beasys.commerce.axiom.contact.CreditCard creditCard)
          Deprecated See BEA Commerce product offering
 void setPaymentTransactionByValue(PaymentTransactionValue value)
          Deprecated See BEA Commerce product offering
 void settle()
          Deprecated See BEA Commerce product offering
 void setTransactionAmount(Price transactionAmount)
          Deprecated See BEA Commerce product offering
 void setTransactionDate(Date transactionDate)
          Deprecated See BEA Commerce product offering
 void setTransactionEntryCollection(Collection collection)
          Deprecated See BEA Commerce product offering
 void systemFailure()
          Deprecated See BEA Commerce product offering
 int transactionEntryCollectionHashCode()
          Deprecated See BEA Commerce product offering
 int transactionEntryCollectionSize()
          Deprecated See BEA Commerce product offering
 
Methods inherited from interface javax.ejb.EJBObject
getEJBHome, getHandle, getPrimaryKey, isIdentical, remove
 
Methods inherited from interface com.beasys.commerce.foundation.RemoteRelationalReference
get__classIdentifier, get__containingBelonging, get__containingEntity, get__mapKey, get__sequenceNumber, set__containingBelonging, set__containingEntity, set__mapKey
 

Method Detail

getPaymentTransactionByValue

PaymentTransactionValue getPaymentTransactionByValue()
                                                     throws RemoteException
Deprecated See BEA Commerce product offering

Retrieve a local copy of all of the public attributes in the form of a PaymentTransactionValue object. This reduces the number of remote method invocations needed to retrieve all of the information associated with this Entity.

Returns
PaymentTransactionValue The PaymentTransaction value object
Throws
RemoteException - On remote error.

setPaymentTransactionByValue

void setPaymentTransactionByValue(PaymentTransactionValue value)
                                  throws RemoteException
Deprecated See BEA Commerce product offering

Update all of the public attributes of a PaymentTransaction with a single method invocation. Note: Primary key attributes are not set.

Parameters
PaymentTransactionValue - the PaymentTransaction value object
Throws
RemoteException - On remote error.

getTransactionId

String getTransactionId()
                        throws RemoteException
Deprecated See BEA Commerce product offering

Get the transaction's identifier. This is the primary key for the Entity.

Parameters
PaymentTransactionValue - the PaymentTransaction value object
Throws
RemoteException - On remote error.

getCreditCard

com.beasys.commerce.axiom.contact.CreditCard getCreditCard()
                                                           throws RemoteException
Deprecated See BEA Commerce product offering

Get the credit card information associated with the transaction.

Returns
creditCard the credit card associated with the transaction.
Throws
RemoteException - On remote error.

setCreditCard

void setCreditCard(com.beasys.commerce.axiom.contact.CreditCard creditCard)
                   throws RemoteException
Deprecated See BEA Commerce product offering

Set the credit card information associated with the transaction

Parameters
creditCard - the new credit card information
Throws
RemoteException - On remote error.

getTransactionDate

Date getTransactionDate()
                        throws RemoteException
Deprecated See BEA Commerce product offering

Get the date that the transaction was last updated.

Returns
transactionDate the transaction date.
Throws
RemoteException - On remote error.

setTransactionDate

void setTransactionDate(Date transactionDate)
                        throws RemoteException
Deprecated See BEA Commerce product offering

Set the modification date for the PaymentTransaction

Parameters
transactionDate - the transaction date to be set.
Throws
RemoteException - On remote error.

getTransactionEntryCollection

Collection getTransactionEntryCollection()
                                         throws RemoteException
Deprecated See BEA Commerce product offering

Returns a history of the modifications to this transaction.

Returns
a collection of TransactionEntry objects.
Throws
RemoteException - On remote error.

setTransactionEntryCollection

void setTransactionEntryCollection(Collection collection)
                                   throws RemoteException
Deprecated See BEA Commerce product offering

Update the journal of the modifications for this transaction.

Parameters
collection - a collection of TransactionEntry objects.
Throws
RemoteException - On remote error.

addTransactionEntry

boolean addTransactionEntry(TransactionEntry element)
                            throws RemoteException
Deprecated See BEA Commerce product offering

Adds a new TransactionEntry to the journal.

Parameters
element - The Transaction entry to add.
Returns
true if the collection was modified as a result of the operation.
Throws
RemoteException - On remote error.

addTransactionEntryCollection

boolean addTransactionEntryCollection(Collection collection)
                                      throws RemoteException
Deprecated See BEA Commerce product offering

Adds all of the TransactionEntries to the journal.

Parameters
collection - a collection of TransactionEntry objects.
Returns
true if the collection was modified as a result of the operation.
Throws
RemoteException - On remote error.

clearTransactionEntryCollection

void clearTransactionEntryCollection()
                                     throws RemoteException
Deprecated See BEA Commerce product offering

Removes all of the transaction entries from the journal.

Throws
RemoteException - On remote error.

containsTransactionEntry

boolean containsTransactionEntry(TransactionEntry element)
                                 throws RemoteException
Deprecated See BEA Commerce product offering

Returns true if this collection contains the specified element.

Throws
RemoteException

containsTransactionEntryCollection

boolean containsTransactionEntryCollection(Collection c)
                                           throws RemoteException
Deprecated See BEA Commerce product offering

Returns true if this collection contains all of the elements in the specified collection.

Throws
RemoteException

equalsTransactionEntryCollection

boolean equalsTransactionEntryCollection(Object object)
                                         throws RemoteException
Deprecated See BEA Commerce product offering

Compares the specified object with this collection for equality.

Throws
RemoteException

transactionEntryCollectionHashCode

int transactionEntryCollectionHashCode()
                                       throws RemoteException
Deprecated See BEA Commerce product offering

Returns the hash code value for this collection.

Throws
RemoteException

isTransactionEntryCollectionEmpty

boolean isTransactionEntryCollectionEmpty()
                                          throws RemoteException
Deprecated See BEA Commerce product offering

Returns true if this collection contains no elements.

Throws
RemoteException

removeTransactionEntry

boolean removeTransactionEntry(TransactionEntry element)
                               throws RemoteException
Deprecated See BEA Commerce product offering

Removes a single instance of the specified element from this collection, if it is present (optional operation).

Throws
RemoteException

removeTransactionEntryCollection

boolean removeTransactionEntryCollection(Collection collection)
                                         throws RemoteException
Deprecated See BEA Commerce product offering

Removes all this collection's elements that are also contained in the specified collection (optional operation).

Throws
RemoteException

retainTransactionEntryCollection

boolean retainTransactionEntryCollection(Collection collection)
                                         throws RemoteException
Deprecated See BEA Commerce product offering

Retains only the elements in this collection that are contained in the specified collection (optional operation).

Throws
RemoteException

transactionEntryCollectionSize

int transactionEntryCollectionSize()
                                   throws RemoteException
Deprecated See BEA Commerce product offering

Returns the number of elements in this collection.

Throws
RemoteException

getBatchId

String getBatchId()
                  throws RemoteException
Deprecated See BEA Commerce product offering

Get the value of the identifier for the batch in which this Payment was settled.

Returns
batchId
Throws
RemoteException

setBatchId

void setBatchId(String batchId)
                throws RemoteException
Deprecated See BEA Commerce product offering

Set the value of the identifier for the batch in which this Payment was settled.

Parameters
batchId - batchId to be added
Throws
RemoteException

getStatus

String getStatus()
                 throws RemoteException
Deprecated See BEA Commerce product offering

Retrieve the status of this payment. The series of states will be as governed by the PaymentWorkflow

Throws
RemoteException

getTransactionAmount

Price getTransactionAmount()
                           throws RemoteException
Deprecated See BEA Commerce product offering

Get the amount of the transaction.

Returns
transactionAmount.
Throws
RemoteException

setTransactionAmount

void setTransactionAmount(Price transactionAmount)
                          throws RemoteException
Deprecated See BEA Commerce product offering

Set the amount of the transaction.

Parameters
transactionAmount - the amount of the transaction.
Throws
RemoteException

authorize

void authorize()
               throws RemoteException,
                      WorkflowInstantiationException,
                      IllegalWorkflowTransitionException
Deprecated See BEA Commerce product offering

Change the state of the payment transaction by applying the authorize event. This method is invoked prior to atempting the authorize operation and will throw an exception if the operation is being executed out of sequence.

Throws
WorkflowInstantiationException
IllegalWorkflowTransitionException
RemoteException

reject

void reject()
            throws RemoteException,
                   WorkflowInstantiationException,
                   IllegalWorkflowTransitionException
Deprecated See BEA Commerce product offering

Change the state of the payment transaction by applying the reject event. This method is invoked when an authorization atempt is rejected.

Throws
WorkflowInstantiationException
IllegalWorkflowTransitionException
RemoteException

failSettle

void failSettle()
                throws RemoteException,
                       WorkflowInstantiationException,
                       IllegalWorkflowTransitionException
Deprecated See BEA Commerce product offering

Change the state of the payment transaction by applying the failSettle event. This method is invoked prior when an settle operation fails.

Throws
WorkflowInstantiationException
IllegalWorkflowTransitionException
RemoteException

markForSettle

void markForSettle()
                   throws RemoteException,
                          WorkflowInstantiationException,
                          IllegalWorkflowTransitionException
Deprecated See BEA Commerce product offering

Change the state of the payment transaction by applying the markForSettle event. This method is invoked prior to atempting the capture operation and will throw an exception if the operation is being executed out of sequence.

Throws
WorkflowInstantiationException
IllegalWorkflowTransitionException
RemoteException

settle

void settle()
            throws RemoteException,
                   WorkflowInstantiationException,
                   IllegalWorkflowTransitionException
Deprecated See BEA Commerce product offering

Change the state of the payment transaction by applying the settle event. This method is invoked prior to atempting the settle operation and will throw an exception if the operation is being executed out of sequence.

Throws
WorkflowInstantiationException
IllegalWorkflowTransitionException
RemoteException

pendingSettle

void pendingSettle()
                   throws RemoteException,
                          WorkflowInstantiationException,
                          IllegalWorkflowTransitionException
Deprecated See BEA Commerce product offering

Change the state of the payment transaction by applying the pendingSettle event. This method is invoked when a transaction is successfully moved to the pending settle state.

Throws
WorkflowInstantiationException
IllegalWorkflowTransitionException
RemoteException

querySuccess

void querySuccess()
                  throws RemoteException,
                         WorkflowInstantiationException,
                         IllegalWorkflowTransitionException
Deprecated See BEA Commerce product offering

Change the state of the payment transaction by applying the querySuccess event. This method is invoked when the status of a batch transaction is successfully verified.

Throws
WorkflowInstantiationException
IllegalWorkflowTransitionException
RemoteException

queryFail

void queryFail()
               throws RemoteException,
                      WorkflowInstantiationException,
                      IllegalWorkflowTransitionException
Deprecated See BEA Commerce product offering

Change the state of the payment transaction by applying the queryFail event. This method is invoked when the status of a batch transaction faile to be verified.

Throws
WorkflowInstantiationException
IllegalWorkflowTransitionException
RemoteException

systemFailure

void systemFailure()
                   throws RemoteException,
                          WorkflowInstantiationException,
                          IllegalWorkflowTransitionException
Deprecated See BEA Commerce product offering

Change the state of the payment transaction by applying the systemFailure event. This method is invoked when an operation fails due to a problem with the credit card service.

Throws
WorkflowInstantiationException
IllegalWorkflowTransitionException
RemoteException

failRetry

void failRetry()
               throws RemoteException,
                      WorkflowInstantiationException,
                      IllegalWorkflowTransitionException
Deprecated See BEA Commerce product offering

Change the state of the payment transaction by applying the failRetry event. This method is invoked when a retry of an authorization fails.

Throws
WorkflowInstantiationException
IllegalWorkflowTransitionException
RemoteException


Copyright © 2008 BEA Systems, Inc. All Rights Reserved