Skip to main content

How can I troubleshoot common issues with Softpay integration on Android and Cloud API?

How to Troubleshoot Common Issues with Softpay Integration on Android and Cloud API

Softpay integration issues can arise due to app settings or incorrect API configurations. This article provides solutions to common problems encountered when using Softpay with AppSwitch on Android or Cloud API.

Common Issues with Softpay Integration

1. Softpay Fails to Open via AppSwitch on Android

Intermittent failures to open Softpay via AppSwitch may occur if Android places the Softpay app into hibernation or a paused state. This is particularly common on devices running Android 13 or later. When hibernated, the app may not be discoverable or switchable.

Steps to Fix:

  1. Open the Android Settings on your device.

  2. Navigate to the Softpay app settings.

  3. Go to Permissions or App Info → App Battery/Permissions Settings.

  4. Disable the setting that hibernates or pauses unused apps. This setting may be labeled as: - "Manage app if unused" - "Remove permissions and free up space" - Similar wording depending on your Android version.

After disabling this setting, Softpay should be discoverable and open reliably via AppSwitch.

2. App Does Not Resume After a Softpay Transaction (Switch-Back) Using Cloud API

When using the Cloud API, issues with app resumption after a Softpay transaction can occur if the activityToResume parameter is defined in multiple places. Softpay uses this parameter to fire the resume intent upon transaction completion, and defining it twice can cause conflicts.

Steps to Fix:

  1. Set the activityToResume parameter in only one place: - Either in the REST request. - Or in the intent call.

  2. Ensure your request payload uses the correct, case-sensitive field names. For example: - Use options instead of Options.

By following these steps, you can prevent conflicts and ensure seamless app resumption.

Additional Tips for Ensuring Seamless Functionality

  • Regularly check your app settings to ensure compatibility with the latest Android updates.

  • Review API documentation to confirm correct parameter usage and field naming conventions.

Related Topics

  • Setting up Softpay in Sandbox Environment

  • Best Practices for AppSwitch Integration

  • Troubleshooting API Errors in Softpay

By following these troubleshooting steps and best practices, you can resolve common issues and ensure a smooth experience with Softpay integration.

Did this answer your question?