org.cyclos.services.banking

Interface TransactionAuthorizationService

All Superinterfaces:

Service

All Known Subinterfaces:

TransactionAuthorizationServiceLocal

All Known Implementing Classes:

TransactionAuthorizationServiceSecurity

public interface TransactionAuthorizationService
extends Service

Service interface for transaction authorizations.
It allow authorize, deny etc a transaction and search for transactions to authorize and already authorized.

Author:

luis, rinke

Method Summary

Modifier and Type	Method and Description
PaymentAuthorizationLevelData	authorize(@NotNull TransactionAuthorizationDTO transferAuthorizationDto) Authorizes a payment pending authorization
void	cancel(@NotNull TransactionAuthorizationDTO transferAuthorizationDto) Cancels a payment pending authorization
void	deny(@NotNull TransactionAuthorizationDTO transferAuthorizationDto) Denies a payment pending authorization

Method Detail

authorize

PaymentAuthorizationLevelData authorize(@NotNull
                                        @NotNull TransactionAuthorizationDTO transferAuthorizationDto)
                                 throws TransferException,
                                        FrameworkException,
                                        IllegalActionException

Authorizes a payment pending authorization

Returns:

The next level, if any, or null if authorized

Throws:

IllegalActionException - The payment is not on a state which can be authorized or was already authorized by the logged user, even if it would be possible (through multiple roles) to authorize again

TransferException

FrameworkException

cancel

void cancel(@NotNull
            @NotNull TransactionAuthorizationDTO transferAuthorizationDto)
     throws FrameworkException,
            IllegalActionException

Cancels a payment pending authorization

Throws:

IllegalActionException - The payment is not on a state which can be canceled, or is part of a scheduled payment (instead, the entire scheduled payment should be canceled)

FrameworkException

deny

void deny(@NotNull
          @NotNull TransactionAuthorizationDTO transferAuthorizationDto)
   throws FrameworkException,
          IllegalActionException

Denies a payment pending authorization

Throws:

IllegalActionException - The payment is not on a state which can be denied

FrameworkException