initFollowUpCapture(final Long, final CallerInformation) method

Syntax

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

Parameters

• authorisationId – the id of the authorization transaction to used to initialize the capture transaction
• caller – the actor (authenticated user)

Returns

the id of the newly created capture transaction

Exceptions

• MobiliserServiceException – if initializing 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

Creates and initializes the

Capture

transaction in the database with the values from the

Authorisation

, performing various checks in the process. This action can be used if a capture must be performed based on some internal processes, and not based on an external service call, e.g. for auto-capture.

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 capture transaction