val devices = listOf(
  TerminalDevice(id = "BRI12345", ipAddress = "192.168.1.10", active = true),
  TerminalDevice(id = "BRI67890", ipAddress = "192.168.1.11", active = true)
)

TerminalH2H.registerDevices(
  devices = devices,
  restart = true // restart to apply the refreshed device list immediately
)

# Example: Create a payment session
curl -X POST 'https://terminal-dev.xendit.co/v1/terminal/sessions' \
  -u 'API_KEY:' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-key: unique-session-123' \
  -d '{
    "terminal_id": "TERMINAL_ID",
    "amount": 10000,
    "currency": "IDR",
    "external_id": "payment-123",
    "payment_method": "card"
  }'

// Set timeout to 5 minutes (default)
TerminalH2H.setOperationTimeout(minutes = 5)

// Set custom timeout for longer operations
TerminalH2H.setOperationTimeout(minutes = 10)

// Set provider-specific timeouts
TerminalH2H.setOperationTimeout(type = TimeoutType.CARD, minutes = 10)
TerminalH2H.setOperationTimeout(type = TimeoutType.QR, minutes = 10)

// Global error monitoring
TerminalH2H.observeError(
  CoroutineScope(Dispatchers.IO)
) { device, error ->
  Log.e("TerminalH2H", "Error on ${device?.id}: ${error?.message}")
  
  when (error.code) {
    ErrorCode.TERMINAL_BUSY -> {
      // Terminal is processing another transaction
      // Wait and retry later
    }
    ErrorCode.FAILED_TO_CONNECT -> {
      // Network connectivity issue
      // Check network connection and terminal <a href="#finding-terminal-information">IP</a>
    }
    ErrorCode.AUTHENTICATION_FAILED -> {
      // Invalid credentials or <a href="#finding-terminal-information">terminal ID</a>
      // Verify client key and terminal configuration
    }
    // ... handle other error codes
  }
}

// Device-specific error monitoring
val errorFlow = TerminalH2H.errorState(terminalDevice)
val deviceErrorFlow = terminalDevice.error

data class TerminalError(
  val code: ErrorCode,
  val message: String
)

fun handleTerminalError(error: TerminalError?) {
  when (error?.code) {
    ErrorCode.AUTHENTICATION_FAILED -> {
      // Verify API key and <a href="#finding-terminal-information">terminal ID</a>
      Log.e("TerminalH2H", "Authentication failed: ${error.message}")
      // Show user-friendly message and retry with correct credentials
    }
    
    ErrorCode.TERMINAL_BUSY -> {
      // Terminal is processing another transaction
      Log.w("TerminalH2H", "Terminal busy: ${error.message}")
      // Wait and retry after a delay
      retryAfterDelay(5000) // 5 seconds
    }
    
    ErrorCode.FAILED_TO_CONNECT, ErrorCode.NOT_CONNECTED -> {
      // Network connectivity issues
      Log.e("TerminalH2H", "Connection failed: ${error.message}")
      // Check network connection and terminal <a href="#finding-terminal-information">IP address</a>
      checkNetworkConnectivity()
    }
    
    ErrorCode.KEY_INVALID, ErrorCode.INVALID_CREDENTIAL -> {
      // Credential issues
      Log.e("TerminalH2H", "Invalid credentials: ${error.message}")
      // Rotate or refresh API credentials
      refreshCredentials()
    }
    
    ErrorCode.ENCRYPTION_FAILED -> {
      // Encryption key issues
      Log.e("TerminalH2H", "Encryption failed: ${error.message}")
      // Re-initialize SDK with correct encryption keys
      reinitializeSDK()
    }

    ErrorCode.TIMEOUT -> {
      // Operation exceeded configured timeout window
      Log.w("TerminalH2H", "Operation timed out: ${error.message}")
      // Retry using exponential backoff or restart the device connection
      retryAfterDelay(5000)
    }

    ErrorCode.CANCELLED -> {
      // Action cancelled on terminal or by operator
      Log.i("TerminalH2H", "Command cancelled: ${error.message}")
      // Surface a friendly message to the cashier and re-initiate if needed
    }

    ErrorCode.DECLINED_BY_READER -> {
      // Card or reader rejected the transaction
      Log.w("TerminalH2H", "Reader declined: ${error.message}")
      // Prompt customer to retry or use a different payment method
    }
    
    else -> {
      // Log and escalate unknown errors
      Log.e("TerminalH2H", "Unknown error: ${error?.message}")
      // Report to monitoring system
      reportError(error)
    }
  }
}