Type Alias InttegroCheckoutErrorCode
InttegroCheckoutErrorCode:
| "already_mounted"
| "destroyed"
| "invalid_locale"
| "invalid_order_id"
| "invalid_runtime"
| "invalid_timeout"
| "mount_failed"
| "mount_timeout"
| "not_mounted"
| "runtime_load_failed"
| "runtime_load_timeout"
| "target_not_found"
| "unsupported_environment"
A stable, machine-readable reason why the loader or checkout controller could not complete an operation.
Use the code to decide whether to retry, correct integration configuration, or show a temporary failure state. Do not branch on the human-readable error message, which may change between releases.
already_mounted: CheckoutController.mount was called more than once without an intervening CheckoutController.unmount.destroyed: an operation attempted to mount a controller after CheckoutController.destroy made it permanently unusable.invalid_locale: the supplied locale is not a well-formed BCP 47 tag.invalid_order_id: the Order reference is empty, too long, or contains unsupported characters.invalid_runtime: a global runtime did not come from the required hosted script or does not implement the supported protocol.invalid_timeout: the mount timeout falls outside 1,000–60,000 ms.mount_failed: the hosted frame failed, reported an initialization error, or was unmounted before becoming ready.mount_timeout: the hosted frame did not become ready before the timeout.not_mounted: an operation requires a ready, mounted checkout.runtime_load_failed: the browser could not download the hosted runtime.runtime_load_timeout: the hosted runtime did not load within 15 seconds.target_not_found: the mount target is missing or is not an HTML element.unsupported_environment: a browser-only operation ran during SSR or in another non-DOM environment.