com.ibm.commerce.payment.beans
Class PayStatusPMDataBean

com.ibm.commerce.payment.beans.PayStatusPMDataBean

public class PayStatusPMDataBean

This DataBean, when populated, provides the order state and payment state of the specified order as known by the Payment Manager. The order must be one that has been sent to the Payment Manager for processing. No information will be returned if the order is not known to the Payment Manager. This DataBean is designed for the use of JavaServer Pages that may be invoked during shopping flow to display the payment status of an order owned by the shopper. No information will be returned if the shopper is not the owner of the specified order.


Constructor Summary
PayStatusPMDataBean()
          PayStatusPMDataBean default constructor.
 
Method Summary
 java.lang.String getCommonAVSCode()
          Returns the commonAVSCode property of the Bean.
protected  long getElapsedTimeMillis()
          Returns the elapsedTimeMillis property of the Bean.
 java.lang.String getMessage()
          Returns the message property of the Bean.
 java.lang.String getOrderId()
          Returns the orderId property of the Bean
 java.lang.String getOrderState()
          Returns the orderState property of the Bean.
 java.lang.String getOrderStatus()
          Returns the orderStatus property of the Bean.
 java.lang.String getPaymentState()
          Returns the paymentState property of the Bean.
 int getPrimaryRC()
          Returns the primary return code as returned from the Payment Manager QueryOrders command.
 int getSecondaryRC()
          Returns the secondary return code as returned from the Payment Manager QueryOrders command.
 java.lang.String getStoreId()
          Returns the storeId property of the Bean
 void populate()
          Populate the Bean Properties.
protected  void setCommonAVSCode(java.lang.String astrCommonAVSCode)
          Sets the commonAVSCode property of the Bean.
protected  void setElapsedTimeMillis(long anElapsedTimeMillis)
          Sets the elapsedTimeMillis property of the Bean.
protected  void setMessage(java.lang.String astrMessage)
          Sets the message property of the Bean.
protected  void setOrderId(java.lang.String astrOrderId)
          Sets the orderId property of the Bean
protected  void setOrderState(java.lang.String astrOrderState)
          Sets the orderState property of the Bean.
protected  void setOrderStatus(java.lang.String astrOrderStatus)
          Sets the orderStatus property of the Bean.
protected  void setPaymentNumber(java.lang.String astrPaymentNumber)
          Sets the paymentNumber property of the Bean.
protected  void setPaymentState(java.lang.String astrPaymentState)
          Sets the paymentState property of the Bean.
protected  void setPrimaryRC(int anPrimaryRC)
          Sets the primary return code as returned from the Payment Manager QueryOrders command.
protected  void setSecondaryRC(int anSecondaryRC)
          Sets the secondary return code as returned from the Payment Manager QueryOrders command.
protected  void setStoreId(java.lang.String astrStoreId)
          Sets the storeId property of the Bean
 

Constructor Detail

PayStatusPMDataBean

public PayStatusPMDataBean()
PayStatusPMDataBean default constructor.
Method Detail

getCommonAVSCode

public java.lang.String getCommonAVSCode()
Returns the commonAVSCode property of the Bean. The commonAVSCode property is the String representation of the the common AVS code set by the Payment Manager Cassette. The Payment Manager Cassette maps the payment service specific AVS Results Code returned by the Address Verification Services to the Payment Manager Framework defined common AVS code. Possible values for the common AVS Code are:
Returns:
the String representation of the the common AVS code set by the Payment Manager Cassette. If the Cassette does not use AVS, an empty String is returned.

getElapsedTimeMillis

protected long getElapsedTimeMillis()
Returns the elapsedTimeMillis property of the Bean. The elapsedTimeMillis property represents the elapsed time in milliseconds for the Payment Manager QueryOrders command to run and get the result back from the Payment Manager to populate this DataBean. It includes Network delay.
Returns:
the elapsed time in milliseconds for the Payment Manager QueryOrders command to run and get the results back from the Payment Manager to populate this DataBean. This may be zero if an error is detected before the Payment Manager QueryOrders command is issued.

getMessage

public java.lang.String getMessage()
Returns the message property of the Bean. The message property stores any message received during population of the Bean. It may be the empty String if no message has been received.
Returns:
any String message received during population of the DataBean or the empty String if no message has been received.

getOrderId

public java.lang.String getOrderId()
Returns the orderId property of the Bean
Returns:
the String representing the Reference Number of the Order.

getOrderState

public java.lang.String getOrderState()
Returns the orderState property of the Bean. The orderState property is a String representing the Payment Manager state of the order. Possible values are defined in the com.ibm.etill.frame.clientapi.PaymentCommandConstants interface. The constants defined for order state are:
Returns:
the String representing the Payment Manager state of the order. It may be the empty string if no order state is known by the Payment Manager or if an error occurred during the population of this DataBean.

getOrderStatus

public java.lang.String getOrderStatus()
Returns the orderStatus property of the Bean. The orderStatus property is a String representing the status of the order. Possible values are:
Returns:
the String representing the status of the order. It may be the empty string if an error occurred during the population of this DataBean.

getPaymentState

public java.lang.String getPaymentState()
Returns the paymentState property of the Bean. The paymentState property is a String representing the payment state of the order known by the Payment Manager. Possible values for the payment state are defined in the com.ibm.etill.frame.clientapi.PaymentCommandConstants interface. The constants defined for payment state are:
Returns:
the String representing the payment state of the order. It may be the empty string if there is no payment for the order or if an error occurred during the population of this DataBean. If there are more than one payment for an order then the payment state of one of the payments will be used if it is not PAYMENTSTATE_VOID. The value for the PAYMENTSTATE_VOID constant will be returned if and only if all the payments for the order have the payment state equals to the constant in PAYMENTSTATE_VOID.

getPrimaryRC

public int getPrimaryRC()
Returns the primary return code as returned from the Payment Manager QueryOrders command.
Returns:
the primary return code from the Payment Manager QueryOrders command or -1 if an error occurred before the QueryOrders command was issued.

getSecondaryRC

public int getSecondaryRC()
Returns the secondary return code as returned from the Payment Manager QueryOrders command.
Returns:
the secondary return code from the Payment Manager QueryOrders command or -1 if an error occurred before the QueryOrders command was issued.

getStoreId

public java.lang.String getStoreId()
Returns the storeId property of the Bean
Returns:
the String representing the Reference Number of the Store to which the order belongs.

populate

public void populate()
              throws java.lang.Exception
Populate the Bean Properties. This method is called by the DataBeanManager during DataBean activation.
Throws:
java.lang.Exception - The exception description.

setCommonAVSCode

protected void setCommonAVSCode(java.lang.String astrCommonAVSCode)
Sets the commonAVSCode property of the Bean.
Parameters:
astrCommonAVSCode - java.lang.String the String representation of the the common AVS code See also getCommonAVSCode() for additional information.

setElapsedTimeMillis

protected void setElapsedTimeMillis(long anElapsedTimeMillis)
Sets the elapsedTimeMillis property of the Bean. The elapsedTimeMillis property represents the elapsed time in milliseconds for the Payment Manager QueryOrders command to run and get the results back from the Payment Manager. It includes Network delay.
Parameters:
anElapsedTimeMillis - the elapsed time in milliseconds for the Payment Manager QueryOrders command to run and get the results back.

setMessage

protected void setMessage(java.lang.String astrMessage)
Sets the message property of the Bean. The message property stores any message received during population of the Bean. It may be null.
Parameters:
astrMessage - the String used to set the message property of the Bean.

setOrderId

protected void setOrderId(java.lang.String astrOrderId)
Sets the orderId property of the Bean
Parameters:
astrOrderId - the String representing the Reference Number of the Order

setOrderState

protected void setOrderState(java.lang.String astrOrderState)
Sets the orderState property of the Bean.
Parameters:
astrOrderState - the String representing the Payment Manager state of the order. See also getOrderState() for additional information.

setOrderStatus

protected void setOrderStatus(java.lang.String astrOrderStatus)
Sets the orderStatus property of the Bean.
Parameters:
astrOrderStatus - the single character String representing the status of the order. See also getOrderStatus() for additional information.

setPaymentNumber

protected void setPaymentNumber(java.lang.String astrPaymentNumber)
Sets the paymentNumber property of the Bean.
Parameters:
astrPaymentNumber - the String representing the payment number of the payment with payment state stored in the paymentState property of the Bean.

setPaymentState

protected void setPaymentState(java.lang.String astrPaymentState)
Sets the paymentState property of the Bean.
Parameters:
astrPaymentState - the String representing the payment state of the order known by the Payment Manager . See also getPaymentState() for additional information.

setPrimaryRC

protected void setPrimaryRC(int anPrimaryRC)
Sets the primary return code as returned from the Payment Manager QueryOrders command.
Parameters:
anPrimaryRC - the primary return code as returned from the Payment Manager QueryOrders command.

setSecondaryRC

protected void setSecondaryRC(int anSecondaryRC)
Sets the secondary return code as returned from the Payment Manager QueryOrders command.
Parameters:
anSecondaryRC - the secondary return code as returned from the Payment Manager QueryOrders command.

setStoreId

protected void setStoreId(java.lang.String astrStoreId)
Sets the storeId property of the Bean
Parameters:
astrStoreId - the String representing the Reference Number of the Store to which the order belongs.