Skip to main content

Back Press Handling on Payment Screen

Back Press Handling on Payment Screen

SDK Update – Handling Back Navigation for Seamless Transaction Continuity

Purpose

This document outlines an enhancement in our SDK to address navigation issues related to PSPI in Android (Single Activity Stack) and iOS applications.

Background

  1. Currently, when customers reach the bank's payment screen and press the back button they bank's application do the following redirections
    1. Redirect customer to bank's application home screen
    2. Redirect customer to Nuclei SDK order detail page with Payment Failure status
  2. This redirection behavior leads to customer drop-offs, as the complete transaction journey must be restarted again.

Update Summary

  • To improve customer retention and transaction completion rates, we have introduced a method in the SDK that partners can invoke on back navigation from the payment screen.
  • This method ensures users are redirected to the Nuclei SDK Order Review Screen, allowing customers to resume the journey without restarting the flow.

Integration Steps

Android

Available from SDK version 9.0.2-RELEASE

Override the onBackPressed() method in your payment screen and include the following call :

@Override
public void onBackPressed() {
super.onBackPressed();
// Redirect to Cart Review Screen
SampleApplication.getNucleiSDK().openLastNucleiScreen();
}

iOS - This method is only available from 8.2.0

// In the payment page, call this method
do {
try CoreAdapterSetup.didFinishPayment(mode, status: .canceled)
} catch let error {
print(error)
}

Implement this change in your Bank application to ensure a seamless user experience and minimize drop-offs.

For any discussions contact support@gonuclei.com