tech.paycon.sdk.v5.utils

Interface PCProcessOperationCallback

All Superinterfaces:

PCTaskCallback

public interface PCProcessOperationCallback
extends PCTaskCallback

Callback for handling results from PCOperationsManager.processOperation(PCUser, PCOperation, List, List, PCProcessOperationCallback) and related methods. While processing an operation one of the following scenarios may appear:

1. Some error occurred even before interacting with server: error(PCError) is invoked
2. An error occurred when interacting with the server (e.g. connection timeout exceeded, authorization failed etc.): error(PCNetError) is invoked.
3. Interaction with server was successful, but not all transactions were successfully processed: error(PCOperation, HashMap) is invoked.
4. The whole passed set of transactions was successfully processed: success(PCOperation) invoked.

See Also:

PCOperationsManager.processOperation(PCUser, PCOperation, List, List, PCProcessOperationCallback), PCOperationsManager.confirmEntireOperation(PCUser, PCOperation, PCProcessOperationCallback), PCOperationsManager.declineEntireOperation(PCUser, PCOperation, PCProcessOperationCallback)

Method Summary

Modifier and Type	Method and Description
void	error(PCError error) An error which occurred before the interaction with server (e.g. passowrd is required but was not submitted)
void	error(PCNetError error) An error which indicates that the connection with server was failed (e.g. internet connection stopped or authorization failed)
void	error(PCOperation operation, java.util.HashMap<java.lang.String,PCNetError> failedTransactions) An error pointing at the case when the request is successful but some of transactions (possibly, all) were not processed due to some reason.
void	success(PCOperation operation) Called when all passed transactions were successfully processed

Methods inherited from interface tech.paycon.sdk.v5.utils.PCTaskCallback

onTaskCancelled, onTaskCreated

Method Detail

success

void success(PCOperation operation)

Called when all passed transactions were successfully processed

Parameters:

operation - The processed operation with rest of transactions which remain to be confirmed or declined. If all transactions were processed, the operation with empty list of transactions is returned

error

void error(PCError error)

An error which occurred before the interaction with server (e.g. passowrd is required but was not submitted)

Parameters:

error - PCError of corresponding type

error

void error(PCNetError error)

An error which indicates that the connection with server was failed (e.g. internet connection stopped or authorization failed)

Parameters:

error - PCNetError of corresponding type

error

void error(PCOperation operation,
           java.util.HashMap<java.lang.String,PCNetError> failedTransactions)

An error pointing at the case when the request is successful but some of transactions (possibly, all) were not processed due to some reason. Then the hash map contains pairs of type transaction id -> corresponding error. Although the each transaction might be failed to process due to a unique reason, commonly you will get the one reason for all failed transactions (like confirmation code was wrong because of transaction data is corrupted). Normally this type of error must not happen if all methods are called in appropriate way.

Parameters:

operation - The processed operation with rest of transactions which remain to be confirmed or declined. If all transactions were processed, the operation with empty list of transactions is returned

failedTransactions - Map of transaction ids and corresponding errors occurred while processing