tech.paycon.sdk.v5

Class PCOperationsManager

java.lang.Object

tech.paycon.sdk.v5.PCOperationsManager

public class PCOperationsManager
extends java.lang.Object

This class aimed at processing operations (grouped transactions) represented by objects of PCOperation class.

Method Summary

Modifier and Type	Method and Description
static void	confirmEntireOperation(PCUser user, PCOperation operation, PCProcessOperationCallback callback) Confirms each transaction in the operation.
static void	confirmEntireOperationWithExtAuth(PCUser user, PCOperation operation, PCExtendedAuth extAuth, PCProcessOperationCallback callback) Confirms each transaction in the operation using extended authentication.
static void	declineEntireOperation(PCUser user, PCOperation operation, PCProcessOperationCallback callback) Declines each transaction in the operation.
static void	declineEntireOperationWithExtAuth(PCUser user, PCOperation operation, PCExtendedAuth extAuth, PCProcessOperationCallback callback) Declines each transaction in the operation using extended authentication.
static void	getOperation(PCUser user, java.lang.String operationId, PCGetOperationCallback callback) Gets operation data from PCSDK Server
static void	getOperationList(PCUser user, PCListOperationsCallback callback) Gets list of operations identifiers from PCSDK Server
static PCOperation	importOperation(java.lang.String operationJson) Imports operation from server response
static void	processOperation(PCUser user, PCOperation operation, java.util.List<PCTransaction> transactionsToConfirm, java.util.List<PCTransaction> transactionsToDecline, PCProcessOperationCallback callback) Processes the operation by specifying which transactions must be confirmed and which transactions must be declined.
static void	processOperationWithExtAuth(PCUser user, PCOperation operation, java.util.List<PCTransaction> transactionsToConfirm, java.util.List<PCTransaction> transactionsToDecline, PCExtendedAuth extAuth, PCProcessOperationCallback callback) This method processes an operation similarly to processOperation(PCUser, PCOperation, List, List, PCProcessOperationCallback) but PCExtendedAuth is additionally used.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getOperationList

public static void getOperationList(PCUser user,
                                    PCListOperationsCallback callback)

Gets list of operations identifiers from PCSDK Server

Parameters:

user - Target PCUser object

callback - PCGetOperationCallback for handling results

getOperation

public static void getOperation(PCUser user,
                                java.lang.String operationId,
                                PCGetOperationCallback callback)

Gets operation data from PCSDK Server

Parameters:

user - Target PCUser object

operationId - Operation identifier

callback - PCGetOperationCallback for handling results

processOperation

public static void processOperation(PCUser user,
                                    PCOperation operation,
                                    java.util.List<PCTransaction> transactionsToConfirm,
                                    java.util.List<PCTransaction> transactionsToDecline,
                                    PCProcessOperationCallback callback)

Processes the operation by specifying which transactions must be confirmed and which transactions must be declined.
Each transaction in transactionsToConfirm or transactionsToDecline must be the reference to one of transactions returned by PCOperation.getTransactions(). If some other transaction is passed, the operation will not be processed and error of type PCError.PC_ERROR_ALIEN_TRANSACTION_IN_OPERATION will be returned trough the callback.
Either transactionsToConfirm or transactionsToDecline might be null or empty (if no transactions are to be confirmed or declined) but not both. If no transactions were passed in both list, the error of type PCError.PC_ERROR_MISS_TRANSACTIONS_TO_PROCESS will be passed to callback.
Params transactionsToConfirm and transactionsToDecline must not intersect (contain same transactions). If so, the error of type PCError.PC_ERROR_INVALID_METHOD_USAGE will arise.
If the key is protected with password, it must be submitted before processing operation, otherwise PCError.PC_ERROR_USER_NOT_READY_TO_SIGN is passed to callback.
Also, make sure that for each transaction which contains binary data, it is downloaded before processing an operation. If at least one transaction misses it's binary data, the error of type PCError.PC_ERROR_TRANSACTION_BINARY_DATA_IS_REQUIRED will arise and the whole operation will be prevented from further processing.
Refer to PCProcessOperationCallback to find out which types of errors can occur at different moments and how they should be handled.

Parameters:

user - Target PCUser

operation - Target PCOperation to be processed

transactionsToConfirm - List of PCTransaction to be confirmed

transactionsToDecline - List of PCTransaction to be declined

callback - PCProcessOperationCallback to handle results

confirmEntireOperation

public static void confirmEntireOperation(PCUser user,
                                          PCOperation operation,
                                          PCProcessOperationCallback callback)

Confirms each transaction in the operation. It is equal to calling processOperation(user, operation, operation.getTransactions(), null, callback).

Parameters:

user - Target PCUser

operation - Target PCOperation to be entirely confirmed

callback - PCProcessOperationCallback to handle results

See Also:

processOperation(PCUser, PCOperation, List, List, PCProcessOperationCallback)}

declineEntireOperation

public static void declineEntireOperation(PCUser user,
                                          PCOperation operation,
                                          PCProcessOperationCallback callback)

Declines each transaction in the operation. It is equal to calling processOperation(user, operation, null, operation.getTransactions(), callback).

Parameters:

user - Target PCUser

operation - Target PCOperation to be entirely declined

callback - PCProcessOperationCallback to handle results

See Also:

processOperation(PCUser, PCOperation, List, List, PCProcessOperationCallback)}

processOperationWithExtAuth

public static void processOperationWithExtAuth(PCUser user,
                                               PCOperation operation,
                                               java.util.List<PCTransaction> transactionsToConfirm,
                                               java.util.List<PCTransaction> transactionsToDecline,
                                               PCExtendedAuth extAuth,
                                               PCProcessOperationCallback callback)

This method processes an operation similarly to processOperation(PCUser, PCOperation, List, List, PCProcessOperationCallback) but PCExtendedAuth is additionally used.

Parameters:

user - Target PCUser

operation - Target PCOperation to be processed

transactionsToConfirm - List of PCTransaction to be confirmed

transactionsToDecline - List of PCTransaction to be declined

extAuth - PCExtendedAuth object for external authentication

callback - PCProcessOperationCallback to handle results

See Also:

processOperation(PCUser, PCOperation, List, List, PCProcessOperationCallback)

confirmEntireOperationWithExtAuth

public static void confirmEntireOperationWithExtAuth(PCUser user,
                                                     PCOperation operation,
                                                     PCExtendedAuth extAuth,
                                                     PCProcessOperationCallback callback)

Confirms each transaction in the operation using extended authentication. It is equal to calling processOperationWithExtAuth(user, operation, operation.getTransactions(), null, extAuth, callback).

Parameters:

user - Target PCUser

operation - Target PCOperation to be entirely confirmed

extAuth - PCExtendedAuth object for external authentication

callback - PCProcessOperationCallback to handle results

See Also:

processOperationWithExtAuth(PCUser, PCOperation, List, List, PCExtendedAuth, PCProcessOperationCallback)

declineEntireOperationWithExtAuth

public static void declineEntireOperationWithExtAuth(PCUser user,
                                                     PCOperation operation,
                                                     PCExtendedAuth extAuth,
                                                     PCProcessOperationCallback callback)

Declines each transaction in the operation using extended authentication. It is equal to calling processOperationWithExtAuth(user, operation, null, operation.getTransactions(), extAuth, callback).

Parameters:

user - Target PCUser

operation - Target PCOperation to be entirely declined

extAuth - PCExtendedAuth object for external authentication

callback - PCProcessOperationCallback to handle results

See Also:

processOperation(PCUser, PCOperation, List, List, PCProcessOperationCallback)}

importOperation

public static PCOperation importOperation(java.lang.String operationJson)

Imports operation from server response

Parameters:

operationJson - Server response in JSON format

Returns:

PCOperation or null if operation cannot be imported from given JSON