Using the Paystack Checkout in a Mobile WebView

When it comes to accepting payments with Paystack in your mobile applications, there are two ways to go about it:

1. Using the Paystack library built for your tech stack of choice - You can integrate Paystack directly into your Android or iOS app using our mobile SDK. For mobile frameworks like Ionic or React Native, please find the libraries here.
2. Using a WebView - You can also generate a checkout URL and embed it in a WebView on your mobile application. We'll be covering this option in this guide.

Why use a WebView?

There are different reasons to consider using the hosted checkout in a WebView over integrating directly with the mobile SDK. Regardless of which method you choose, the payments are still being processed by the same underlying APIs. The only difference is the payment experience you'll be offering to your customers. Some of the pros of using a WebView are:

1. By using our hosted checkout, the entire payment experience is controlled by Paystack. This means you don't have to build a checkout UI in your mobile application to accept payments, hence less code is required to integrate payments in your app.
2. While only card payments are available on the mobile SDK, all other non-card payment types - such as bank transfer, USSD, Visa QR, Mobile Money, and Pay-with-Bank - are available on the checkout, and therefore available to the customer.

Generating the checkout URL

The first step in the integration is to initialize the transaction to get a checkout URL.

When a customer clicks the payment action button, initialize a transaction by making a POST request from your server, to our API. Pass the email, amount, and any other optional parameters to the Initialize Transaction^API endpoint.

1curl https://api.paystack.co/transaction/initialize
2-H "Authorization: Bearer YOUR_SECRET_KEY"
3-H "Content-Type: application/json"
4-d '{ "email": "customer@email.com", "amount": "20000",
5    "callback_url":"https://hello.pstk.xyz/callback",
6    "metadata":{"cancel_action": "https://your-cancel-url.com"} 
7    }'
8-X POST

1{
2  "status": true,
3  "message": "Authorization URL created",
4  "data": {
5    "authorization_url": "https://checkout.paystack.com/nkdks46nymizns7",
6    "access_code": "nkdks46nymizns7",
7    "reference": "nms6uvr1pl"
8  }
9}

Displaying Checkout in Your WebView

If the API call is successful, Paystack will return an authorization URL in the response. This URL should be returned to the frontend application, and loaded in the Webview widget. See the sample code below:

1@override
2Widget build(BuildContext context) {
3  return Scaffold(
4    body: WebView(
5      initialUrl: 'https://checkout.paystack.com/7zu1ot06d0qn9h6',
6      javascriptMode: JavascriptMode.unrestricted,
7      userAgent: 'Flutter;Webview',
8    ),
9  );
10}

Once the checkout is loaded in the WebView, you'll need to listen for customer actions. That is, you'll want to know when the customer completes the payment or closes the checkout page. This can be done by listening for URL redirects in the WebView widget.

Handling WebView Redirects

When customers complete the payment successfully, they are redirected to the callback URL set in your Paystack dashboard. You can override this, however, by passing a callback_url when initializing the transaction. This will override the callback URL set on your dashboard, and the customer will be redirected there instead. The WebView widget should now look like this

1@override
2Widget build(BuildContext context) {
3  return Scaffold(
4    body: WebView(
5      initialUrl: 'https://checkout.paystack.com/7zu1ot06d0qn9h6',
6      javascriptMode: JavascriptMode.unrestricted,
7      userAgent: 'Flutter;Webview',
8      navigationDelegate: (navigation) {
9        //Listen for callback URL
10        if (navigation.url == "https://hello.pstk.xyz/callback") {
11          verifyTransaction(reference);
12          Navigator.of(context).pop(); //close webview
13        }
14        if (navigation.url == "https://your-cancel-url.com") {
15          //handle webview removal
16          Navigator.of(context).pop(); //close webview
17          //Run the cancel payment function if you have one
18        }
19        return NavigationDecision.navigate;
20      },
21    ),
22  );
23}
24

If you have webhooks implemented, a charge.success event will be sent to your webhook URL, and it's recommended you use this to deliver value to the customer in your backend.

In your frontend, after detecting the WebView redirect to the callback URL, this means the transaction is successful. You can confirm the status by calling the Verify Transaction^API, and then you can programmatically close the WebView widget and show the customer a transaction confirmation page in your app. This is handled in the verifyTransaction() method.

Handling 3DS properly

For card transactions that require 3DS authentication, when the customer completes the authorization, they're redirected to https://standard.paystack.co/close. Automatically, when the URL hits https://standard.paystack.co/close, it should close the page. This is what happens on a web browser.

With WebViews however, the page doesn't close automatically. This is because the Javascript function window.close(), which closes the page in a browser window, won't work on a WebView. WebViews are native widgets and the window.close() method can only close windows opened by using the window.open() method. The workaround is to have your WebView listen for when the URL has been redirected to  https://standard.paystack.co/close and then continue processing as usual by checking the callback function and any other process.

1@override
2Widget build(BuildContext context) {
3  return Scaffold(
4    body: WebView(
5    initialUrl: 'https://checkout.paystack.com/7zu1ot06d0qn9h6',
6    javascriptMode: JavascriptMode.unrestricted,
7    userAgent: 'Flutter;Webview',
8    navigationDelegate: (navigation){
9      if(navigation.url == 'https://standard.paystack.co/close'){
10        Navigator.of(context).pop(); //close webview
11      }
12      if(navigation.url == "https://hello.pstk.xyz/callback"){
13         Navigator.of(context).pop(); //close webview 
14      }
15      return NavigationDecision.navigate;
16    },
17  ),
18  );
19}