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	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, PCKeysProcessor keysProcessor, PCExtendedAuth extAuth, PCProcessOperationCallback callback) This method processes an operation similarly to processOperation(PCUser, PCOperation, List, List, PCProcessOperationCallback) but PCExtendedAuth is additionally used.
static void	processOperation(PCUser user, PCOperation operation, java.util.List<PCTransaction> transactionsToConfirm, java.util.List<PCTransaction> transactionsToDecline, PCKeysProcessor keysProcessor, 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().
static void	processOperation(PCUser user, PCOperation operation, java.util.List<PCTransaction> transactionsToConfirm, java.util.List<PCTransaction> transactionsToDecline, PCProcessOperationCallback callback) Processes an operation using PCRegularKeysProcessor.

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 an operation using PCRegularKeysProcessor.

See Also:

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

processOperation

public static void processOperation(PCUser user,
                                    PCOperation operation,
                                    java.util.List<PCTransaction> transactionsToConfirm,
                                    java.util.List<PCTransaction> transactionsToDecline,
                                    PCKeysProcessor keysProcessor,
                                    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

keysProcessor - Keys processor for calculating confirmation/declination codes and signatures. For default processing PCRegularKeysProcessor.getInstance() should be passed.

callback - PCProcessOperationCallback to handle results

processOperation

public static void processOperation(PCUser user,
                                    PCOperation operation,
                                    java.util.List<PCTransaction> transactionsToConfirm,
                                    java.util.List<PCTransaction> transactionsToDecline,
                                    PCKeysProcessor keysProcessor,
                                    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

keysProcessor - Target keys processor

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