How do I release a Softpay terminal before reinstalling or configuring the app?
Releasing a Softpay terminal is an essential step to ensure its configuration or terminal ID (TID) can be reused for a new installation or reinstallation of the app. This guide explains why this process is important, provides step-by-step instructions, and offers troubleshooting tips for common issues.
Why is Releasing a Terminal Important?
Before deleting app data or reinstalling the Softpay app, you should release the terminal from within the app. If this step is skipped and the app data is deleted first, then when logging in again a new TID will be claimed for the new installation. In that case, releasing the original terminal can only be done via the onboarding API or by contacting support. To avoid this, always release the terminal in-app prior to any reinstallation or data deletion.
Step-by-Step Guide to Release a Terminal
To release a terminal and make its configuration/ID available for reuse:
Ensure you are using Softpay version 3.0 or higher.
Open the Softpay app.
Navigate to Settings → Release Terminal.
Confirm the release process.
Once the terminal is released, its configuration/ID will be available for use with a new installation of the Softpay app.
Troubleshooting Common Issues
If you encounter issues during terminal configuration, such as error code B.11400.1208, releasing the terminal config should resolve the problem. Ensure that the terminal is properly released before attempting to configure it again.
Additional Notes
Always release the terminal in-app before deleting app data or reinstalling the app.
If the terminal is not released in-app, support intervention or the onboarding API will be required to release it.
By following these steps, you can ensure a smooth process for reusing terminal configurations and avoid unnecessary complications.