Error Codes

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

From the 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 hasn't been 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

Payment 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