Skip to main content
This page provides a reference of error codes. All errors share the same response structure and are returned in the errorCode and errorMessage fields.

​
Protocol Errors

​
Payment Errors

​
General Errors

​
Error Handling Best Practices

To ensure a high-quality integration, follow these guidelines:
  • Logging: Always log both the errorCode and the descriptive errorMessage to facilitate debugging.
  • Retries: Implement client-side retry logic if the terminal does not respond within the expected window.
  • Safety: Never automatically retry a declined transaction without a direct user action.
  • Typical Timeouts: Use the following time windows for client-side monitoring:
    • Card Detection: 30–60 seconds.
    • User Input: 60–120 seconds.
    • Authorization: 10–30 seconds.
User Feedback Always provide clear visual feedback on the POS screen during wait times or when an error occurs to keep the customer informed.