Skip to main content
threeDS.authenticate(), handle(), and resume() throw an ElementsError when the 3D Secure flow itself fails to run — a bad argument, a cancelled or timed-out challenge, or the gateway rejecting the request. This is separate from a completed authentication that resolves to a non-approved status (NOT_AUTHENTICATED, FAILED, REJECTED, EXPIRED), which is not an error — see Authentication results for what each status means and whether to authorize.
Your server’s API calls. Elements pages write them as the full path on the API host, as the SDK publishes them — for example, POST /gateway/v1/sessions is https://api.radiumone.io/gateway/v1/sessions (sandbox: https://api-sandbox.radiumone.io/gateway/v1/sessions). The Payments API reference lists the same operations relative to that base URL: POST /v1/sessions, PATCH /v1/sessions/{session_id}, GET /v1/payment-methods, POST /v1/transactions/purchase.

3D Secure errors

From threeDS.authenticate()/handle()/resume(): the SDK’s own checks and flow failures (urn:radiumone:elements:three-ds:*), and the gateway types passed through from the 3DS calls (urn:radiumone:payment-gateway:*). The gateway’s list is open, so treat an unrecognized code as not retryable unless retryAllowed is true. authenticate() can also reject with urn:radiumone:payment-gateway:authentication-required, urn:radiumone:payment-gateway:not-found or urn:radiumone:payment-gateway:checkout:tokenization-unavailable. elements.submit() raises them too, so they’re defined once, under Tokenization (bind) errors. This table covers what the SDK throws. Errors your server’s purchase or authorize call returns after 3D Secure (for example a ref that’s expired or a charged card token that isn’t the authenticated one) are listed under At charge time. For the recovery-action version of these codes, see Handle 3D Secure failures in Elements.

Next steps

Error object and handling

The ElementsError shape and the standard catch pattern.

SDK and integration errors

Integration codes thrown before you reach 3D Secure.

Tokenization errors

Bind-time gateway errors from submit().

Authentication results

What each status means — not an error.
Last modified on September 29, 2026