-
Getting started
keyboard_arrow_down
Connect to the CCV Platform
Integrate our products into your software. Let's make payment happen together!
Look at all the possibilities
Integrate our products into your software. Let's make payment happen together!
Look at all the possibilitiesFailure codes/reasons can be accompanied by one or multiple internal error codes. These internal codes:
Important: Do not build any application logic or decision making on internal error codes. Rely only on the public failure codes + reasons listed below; the internal list can evolve without notice.
| Failure Code | Failure | How to solve |
|---|---|---|
| 11000 | SOFTPOS_NOT_INSTALLED | Install SoftPOS application from Play Store |
| 11002 | ACTIVATION_PAYLOAD_INVALID | Contact support |
| 11004 | NETWORK_ERROR | Check if device has a network connection |
| 11005 | DEVICE_STATE_FAILURE | Contact support |
| 11006 | NFC_NOT_ENABLED_ERROR | Check if nfc is enabled on the device |
| 11007 | INTERNAL_ERROR | Contact support |
| 11008 | NFC_NOT_SUPPORTED | Device is not NFC compatible |
| 11009 | DEV_OPTIONS_ENABLED | Disable Developer option on DeviceVia Settings → System/Additional Settings → Developer options → Disable |
| 11011 | DEVICE_TIME_OUT_OF_SYNC | Device time is out of sync, check if device time is correct |
| 11012 | APP_BUSY_WITH_PREVIOUS_REQUEST | App is busy with a previous request, a new request cannot be processed until the previous one is complete |
| 11013 | NFC_HARDWARE_NOT_AVAILABLE | If the device does have NFC hardware, check if it is enabled, if not possible to enable, try restarting the device. If the issue persists, contact support |
| Failure Code | Failure | Failure Reason | How to solve |
|---|---|---|---|
| 13000 | TRANSACTION_ERROR | ||
| NETWORK_ERROR | Check if the device has an internet connection | ||
| DEVICE_STATE_FAILURE | Contact support | ||
| SOFTPOS_NOT_INSTALLED | Install softpos app | ||
| NFC_NOT_ENABLED_ERROR | Check if the NFC is enabled on the device | ||
| NFC_HARDWARE_NOT_AVAILABLE | If the device does have NFC hardware, check if it is enabled, if not possible to enable, try restarting the device. If the issue persists, contact support | ||
| DEVICE_TIME_OUT_OF_SYNC | Device time is out of sync, check if device time is correct | ||
| MICROPHONE_USAGE_DETECTED | Contact support | ||
| CAMERA_USAGE_DETECTED | Contact support | ||
| EXTERNAL_CAMERA_DETECTED | Contact support | ||
| TOTAL_ELAPSED_TIMEOUT | Retry transaction | ||
| DISCOVERY_TIMEOUT | Retry transaction | ||
| PIN_ENTRY_ACCUMULATED_TIMEOUT | Retry transaction | ||
| PIN_ENTRY_TIMEOUT | Retry transaction | ||
| AUTHORIZATION_IN_PROGRESS_TIMEOUT | Retry transaction | ||
| HOST_CALLBACK_ERROR | Retry transaction | ||
| PIN_PAD_OBSCURED_ERROR | Retry transaction | ||
| PIN_PAD_DETACHED_ERROR | Retry transaction | ||
| DEV_OPTIONS_ENABLED | Disable Developer options on the device | ||
| APP_IN_BACKGROUND | Contact support | ||
| UNSUPPORTED_NFC_TAG | NFC tag is not supported, try another card | ||
| TERMINAL_NOT_INSTALLED | Reinstall terminal | ||
| SERVICE_DISCONNECTED_FAILURE | Retry the transaction, if it still occurs contact support | ||
| TRANSACTION_START_TIMEOUT | Retry the transaction | ||
| TRANSACTION_NOT_FOR_TERMINAL | Transaction is intended for another SoftPOS instance. Check that the terminal ID is correct or perform a fresh installation | ||
| APP_BUSY_WITH_PREVIOUS_REQUEST | App is busy with a previous request, a new request cannot be processed until the previous one is complete | ||
| INVALID_METHOD_TRANSACTION_ID | Check POS implementation, ensure the transaction ID is valid and present | ||
| TRANSACTION_PAYLOAD_ALREADY_REQUESTED | Check POS implementation, ensure the transaction ID is valid and only used once | ||
| TRANSACTION_PAYLOAD_TIMEOUT | Check POS implementation, ensure the transaction ID is valid and present | ||
| TRANSACTION_NOT_FOUND | Check POS implementation, ensure the transaction ID is valid and present | ||
| 13001 | TRANSACTION_CANCELLED | ||
| DEVICE_STATE_FAILURE | Contact support | ||
| TRANSACTION_WAS_TERMINATED | Retry transaction | ||
| USER_CANCELLED_PIN_PAD | Retry transaction | ||
| SESSION_DEACTIVATED | Retry transaction | ||
| TIME_CHECK_ERROR | Retry transaction | ||
| 13002 | TRANSACTION_NOT_AUTHORIZED | ||
| ONLINE_DECLINED | Retry transaction | ||
| OFFLINE_DECLINED | Retry transaction | ||
| INVALID_AUTHORISATION_DATA | Retry transaction | ||
| NO_CARD_APPLICATION | Retry transaction | ||
| NO_CARD_APPLICATION_SELECTOR_MISMATCHED | Retry transaction | ||
| PROCESSING_ERROR | Retry transaction | ||
| CARD_ERROR | Retry transaction | ||
| 13003 | INTERNAL_ERROR | Contact support |
| Failure Code | Failure | How to solve |
|---|---|---|
| 10000 | SOFTPOS_NOT_INSTALLED | Install SoftPOS application from Play Store |
| 10003 | INTERNAL_ERROR | Contact support |
| 14000 | INVALID_URL_SCHEME | Invalid URL scheme, check if deeplink url is in line with documentation |