{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading"]},"type":"markdown"},"seo":{"title":"Troubleshooting","description":"Transform your commerce with PXP's unified platform—seamless payments, real-time insights, and global growth in one powerful integration.","lang":"en-UK","siteUrl":"https://developer.pxp.io","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"troubleshooting","__idx":0},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn about the possible POS+ SDK errors."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Proper error handling is essential, as it ensures that your application can gracefully manage unexpected situations, provide meaningful feedback to users, and maintain system stability while protecting sensitive data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When an error occurs, you'll receive an error code (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDKXXXX"]},") and descriptive error message."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-codes","__idx":2},"children":["Error codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes all the possible SDK errors codes."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Error code"},"children":["Error code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Suggested action"},"children":["Suggested action"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0001"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An unknown error has occurred."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Log the error and contact support if recurring."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0002"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Network connectivity issue occurred."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check your internet connection and retry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0003"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Network operation attempted on the main thread."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ensure network operations run off the main thread."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0004"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request sent successfully from SDK to POS, but read/write data timed out."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check the transaction status. Log the event for tracking and reach out to support if this occurs frequently. The auto-reversal should be handled by POS."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0005"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Failed to connect."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify the server address and network, then attempt to reconnect."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0006"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Illegal arguments."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Please check the arguments."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0007"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid parameters."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Please check the parameters."]}]}]}]}]}]},"headings":[{"value":"Troubleshooting","id":"troubleshooting","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Error codes","id":"error-codes","depth":2}],"frontmatter":{"seo":{"title":"Troubleshooting"}},"lastModified":"2026-09-10T12:33:25.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/point-of-sale/pos-plus/sdk/troubleshooting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}