com.adyen.threeds2

Interface ChallengeStatusReceiver

public interface ChallengeStatusReceiver

A callback object that implements this interface will receive challenge status notifications from the 3DS SDK. This receiver object may be notified through various methods. Depending on the result of the challenge process, the App may display a message or redirect the Cardholder to a screen in the App.

Created by Ran Haveshush on 24/08/2018.

Method Summary

Modifier and Type	Method and Description
void	cancelled() This method will be called when the Cardholder selects the option to cancel the transaction on the challenge screen. The 3DS SDK will end the challenge flow before sending notification about the cancelled event to the App.
void	completed(CompletionEvent completionEvent) This method will be called when the challenge process is completed. When a transaction is completed, the transaction status shall be available.
void	protocolError(ProtocolErrorEvent protocolErrorEvent) This method will be called when the 3DS SDK receives an error message form the ACS. The 3DS SDK sends the error code and details from this error message as part of the notification to the App. The 3DS SDK will end the challenge flow before sending notification about the Protocol Error event to the App.
void	runtimeError(RuntimeErrorEvent runtimeErrorEvent) This method will be called when the 3DS SDK encounters errors during the challenge process. The 3DS SDK will end the challenge flow before sending notification about the Runtime Error event to the App.
void	timedout() This method will be called when the challenge process reaches or exceeds the timeout specified in the call for Transaction.doChallenge(Activity, ChallengeParameters, ChallengeStatusReceiver, int). The SDK will stop and end the challenge flow as soon as possible before sending notification about the timed out event to the App.

Method Detail

completed

void completed(CompletionEvent completionEvent)

This method will be called when the challenge process is completed.
When a transaction is completed, the transaction status shall be available.

Parameters:

completionEvent - The CompletionEvent represents information about the challenge process completion.

cancelled

void cancelled()

This method will be called when the Cardholder selects the option to cancel the transaction on the challenge screen.
The 3DS SDK will end the challenge flow before sending notification about the cancelled event to the App.

Notice: The App should invoke the Transaction.close() method to close the Transaction object properly,
and display subsequent screens after it receives notification about the cancelled event.

timedout

void timedout()

This method will be called when the challenge process reaches or exceeds the timeout specified in the call for Transaction.doChallenge(Activity, ChallengeParameters, ChallengeStatusReceiver, int).
The SDK will stop and end the challenge flow as soon as possible before sending notification about the timed out event to the App.

Notice: The App should invoke the Transaction.close() method to close the Transaction object properly,
and display subsequent screens after it receives notification about the cancelled event.

protocolError

void protocolError(ProtocolErrorEvent protocolErrorEvent)

This method will be called when the 3DS SDK receives an error message form the ACS.
The 3DS SDK sends the error code and details from this error message as part of the notification to the App.
The 3DS SDK will end the challenge flow before sending notification about the Protocol Error event to the App.

In the 3DS SDK context, a protocol error is any error message that is returned by the ACS.

Notice: The App should invoke the Transaction.close() method to close the Transaction object properly,
and display subsequent screens after it receives notification about the cancelled event.

Parameters:

protocolErrorEvent - The ProtocolErrorEvent contains the protocol error code and details.

runtimeError

void runtimeError(RuntimeErrorEvent runtimeErrorEvent)

This method will be called when the 3DS SDK encounters errors during the challenge process.
The 3DS SDK will end the challenge flow before sending notification about the Runtime Error event to the App.

In the 3DS SDK context, a runtime error is any error encounter during the challenge process.

Notice: The App should invoke the Transaction.close() method to close the Transaction object properly,
and display subsequent screens after it receives notification about the cancelled event.

Parameters:

runtimeErrorEvent - The RuntimeErrorEvent contains the runtime error code and details.