Error Codes

Some time an error occurs while using our service. Listed below the most occurrence of the error.
4000
Reason
Unhandled error or internal server error, happens when unexpected behaviour by Nearpay end or bank
Error Message
Unexpected Error
Solution Message
Contact your manager or technical provider
4001
Reason
Vendor doesn't exist
Error Message
Vendor does not exist
Solution Message
Contact your manager or technical provider
4002
Reason
Terminal does not exist
Error Message
Terminal does not exist
Solution Message
Contact your manager or technical provider for a Terminal ID
4003
Reason
Terminal is updating
Error Message
Please wait, terminal is updating
Solution Message
Wait until the terminal finish the update.
4004
Reason
Terminal is reconcile
Error Message
Please wait, terminal is reconciling
Solution Message
Terminal Reconciled
4005
Reason
App Version (Payment Plugin) is not Supported. 
Error Message
Unsupported Version
Solution Message
Your App Version is not Supported. Contact your manager or technical provider
4006
Reason
Client not found
Error Message
Client not found
Solution Message
Create a client or choose an exsing one
4007
Reason
Authorization error, user has to login again
Error Message
Authentication error
Solution Message
Please login again
4008
Reason
Client has to send domain name along with the request
Error Message
Domain not found
Solution Message
Contact your manager or technical service provider
4009
Reason
When terminal configuration not found
Error Message
Terminal configuration needs to be updated
Solution Message
Contact your manager or technical service provider
4010
Reason
Client and merchant when creating a user
Error Message
Merchant not found
Solution Message
Contact your manager or technical provider
4011
Reason
User tries to login when they have no access to a specific merchant
Error Message
You do not have access on this merchant
Solution Message
Contact your manager for access
4012
Reason
Package name not found
Error Message
Package name not found
Solution Message
Add the package name through the admin dashboard
4013
Reason
When the user type invalid username or password in the dashboard
Error Message
Invalid Username or Password
Solution Message
Enter the correct username or password
4014
Reason
When the admin or user that has been invited and still doesn't have a password
Error Message
Password not found
Solution Message
Rest the password
4015
Reason
Admin they don't have access to a specific client anymore
Error Message
You do not have access to this client
Solution Message
Contact your manager for access
4016
Reason
Your email is not registered in our system
Error Message
Email doesn't exist
Solution Message
Your email is not registered in our system , please contact your admin to register it
4017
Reason
When the user tries to enter wrong input sevral times
Error Message
Maximum number of login attempts reached
Solution Message
Try to login again after 10 minutes
4018
Reason
Client Dashboard when logging in
Error Message
User not found
Solution Message
Contact your manager to add you as a user
4019
Reason
When data missing in request
Error Message
Mandatory fields missing
Solution Message
Fill in the mandatory fields and try again
4020
Reason
When the client tries to create a new package that already exists
Error Message
Package already exists
Solution Message
Add a different package name
4021
Reason
SDK or package version
Error Message
Unsupported Version
Solution Message
Your App Version is not Supported. Contact your manager or technical provider
4022
Reason
Duplicant entry
Error Message
Already exists
Solution Message
Enter different credentials and try again
4023
Reason
Incorrect OTP entered
Error Message
Incorrect OTP entered
Solution Message
Enter the correct OTP and try again
4024
Reason
Incorrect email entered
Error Message
Incorrect email entered
Solution Message
Enter the correct email and try again
4025
Reason
When email or phone number exist
Error Message
Email or phone number already exists
Solution Message
Enter a new email or phone number
4026
Reason
When incorrect email or phone number entered
Error Message
Incorrect email or phone number entered
Solution Message
Enter the email or phone number again
4027
Reason
When mobile and email is not verified
Error Message
Mobile and email is not verified
Solution Message
Contact your manager for access
4028
Reason
Incorrect mobile number entered
Error Message
Incorrect mobile number entered
Solution Message
Enter the phone number again
4029
Reason
Since unexpected behavior
Error Message
Device is blocked
Solution Message
Contact your manager to unblock you
4030
Reason
When device sends an attestation with a device ID that does not exist
Error Message
Device does not exist
Solution Message
Contact your manager to check the device
4031
Reason
Any refresh token that gets expired
Error Message
Token has expired
Solution Message
Enter the email or phone number again
4032
Reason
Record does not exist
Error Message
Record does not exist
Solution Message
Contact your manager
4033
Reason
.
Error Message
Error in authentication
Solution Message
Contact your manager or technical service provider
4034
Reason
.
Error Message
User is inactive
Solution Message
Contact your manager or technical service provider
4035
Reason
Terminal connected to another device
Error Message
Terminal is already connected with another device
Solution Message
There are two ways to disconnect the device:
First, from our API:
1.You can found our API here.
2.Type your terminal id in the url.
3.send the request
Second, from our dashboard, you can:
1.Navigate to the terminal page.
2.Click on the terminal you want to disconnect.
3.Press on Disconnect Device under the Access section.
4036
Reason
.
Error Message
Client uuid not found
Solution Message
Contact your manager or technical service provider
4037
Reason
.
Error Message
Terminal id not found
Solution Message
Contact your manager or technical service provider
4038
Reason
invalid JWT(data object is missing)
Error Message
invalid JWT(data object is missing)
Solution Message
Contact your manager or technical service provider. You can check here how it should be look. 
4039
Reason
.
Error Message
Mobile number not registered
Solution Message
To assign a new or existing user to a terminal:
1.Navigate to the  terminal page.
2.Press on the terminal you wish to assign a new user to.
3.Press on Invite User that can be found in Access section.
4.Type the mobile number of the user. If the user doesn't invited before, you will be ask for his name and email also.
4040
Reason
.
Error Message
Transaction not found
Solution Message
Contact your manager or technical service provider
5000
Reason
Failed to parse server error message
Error Message
Unexpected Error
Solution Message
Contact your technical provider
5001
Reason
Failed to parse server success message
Error Message
Unexpected Error
Solution Message
Contact your technical provider
5002
Reason
Network error
Error Message
A network error has occurred
Solution Message
Check your Wi-Fi or 4G/5G connection
5003
Reason
Unexpected Error
Error Message
Unexpected Error
Solution Message
Contact your technical provider
5004
Reason
Can't reverse this transaction
Error Message
This transaction cannot be reversed
Solution Message
A transaction can only be reversed within 60 seconds of the transaction.
5005
Reason
spin-emv initializing
Error Message
Unexpected Error
Solution Message
Contact your technical provider
5006
Reason
Admin pin incorrect
Error Message
Admin PIN entered incorrectly
Solution Message
Make sure to enter the correct pin
5007
Reason
Login save failed
Error Message
Unexpected Login Error
Solution Message
Try to login again
5008
Reason
Confirm user pin not match
Error Message
User PIN does not match
Solution Message
Make sure to enter the correct pin
5009
Reason
User pin incorrect
Error Message
User PIN entered incorrectly
Solution Message
Make sure to enter the correct pin
5010
Reason
Terminal connected to another device
Error Message
The terminal is already connected to another device
Solution Message
Contact your manager to disconnect the terminal
5011
Reason
Random crash
Error Message
Unexpected Error
Solution Message
Reload the application or contact your technical provider
5012
Reason
Paymnet transaction cancelled
Error Message
Transaction Cancelled
Solution Message
Transaction was canceled, try again
5013
Reason
Payment transaction processing error
Error Message
Payment transaction processing error
Solution Message
Try again later
5014
Reason
Payment plugin already installed
Error Message
Payment plugin is already installed
Solution Message
Please uninstall and install again. Usually happens when the a name of  payment plugin is different from what it should be. (This error rarely occurs)
5015
Reason
Payment plugin downloaded but not found
Error Message
Payment plugin downloaded but not found
Solution Message
Contact your technical provider
5016
Reason
Payment plugin install failed
Error Message
Payment plugin install failed
Solution Message
Please try again
5017
Reason
Unsupported SDK version
Error Message
Unsupported SDK version
Solution Message
Please update your SDK
5018
Reason
Payment plugin failed to download
Error Message
Payment plugin failed to download
Solution Message
Please try to download again
5019
Reason
App failed to load the latest version of config. duing to:
Network issues
Incorrect JSON format
Invalid configuration
Any error that prevent load the latest confige into the spin
Error Message
Failed to load the latest configuration
Solution Message
Contact your technical provider. To proceed with existing configuration press continue
5020
Reason
User entered a terminal id that doesn't exist
Error Message
This terminal does not exist
Solution Message
Please make sure you entered the correct terminal ID
SDK - Previous
SDK Models
Next - API EndPoints
API
Last modified 2mo ago