All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface semper.payment.AccountBasedPurseServices

public interface AccountBasedPurseServices

extends Object

extends PurseServices

Version:

$Revision: 1.7 $ $Date: 1997/01/27 10:56:15 $

Author:

N. Asokan ([email protected])

See Also:

PaymentServices

authorise()

Request authorisation on a previously received raw payment for the entire amount proposed (as recorded in the corresponding TransactionRecord object) (TODO: we need to figure out what parameters we need)

authorise(Amount)

Request authorisation on a previously received raw payment.

capture()

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)

capture(Amount)

Capture a previously authorised payment.

multiAuthorise(Vector)

Request authorisation for a list of received payments.

multiCapture(Vector)

Capture a list of received and authorised payments.

receiveRawPayment(PaymentEntity, Amount, Vector, String)

Receive "the raw bits" related to an payment from payer but do translate it to a transfer of "real value." In other words, no authorise or capture on the received payment data; It is intended that the transaction record will be used in a subsequent capture request.

  public abstract void receiveRawPayment(PaymentEntity payer,
                                         Amount amount,
                                         Vector options,
                                         String ext_ref)

Receive "the raw bits" related to an payment from payer but do translate it to a transfer of "real value." In other words, no authorise or capture on the received payment data; It is intended that the transaction record will be used in a subsequent capture request. This is useful when a merchant wants to delay the capture, say until the end-of-day processing.

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

ext_ref - External reference string

Returns:

nothing

See Also:

authorise, capture, PaymentEntity, SecurityOption

  public abstract void multiAuthorise(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:

list_of_transaction_recs - a list of PaymentTransactionRecord objects.

Returns:

none

See Also:

receiveRawPayment

  public abstract void multiCapture(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:

list_of_transactions - a list of PaymentTransactionRecord objects.

Returns:

none

See Also:

receiveRawPayment, multiAuthorise, authorise

  public abstract void authorise(Amount amount)

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

Parameters:

amount - Amount to authorise

Returns:

nothing

See Also:

receiveRawPayment

  public abstract void authorise()

Request authorisation on a previously received raw payment for the entire amount proposed (as recorded in the corresponding TransactionRecord object) (TODO: we need to figure out what parameters we need)

Returns:

nothing

See Also:

receiveRawPayment

  public abstract void capture(Amount amount)

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

Parameters:

amount - Amount to capture

Returns:

nothing

See Also:

receiveRawPayment

  public abstract void capture()

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)

Returns:

nothing

See Also:

receiveRawPayment

All Packages  Class Hierarchy  This Package  Previous  Next  Index