com.wallee.android.sdk.view.form

Interface PaymentFormView

All Superinterfaces:

PersistableView

All Known Implementing Classes:

DefaultPaymentFormView

public interface PaymentFormView
extends PersistableView

The payment form view is responsible for loading and triggering the form which collects the payment details such as card numbers etc. The form is implemented in a generic way so it does not matter what kind of payment method it is. The form has to handle the specifics of a particular payment method. To achieve this generic implementation a WebView is used which loads the form from a remote server.

The view is also responsible for handling redirects to external payment processors such as online banking service or any other service which requires the user to enter information details on a dedicated web site. Therefore the PaymentFormView.Listener.onEnlargeView(View) will be triggered when more space is required. Further the view is also responsible to resize itself to the size which is required by the form within the view. So that the view will not require within it a scrollbar. If the form does not have enough space the view within which this view is placed in should add scrollbars.

The styling of the form itself can be done through the backend of wallee. There is a resource editor which allows to adjust the layout to the required styling of the app.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	PaymentFormView.Listener<T extends android.view.View & PaymentFormView> The listener is used to communicate back to the invoker of the view what is going on within the view.

Method Summary

Modifier and Type	Method and Description
int	getCurrentTargetHeight() The height of the view may change depending on the user input.
boolean	isSubmitted() The form can be submitted through submit().
void	submit() This method submits the form content.
void	validate() This method validates the form content.

Methods inherited from interface com.wallee.android.sdk.view.PersistableView

restoreViewState, saveViewState

Method Detail

getCurrentTargetHeight

int getCurrentTargetHeight()

The height of the view may change depending on the user input. The target height indicates how height the view should be means this is the calculated height which is expected based up on the content of the view. The actual view height may be slightly different.

Returns:

the current target height in dp.

isSubmitted

boolean isSubmitted()

The form can be submitted through submit(). The method will return false as long as the submit method was not invoked.

Returns:

true when the form within the view has been submitted.

validate

void validate()

This method validates the form content. This may trigger some network communication. The result of the validation will be communicated through the PaymentFormView.Listener.

This method should be invoked before submit() to give the user a chance to fix the input.

If there are inputs which are not valid (for example wrong format) the corresponding fields get highlighted and an error message is shown along the field.

submit

void submit()

This method submits the form content. This may trigger further page loads. The result of the submit will be communicated through the PaymentFormView.Listener.