Handle failures

Elements can fail at four points in a checkout attempt. Find your symptom below and jump straight to the recovery steps — every guide follows the same shape: when it happens, what you see, what to do, and how to prevent it.

Loading

Symptom	Signal	Guide
The SDK script never loads, or `loadRadiumOne()` hangs	Rejected promise, `window.RadiumOneSDK` stays `undefined`, or a silent SRI violation in the console	Handle Elements failing to load
`RadiumOne.init()` / `loadRadiumOne()` throws immediately	`ElementsError` with an `api:` or `loader:` code	Fix publishable key errors

Entering the card

Symptom	Signal	Guide
A card field never appears, or `create()`/`mount()` throws	`element:container_not_found`, `element:destroyed`, `element:duplicate`, or an empty container with a CSP violation	Fix card fields that don’t render
The field shows a red/invalid state as the shopper types	`change` event with `event.valid: false` and an `event.error.code`	Show card validation errors

Submitting

Symptom	Signal	Guide
The shopper double-clicks Pay, or your code resubmits within a second	`ElementsError` `submit:in_progress` or `submit:rate_limited`	Prevent double submission
`submit()` rejects with a gateway error	`ElementsError` whose `code` is a `urn:radiumone:token:` / `checkout:` / `auth:` / `gateway:` URN	Handle tokenization failures
The session or the card token went stale before you charged it	`token:transient-expired` / `data-purged` (410), or a bind failure inside `submit()`	Handle expired sessions and card tokens
The shopper’s connection drops mid-submit	`ElementsError` type `network_error`, `retryAllowed: true`	Handle browser network errors

3D Secure

Symptom	Signal	Guide
`threeDS.authenticate()`/`resume()` rejects, or resolves to a non-authenticated status	`three-ds:cancelled`, `three-ds:challenge-timeout`, `three-ds:provider-unavailable`, or `{status: "NOT_AUTHENTICATED" \| "FAILED" \| "REJECTED" \| "EXPIRED"}`	Handle 3D Secure failures in Elements

Next steps

Accept a card payment

The guarded submit-then-charge flow these guides assume.

Elements SDK errors

Every ElementsError code, grouped by family.

Introduction

Guides

3D Secure

Errors

Reference

Handle failures - Elements SDK

Loading

Entering the card

Submitting

3D Secure

Next steps

Accept a card payment

Elements SDK errors

​Loading

​Entering the card

​Submitting

​3D Secure

​Next steps

Accept a card payment

Elements SDK errors

Loading

Entering the card

Submitting

3D Secure

Next steps