Syntax
void
doAuthorisationCancel
(
final long
authCancelId
,
final List< IKeyValue >
unstructuredDataRequest
,
final List< IKeyValue >
unstructuredDataResponse
,
final Long
actorId
,
final Integer
mainTxnErrorCode
) throws MobiliserServiceException, DataAccessException, TransactionException
Parameters
-
authCancelId –
the id of the transaction whose authorization should be cancelled
-
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)
-
mainTxnErrorCode –
the error code with which the main transaction must be failed. If null, the main transaction must not be failed.
Exceptions
-
MobiliserServiceException –
if canceling the authorization for 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 authorization cancel for the given authorization transaction.
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
AuthorisationCancel
transaction will be failed. Any other exception will trigger a rollback of the database transaction followed by a fresh transaction inside of which the
AuthorisationCancel
transaction will be marked with an error code.