Loading
Entering the card
Submitting
3D Secure
Next steps
Accept a card payment
The guarded submit-then-charge flow these guides assume.
Elements SDK errors
Every
ElementsError code, grouped by family.Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Find the right recovery guide fast — every Elements failure, grouped by where it happens: loading, entering the card, submitting, or 3D Secure.
| 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 |
| 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 |
| 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 |
| 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 |
ElementsError code, grouped by family.