{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Error Codes","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":"error-codes","__idx":0},"children":["Error Codes"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pay-instore-errors","__idx":1},"children":["Pay Instore Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The types of Pay Instore errors are:"]},{"$$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":"Pay Request Error Code"},"children":["Pay Request Error Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay request not found"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_CREATION_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Error error when creating the Pay Request"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_ALREADY_EXISTS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay request with this \"origin.transactionId\" already exists with status: ${status}"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_TRANSACTION_ID_EXISTS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay request with this \"origin.transactionId\" already exists with alternate information"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_INVALID_TRANSACTION_ID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"origin.transactionId\" must be a valid UUIDv4"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_INVALID_TOTAL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Total is invalid and refund does not combine with goodsAndServices or cashout."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_NOT_CANCELLABLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay request cannot be cancelled"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MID_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Merchant ID not found."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVALID_MID_FORMAT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Merchant ID must be a number."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POS_NOT_CONFIGURED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POS config is missing for posId: ${posId}"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POS_UNAUTHORISED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not authorised for merchant."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RATE_LIMIT_EXCEEDED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rate limit exceeded, actions on the same (mid + tid) can only occur once every 250ms"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SANDBOX_POS_ONLY"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only sandbox POS is supported"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POS_SANDBOX_TID_INVALID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POS is currently in sandbox mode and tid is not supported: ${tid}"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TERMINAL_NOT_PAIRED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Terminal is not paired. Please establish a pairing key for this terminal"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TERMINAL_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Terminal not found."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TERMINAL_PAIRING_INVALID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pairing key out of sync. Please re-establish a pairing key for this terminal"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sample-error","__idx":2},"children":["Sample Error"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"error\": \"Pay request not found\",\n  \"errorCode\": \"PAY_REQUEST_NOT_FOUND\"\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Error Codes","id":"error-codes","depth":1},{"value":"Pay Instore Errors","id":"pay-instore-errors","depth":2},{"value":"Sample Error","id":"sample-error","depth":3}],"frontmatter":{"seo":{"title":"Error Codes"}},"lastModified":"2026-09-02T01:02:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/in-person-payments/pay-in-person/error-codes","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}