Mobile SDK Error Handling

“Unexpected Credentials Error”

When user tries to login and username or password is incorrect.

Provide correct username and password.

“Authentication Failed - No Merchant(s) located for this user.”

When user tries to login, login is successful but the retrieving merchant has any error.

Check if the provided user has merchant associated or not

“Login Successful”

If Username and password is correct as well as merchant retrieve is success then this message comes

N/A

“Unexpected Error retrieving Merchant.”

Trying to retrieve a single merchant but having issue

N/A

“Merchant retrieval successful”

Trying to retrieve a single merchant and success

N/A

“Payrix Session Time Out - Please Log In”

Failed Request: Session Timed Out

Login Again

“Scan Timeout”

Doing Scan for BLE devices specially BBPoS and no device fond nearby

Card Reader Error: - Verify Device is On Verify Correct Device is Selected in Settings. Otherwise, Device may be faulty

“Bluetooth pairing failed with incorrect passkey”

N/A

“Bluetooth pairing error, the reader already paired with another mobile device.”

N/A 

“Bluetooth pairing error, the reader has removed this device pairing information. Forget the reader in iOS Settings.”

Trying to connect the OTA reader but it can not connect because of an error.

Go to:
Phone settings → Bluetooth → Check for Device → Forget Device

1

“Card Action Message”

App Should immediately display to user to do that action.

2

“Info Message” 

App Should Display the informative message, but not required.

3

“Reserved”

App should Display Field for PIN Entry.

4

“App Selection Needed” 

App should Display List of Apps to Display.

5

“Send Final EMV Data”

App should Catch and use EMV Data as desired.

9

“Error Occurred”

App Should Display the error and end processing the transaction.

0

“Transaction Complete”

The transaction ended and the PayResponse object contains the completed transaction data.

99

“Simulation Finished”

Finished a Simulation of App Selection.

0

“Transaction Complete”

Refund Request Completed Successfully

1

“Refund Declined”

Refund Declined by Payrix Platform

2

“Reversal Declined”

Reversal Declined by Payrix Platform

3

“Not Refund Eligible”

The transaction does not meet the criteria for a Refund

4

“Refund Eligible”

The transaction does meet the criteria for a Refund

5

“Invalid Amt Requested”

The amount requested is either zero or greater than amount available

6

“Device RevAuth Failed”

Device Reverse Auth Declined by Payrix Platform

7

“Device RevAuth Success”

Device Reverse Auth Approved

9

“Unexpected Error”

An unexpected error occured

SetupError

N/A

OTA setup error.

BatteryLowError

N/A

OTA update requires battery level at 50% or above.

DeviceCommError

N/A

Device communication error.

ServerCommError

->

Server communication error.

1003

Sign data was not found because of CMAC or hash invalid.

3101

SDK version too low

3102

API version too old

3103

Target Firmware version too old

3104

SDK version too low - Missing BL/FW Version

3201

Action not permitted: Bulk operation is restricted

3202

Login not match with device

3203

Action not permitted: Set Target operation is restricted

3301

Missing session token / session expired

3302

Session token invalid

3303

Session token info not match

3401

Terminal not found

3402

Key Profile not found

3403

Working Key not found

3404

Key generation failed

3405

Load key failed - Incorrect key profile

3406

Key generation failed - Key block hsm value is null.

3406

Not supported Order Type

3407

Current Firmware version does not support config OTA

3408

Current Key Profile does not compatible with target Firmware

3409

Current Firmware does not compatible with target Key Profile

9020

Data not found

0999

Unknown error

Failed

N/A

OTA operation failed.

Stopped

N/A

Remote update has been stopped.

NoUpdateRequired

N/A

No update is available.

InvalidControllerStateError

N/A

Invalid controller state, the OTA API is busy.

IncompatibleFirmwareHex

N/A

The input firmware hex is not compatible with the device.

IncompatibleConfigHex

N/A

The input config hex is not compatible with the device.

FAIL_TO_START_BT

3006

android.bluetooth.BluetoothAdapter error at scanning Bluetooth Classic

3008

android.bluetooth.BluetoothAdapter error at scanning BLE

3010

android.bluetooth.BluetoothAdapter error at connecting Bluetooth Classic

3011

Incorrect Bluetooth device type

3018

BluetoothGatt status is not BluetoothGatt.GATT_SUCCESS in connection

3020

Bond failure

User cancel during pairing

Incorrect pairing code

Time-out before entering pairing code

3021

Cannot discover the BLE service UUID

3022

Cannot get the BLE read characteristic UUID

3023

Cannot get the BLE read characteristic descriptor

3024

Gatt cannot set the BLE write descriptor

3025

android.bluetooth.BluetoothAdapter error at connecting BLE

3026

Fail to get the android.bluetooth.BluetoothSocket after Bluetooth Classic connected

3027

Fail to get inputStream after BLE connected

3028

Initialize command no response.

3029

android.bluetooth.BluetoothSocket.connect() timeout no response in Bluetooth Classic. If the device is not power on, it will has this error

3036

Start BLE scan error.

3035

Enable android.bluetooth.BluetoothAdapter has error

BTFailToStart

Failed to start Bluetooth functions.

BTAlreadyConnected

Bluetooth already connected.

PairingError

Bluetooth pairing error code.

PairingError_IncorrectPasskey

Bluetooth pairing failed with incorrect passkey.

PairingError_PeerRemovedPairingInformation

Bluetooth pairing error, this error will be triggered when a Bluetooth device paired in iPhone A, then try to pair the device in another iPhone B