{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-cashier/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Errors","siteUrl":"https://docs.omno.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"errors","__idx":0},"children":["Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SDK throws a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CashierError"]}," with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," (and optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]},") when a method can't proceed."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"class CashierError extends Error {\n  code: CashierErrorCode;\n  details?: unknown;\n}\n","lang":"typescript"},"children":[]},{"$$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":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NO_IFRAME"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No Cashier iframe is available for the operation."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CONTAINER_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["containerId"]}," passed to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["open()"]}," doesn't match an element on the page."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVALID_ORIGIN"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A message was received from an origin that failed validation."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SESSION_CONFLICT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An operation conflicts with the current session state."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOT_READY"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Cashier isn't ready for the requested operation yet."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNKNOWN"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An unspecified error."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are thrown by SDK methods — wrap calls in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["try/catch"]}," where you need to handle them."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"session-expiry","__idx":1},"children":["Session expiry"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Session expiry is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," thrown as a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CashierError"]},". When a session (and its token) expires, the Cashier shows a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["session-expired screen"]},". To recover, create a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["new"]}," session on your backend and call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["open()"]}," again. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/cashier/session-and-token"},"children":["Session & token"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"build-it-","__idx":2},"children":["Build it →"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/cashier/sdk/events"},"children":["Events"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/cashier/session-and-token"},"children":["Session & token"]}]}]}]},"headings":[{"value":"Errors","id":"errors","depth":1},{"value":"Session expiry","id":"session-expiry","depth":2},{"value":"Build it →","id":"build-it-","depth":2}],"frontmatter":{"title":"Errors","description":"The CashierError codes thrown by the Omno Web SDK, and how session expiry surfaces to the customer.","seo":{"title":"Errors"}},"lastModified":"2026-11-06T11:46:00.425Z","pagePropGetterError":{"message":"","name":""}},"slug":"/cashier/sdk/errors","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}