All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface semper.payment.TAccountBasedPurseServices

public interface TAccountBasedPurseServices

extends Object

extends TPurseServices

Version:

$Revision: 1.3 $ $Date: 1997/01/27 10:56:39 $

Author:

N. Asokan ([email protected])

See Also:

PaymentServices, TPurseServices

startAuthorise(int)

Request authorisation on a previously received raw payment for the entire amount proposed (as recorded in the corresponding TransactionRecord object)

startAuthorise(int, Amount)

Request authorisation on a previously received raw payment.

startCapture(int)

Capture a previously authorised payment for the entire authorised amount (as recorded in the corresponding TransactionRecord object) (TODO: we need to figure out what parameters we need)

startCapture(int, Amount)

Capture a previously authorised payment.

startMultiAuthorise(int, Vector)

Request authorisation for a list of received payments.

startMultiCapture(int, Vector)

Capture a list of received and authorised payments.

startReceiveRawPayment(PaymentEntity, Amount, Vector, int, String)

Start receiving information related to an incoming payment from payer.

  public abstract void startReceiveRawPayment(PaymentEntity payer,
                                              Amount amount,
                                              Vector options,
                                              int role,
                                              String ext_ref)

Start receiving information related to an incoming payment from payer. Receive securely a bunch of information that would be used in the payment. Like the credit number, ... etc i.e. no authorise or capture on the received payment data; the PaymentTransaction object is not automatically destroyed at the end of this operation. authorise() and capture() methods can be invoked on this object later on.

Parameters:

payer - PaymentEntity Object containing necessary information to identify the origin of the payment

amount - The amount moved(if empty, this will be a return param)

options - List of SecurityOption objects

role - integer flag indicating the role of this player

ext_ref - External reference string

Returns:

nothing

See Also:

authorise, capture, PaymentEntity, SecurityOption

  public abstract void startMultiAuthorise(int role,
                                           Vector list_of_transaction_recs)

Request authorisation for a list of received payments. The "authorise" method handles only a single payment. Sometimes, it is is desirable to authorise in batch mode. This method can be used for the purpose of multi-authorisation. The input is a list of PaymentTransaction objects each of which has already been operated on by receiveRawPayment() method.

Parameters:

role - integer flag indicating the role of this player

list_of_transaction_recs - a list of PaymentTransactionRecord objects.

Returns:

none

See Also:

receiveRawPayment

  public abstract void startMultiCapture(int role,
                                         Vector list_of_transaction_recs)

Capture a list of received and authorised payments. The "capture" method handles only a single payment. Sometimes, it is is desirable to capture in batch mode. This method can be used for the purpose of multi-capture. The input is a list of PaymentTransaction objects created by previous invocations of the "receiveRawPayment" method. These objects must already have been operated on by a "authorise" method (or created by a previous "multiAuthorise" method)

Parameters:

role - integer flag indicating the role of this player

list_of_transactions - a list of PaymentTransactionRecord objects.

Returns:

none

See Also:

receiveRawPayment, multiAuthorise, authorise

  public abstract void startAuthorise(int role,
                                      Amount amount)

Request authorisation on a previously received raw payment. (@@ we need to figure out what parameters we need)

Parameters:

role - integer flag indicating the role of this player

amount - Amount to authorise

Returns:

nothing

See Also:

receiveRawPayment

  public abstract void startAuthorise(int role)

Request authorisation on a previously received raw payment for the entire amount proposed (as recorded in the corresponding TransactionRecord object)

Parameters:

role - integer flag indicating the role of this player (@@ we need to figure out what parameters we need)

Returns:

nothing

See Also:

receiveRawPayment

  public abstract void startCapture(int role,
                                    Amount amount)

Capture a previously authorised payment. (@@ we need to figure out what parameters we need)

Parameters:

role - integer flag indicating the role of this player

amount - Amount to capture

Returns:

nothing

See Also:

receiveRawPayment

  public abstract void startCapture(int role)

Capture a previously authorised payment for the entire authorised amount (as recorded in the corresponding TransactionRecord object) (TODO: we need to figure out what parameters we need)

Parameters:

role - integer flag indicating the role of this player

Returns:

nothing

See Also:

receiveRawPayment

All Packages  Class Hierarchy  This Package  Previous  Next  Index