Webview integration

This guide is intended for use with any of the following flows:

In the examples below, easypolUrl refers to the URL returned in the response of that request.

The examples are for a Swift- or Kotlin-based application, but equivalent APIs can be used with other technologies or frameworks.

Runnable example apps are available here: https://gitlab.com/easypol/embedded-webview-example

iOS Setup

Permissions

The Easypol webapp may request access to the camera to allow the user to scan their payment notice codes. Add a camera usage description to Info.plist:

<key>NSCameraUsageDescription</key>
<string>This app requires access to the camera.</string>

iOS displays this text in the system permission prompt. Without this key, camera access from the WebView may fail or cause a crash when requested.

WebView Configuration

Use WKWebView and enable JavaScript. The scrollview configuration is optional and may be adapted to suit the layout requirements of the webview host.

Android Setup

Permissions

Declare camera support and the related permission:

<uses-feature
    android:name="android.hardware.camera"
    android:required="false" />

<uses-permission android:name="android.permission.CAMERA" />

WebView Configuration

Use a standard Android WebView with the following settings:

Add the following parts to the existing WebView host, if equivalent implementations are not already present.

Handle browser features required by the WebView, including camera access and file upload fields:

Forward downloads to the native Android download manager:

Load the url:

iOS Setup#

Permissions#

WebView Configuration#

Android Setup#

Permissions#

WebView Configuration#

iOS Setup

Permissions

WebView Configuration

Android Setup

Permissions

WebView Configuration