doPreAuthorisation(final Long, final List< IKeyValue >, final List< IKeyValue >, final Long) method

Syntax

void doPreAuthorisation ( final Long authId , final List< IKeyValue > unstructuredDataRequest , final List< IKeyValue > unstructuredDataResponse , final Long actorId ) throws MobiliserServiceException, DataAccessException, TransactionException

Parameters

• authId – the id of the transaction to pre-authorize
• unstructuredDataRequest – the unstructured data coming from the original request
• unstructuredDataResponse – this list can be filled with information to be returned with the response
• actorId – the actorId (authenticated user)

Exceptions

• MobiliserServiceException – if pre-authorizing the transaction fails for some reason (business rules)
• DataAccessException – if some error occurs communicating / writing / reading persistent storage
• TransactionException – if some error occurs while handling the transactions related to persistent storage

Usage

Perform the actual pre-authorization for the given authorization transaction in initial state

Notes on transactional semantics:

If a business logic exception occurs, a

MobiliserServiceException

will be thrown and the database transaction committed. If the the cause stems from the underlying payment handler, both the main

Transaction

and the

Authorisation

transaction will be failed. Any other exception will trigger a rollback of the database transaction followed by a fresh transaction inside of which the

Authorisation

transaction will be marked with an error code.