initFollowUpAuthorisationCancel(final long, final CallerInformation) method

Syntax

long initFollowUpAuthorisationCancel ( final long authorisationId , final CallerInformation caller ) throws MobiliserServiceException, DataAccessException, TransactionException

Parameters

• authorisationId – the id of the authorization transaction that should be cancelled
• caller – the actor (authenticated user)

Returns

the id of the newly created authorization cancel transaction

Exceptions

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

Usage

Creates and initializes the

AuthorisationCancel

transaction in the database with the values from the

Authorisation

, performing various checks in the process. This action can be used if an authorization cancel must be performed based on some internal processes, and not based on an external service call.

Notes on transactional semantics:

If a business logic exception occurs, a

MobiliserServiceException

will be thrown which will trigger a rollback. Any other exception will also trigger a rollback of the database transaction.

the id of the newly created authorization cancel transaction