All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class semper.commerce.PaymentTransaction

java.lang.Object
   |
   +----semper.commerce.Transaction
           |
           +----semper.commerce.PaymentTransaction

public class PaymentTransaction
extends Transaction
This class ecapsulates all payment transaction information and is based on the SEMPER core payment service. In addition to the payment information (amount, currency etc) the transaction also contains a free format textual description that is signed.

Version:
$Id: PaymentTransaction.java,v 1.12 1998/08/27 09:47:52 semper Exp $
Author:
Rolf Michelsen, Stig Mj°lsnes
See Also:
GenericTransaction, StatementTransaction

Constructor Index

 o PaymentTransaction(ActiveDeal, Transaction, Payment)
Creates a payment transaction that can later be requested.

Method Index

 o getPayment()
Returns information about the payment.
 o makeDescription()
Returns a generic payment transaction description.
 o request(AccessControlHandle)
Requests a payment transaction.

Constructors

 o PaymentTransaction
 public PaymentTransaction(ActiveDeal deal,
                           Transaction ref,
                           Payment payment) throws AssociationException, TransactionException
Creates a payment transaction that can later be requested. A payment transaction contains payment information in addition to the attributes of any transaction.

A transaction can reference another transaction in the same deal. A transaction that does not reference another transaction is considered a top level transaction in the deal.

Parameters:
deal - The deal containing this transaction.
ref - The transaction referenced by this transaction or null for a top level transaction.
payment - Information about the payment.
Throws: AssociationException
Thrown if the transaction cannot be created because of problems with the association with the peer.
Throws: TransactionException
Thrown if the transaction cannot be created for some other reason.

Methods

 o makeDescription
 public Description makeDescription()
Returns a generic payment transaction description. This description will be displayed and authorised or acknowledged by the user. Business applications should provide a specialised version of this method to provide more detailed information about the transaction.

This method is invoked by the commerce layer when it needs to get a description of the transaction.

Returns:
A description of the transaction.
Overrides:
makeDescription in class Transaction
 o getPayment
 public Payment getPayment()
Returns information about the payment.

Returns:
Payment information for this transaction.
 o request
 public synchronized void request(AccessControlHandle ach) throws AssociationException, TransactionException
Requests a payment transaction. This transaction request will result in a corresponding transaction indication to the peer. This is an unconfirmed service, and successful invocation of this method does not confirm that the transaction is successfull or even that it has taken place. Use the method requestStatus to inquire about the status of a transaction.

Payment transactions must be authorised by the user unless the application requesting the payment possesses a suitable access control capability. A null access control handle can be specified by untrusted applications.

Note that this method can be overloaded by subclasses. An application must not pass access control capabilities to this method if an untrusted subclass might have overloaded this method.

Parameters:
ach - Any access control handle or null.
Throws: AssociationException
Thrown if something wrong with the assication prevents the transaction request.
Throws: TransactionException
Thrown if something is wrong with the transaction object. Will be thrown if the transaction has already been requested.
Overrides:
request in class Transaction

All Packages  Class Hierarchy  This Package  Previous  Next  Index