Broadcast Error Response
Every time an error occurs in the terminal, the Android SDK sends a broadcast with the information, the Diagnostic APP processes and sends to the backend.
Access to this data will be performed by the kafka message service through the Topic terminal-errors. Broker addresses may vary between environments, request url for operations sector.
Parameters
| Name |
Type |
Mandatory |
Description |
Maximum field size |
paymentsAppVersion |
String |
Yes |
Version of the payments suite app. |
10 characters |
timestamp |
Date |
Yes |
Error date and time. |
|
errorType |
ErrorType |
Yes |
Type of error (ErrorType) |
|
serial |
string |
Yes |
Terminal serial number. |
|
errorCode |
String |
No |
Error code (prefix + identifier). |
6 characters |
errorMessage |
String |
No |
Error message. |
255 characters |
breadcrumbs |
String |
No |
Path of user-triggered actions from the splash screen to the time of the error. |
4096 characters |
subAcquirerId |
String |
No |
Code of the Paystore facilitator to which the terminal is associated. |
32 characters |
merchantPaystore |
String |
No |
Merchant at Paystore |
32 characters |
terminalID |
String |
No |
Terminal logical number. |
8 characters |
bCReturnCode |
String |
No |
BC error code. |
4 characters |
stackTrace |
String |
No |
Lists the method calls that lead to the exception being thrown, along with the file names and line numbers where the calls occurred. |
255 characters |
bcCommands |
List<BCCommand> |
No |
List BC Commands. |
|
bin |
String |
No |
Card BIN. |
6 characters |
aid |
String |
No |
Card Application Identifier. |
32 characters |
value |
BigDecimal |
No |
Transaction value. |
|
installments |
Integer |
No |
Number of payment installments |
|
captureType |
CaptureType |
No |
Card capture form. |
|
cardServiceCode |
String |
No |
Card service code. |
|
productId |
Integer |
No |
Product identifier |
|
paymentType |
PaymentType |
No |
Payment type (Debit, Credit, Voucher, etc.). |
|
ticketNumber |
String |
No |
Coupon number generated by the terminal for the transaction. |
4 characters |
batchNumber |
String |
No |
Lot number |
3 characters |
endpoint |
String |
No |
Lastendpoint used by the terminal before the error occurred. |
2048 characters |
sdkMethod |
String |
No |
SDK method used when the error occurred. |
255 characters |
applicationName |
String |
No |
Name of the application that used the SDK. |
255 characters |
httpStatusCode |
String |
No |
HTTP error code. |
3 characters |
transactionUuid |
String |
No |
Transaction UUID |
36 characters |
devicdeName |
String |
No |
Terminal Model. |
|
lastBootDate |
String |
No |
Time (timestamp) when the terminal was turned on. |
|
batteryLevel |
String |
No |
Current battery level. |
|
connectionType |
String |
No |
Internet connection type. |
|
wifiLevel |
String |
No |
WIFI signal strength |
|
isCharging |
boolean |
No |
Informs if the device is connected and charging. |
|
osVersion |
String |
No |
Operation system version. |
|
kernelVersion |
String |
No |
Kernel version. |
|
ErrorType
| Code |
Name |
Description |
| 1 |
SCREEN_ERROR |
Screen errors |
| 2 |
FATAL_EXCEPTION |
FatalException |
| 3 |
COMM_SERVER_ERROR |
Communication or server failures |
BCCommandType
| Code |
Name |
Description |
| 1 |
GET_CARD |
Return from BC's getCard method |
| 2 |
GO_ON_CHIP |
Return from BC's getOnChip method |
| 3 |
FINISH_CHIP |
Return from BC's finishChip method |
BCCommand
| Name |
Type |
Mandatory |
Description |
Maximum field size |
type |
BCCommandType |
No |
BC command type (getCard, goOnChip or finishChip). |
|
input |
String |
No |
BC command entry (getCard, goOnChip or finishChip). |
2048 characters |
output |
String |
No |
BC command output (getCard, goOnChip or finishChip). |
- |