When registering your smartphone as a payment terminal with CheckoutX app (for example, using Tap to Pay on iPhone or Android), the registration may fail or get stuck in an infinite loading state if your device does not have a passcode, PIN, or other screen lock enabled.
Why This Happens
For security and PCI compliance reasons, the Surfboard Payments CheckoutX app requires that your smartphone has a secure screen lock in place before it can be registered as a payment terminal.
Without this, the registration cannot be completed — in some cases you will see a security-related error message, in others the process may just keep loading indefinitely.
How to Fix
On iPhone (iOS)
- Go to Settings → Face ID & Passcode (or Touch ID & Passcode).
- Tap Turn Passcode On.
- Choose a passcode and confirm it.
On Android
- Go to Settings → Security (or Lock Screen & Security, depending on your device).
- Tap Screen lock or Screen lock type.
- Choose PIN, Pattern, or Password and set it up.
Once you have set a secure lock on your phone, restart the registration process in the CheckoutX app.
Additional Notes
- This requirement applies to all smartphones being registered as payment terminals.
- Without a secure lock (passcode, PIN, pattern, password), registration will always fail or hang indefinitely.
- You can use biometrics (Face ID, Touch ID, fingerprint) alongside your passcode/PIN for convenience.