{"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 how to fix common issues with POS."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"declined-transactions","__idx":1},"children":["Declined transactions"]},{"$$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":"Decline reason"},"children":["Decline reason"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Next steps"},"children":["Next steps"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment declined."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payment was declined due to insufficient funds or an issue with the cardholder's account."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ask the cardholder to check their card status with their bank."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction timeout."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The transaction didn't receive a response from the payment gateway in time."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retry the transaction."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Incorrect PIN. Please try again."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The entered PIN is incorrect."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ask the cardholder to re-enter their PIN."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PIN blocked."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The card has been blocked due to multiple incorrect PIN attempts."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ask the cardholder to contact their bank."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-messages","__idx":2},"children":["Error messages"]},{"$$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 message"},"children":["Error message"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Next steps"},"children":["Next steps"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Loading POS configuration data failed. Missing parameter file"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The credential parameters are incorrectly configured."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Please contact Support."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Loading POS Configuration data failed. Check missing parameters."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POSConfigurationServiceHost"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POSConfigurationServiceTimeout"]}," values are missing."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Please contact Support."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Loading POS configuration data failed. Check param config."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The device has lost internet connectivity."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ensure a strong Wi-Fi or mobile network connection is available."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Error trying to deserialise json."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A general validation error has occurred. The Unity Gateway rejected the request due to invalid or missing data."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Please contact Support and quote the displayed error message."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EMV configuration file downloaded error."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The EMV configuration file URL is invalid or missing."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Please contact Support."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer card has expired."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You're attempting a transaction with an expired card."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ask the customer to retry using a valid card."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unexpected error."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An unexpected issue occurred."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Please contact Support."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Try another card."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An invalid or unsupported contactless card was used."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Insert the card using the chip reader (ICC slot) and retry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Incorrect PIN. Please try again."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The entered PIN is incorrect."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ask the cardholder to re-enter their PIN."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unable to print receipt. Refill paper and press enter."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["There is no paper in the printer."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refill paper and press Retry to continue printing."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reswipe card."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The card wasn't read correctly."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retry the swipe or use a different card or payment method."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You have exceeded the PIN input limit. Your account has been blocked."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The cardholder has exceeded the maximum number of PIN attempts."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The cardholder must contact their card issuer to unlock the card."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No result in ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Transaction history"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["There are no recorded transactions or the Reporting Service URL is missing/invalid."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Please contact Support if the issue persists."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Merchant block error. Transaction amount greater than ceiling limit amount."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The transaction amount exceeds the allowed ceiling limit configured for the terminal."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Try entering a lower amount or contact your system administrator."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Format error."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An incorrect CVV code was entered during a keyed transaction."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retry the transaction and ensure the correct CVV is provided."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"other-issues","__idx":3},"children":["Other issues"]},{"$$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":"Issue"},"children":["Issue"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Next steps"},"children":["Next steps"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The device freezes."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Hold the power button for 10+ seconds to restart the device."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Wi-Fi connection drops."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reconnect via Android settings or switch to a mobile network."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The printer jams."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Gently open the cover, remove the paper, and reload it properly."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"need-help","__idx":4},"children":["Need help?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To contact our friendly Support team, tap the menu icon in the top-left corner of your device and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contact details"]},". You'll see all the necessary support contact information."]}]},"headings":[{"value":"Troubleshooting","id":"troubleshooting","depth":1},{"value":"Declined transactions","id":"declined-transactions","depth":2},{"value":"Error messages","id":"error-messages","depth":2},{"value":"Other issues","id":"other-issues","depth":2},{"value":"Need help?","id":"need-help","depth":2}],"frontmatter":{"seo":{"title":"Troubleshooting"}},"lastModified":"2026-09-09T16:14:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/point-of-sale/pos/troubleshooting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}