| — | urn:radiumone:elements:three-ds:invalid-context | No | The authenticate() argument is not an object. | Pass { sessionId, sessionSecret, cardToken }. |
| — | urn:radiumone:elements:three-ds:missing-session-id | No | sessionId is missing or empty. | Pass the same session_id used for submit(). |
| — | urn:radiumone:elements:three-ds:missing-session-secret | No | sessionSecret is missing or empty. | Pass the session_secret for the same session. |
| — | urn:radiumone:elements:three-ds:missing-card-token | No | cardToken is missing or empty. | Pass BindResult.token from a successful submit(). |
| — | urn:radiumone:elements:three-ds:missing-payment-method | No | selectedPaymentMethod is missing, empty or longer than 32 characters. | Pass the payment_methods[].type the shopper chose (for example card), from GET /gateway/v1/payment-methods or your POST /gateway/v1/sessions response. |
| — | urn:radiumone:elements:three-ds:invalid-purpose | No | purpose is set to something other than payment or non_payment. | Omit purpose for a payment, or pass non_payment to verify the cardholder without a payment. |
| — | urn:radiumone:elements:three-ds:invalid-action | No | The handle() argument is not a gateway action object with a string type. | Pass the gateway 3DS action unchanged. |
| — | urn:radiumone:elements:three-ds:in-progress | No | A 3DS flow is already running on this ThreeDS instance. | Wait for the running flow to settle, or use a separate instance for a parallel flow. |
| — | urn:radiumone:elements:three-ds:cancelled | Yes | The AbortSignal passed in options was aborted. | Do not authorize. The shopper may start 3DS again. |
| — | urn:radiumone:elements:three-ds:challenge-timeout | Yes | No terminal status within the challenge or decoupled window (at most 5 minutes), or within 30 seconds of resume() on a redirect return page (the pending reference is kept). A CSP connect-src that blocks the gateway API origin also ends here. | Do not authorize. Offer to start 3DS again; from resume(), call resume() again first (the reference is kept and the authentication may have succeeded). Check connect-src if it happens every time. |
| — | urn:radiumone:elements:three-ds:provider-unavailable | No | The 3DS gateway call failed without a usable response (network error, timeout, empty 5xx, or a malformed body, including a 2xx without the gateway success envelope). The outcome is unknown. | Do not authorize. Check the 3DS status server-side before retrying. |
| — | urn:radiumone:elements:three-ds:action-not-found | No | 404 from the 3DS continue or status call: the action reference is unknown, purged or another merchant’s, or the endpoint is not deployed. | Do not authorize. Start a new 3DS attempt. |
| — | urn:radiumone:elements:three-ds:unsupported-action | No | The gateway returned an action type this SDK version does not know. | Do not authorize. Upgrade the SDK. |
| — | urn:radiumone:elements:three-ds:action-malformed | No | A gateway action is missing required fields, or a status read or terminal action carries a status outside the documented set; or resume() found no pending redirect. | Do not authorize. On a return page, only call resume() when getPendingRedirect() is non-null. |
| — | urn:radiumone:elements:three-ds:render-mode-unsupported | No | The gateway sent a gateway_hosted challenge, which this SDK does not support. | Do not authorize. Contact support. |
| — | urn:radiumone:elements:three-ds:challenge-display-unsupported | No | challengePresentation ‘redirect’ was requested but the challenge is not redirectable or returnUrl is missing. | Pass returnUrl, or use challengePresentation ‘auto’ or ‘iframe’. |
| — | urn:radiumone:elements:three-ds:http-{status} | Varies (gateway) | A 3DS gateway call failed with a JSON body but no URN. retryAllowed is the body’s retry_allowed, else true for 5xx. | Do not authorize. Retry only when retryAllowed is true. |
| 429 | urn:radiumone:payment-gateway:rate-limit-exceeded | Varies (gateway) | 3DS request rate limit hit. Status polling retries it automatically; other calls reject. | Wait retryAfter seconds, then retry. |
| 429 | urn:radiumone:payment-gateway:three-ds:session-attempts-exceeded | Varies (gateway) | The session’s 3DS attempt budget is spent. Every authenticate request counts, including one that then fails a later check. | Do not authorize. Create a new session. |
| 422 | urn:radiumone:payment-gateway:three-ds:card-attempts-exceeded | Varies (gateway) | A purpose ‘non_payment’ authentication for a card that has used all of its non-payment issuer challenges in this checkout session (when the gateway’s per-card limit is enabled). ThreeDSResult.cardAttemptsRemaining reaching 0 means the next one is refused. | Do not retry this card for non-payment verification. Ask the shopper for another card. |
| 403 | urn:radiumone:payment-gateway:auth:three-ds-browser-unauthorized | Varies (gateway) | Authenticate request: missing header; publishable key unknown, revoked, expired or its merchant not active; session_id unknown, expired or another merchant’s; session secret wrong or missing; or an X-RadiumOne-Session-Id header that disagrees with the body. Continue: publishable key missing or unusable. Fixed detail, no retry_allowed. | Do not authorize. Check the publishable key and that sessionId and sessionSecret come from the same POST /gateway/v1/sessions; otherwise create a new session. |
| 400 | urn:radiumone:payment-gateway:token:revoked | Varies (gateway) | The card token has been revoked. | Do not authorize. Re-bind the card with elements.submit() and authenticate again. |
| 410 | urn:radiumone:payment-gateway:token:transient-expired | Varies (gateway) | The transient card token has expired (tokens live about 30 minutes). | Do not authorize. Re-bind the card with elements.submit() and authenticate again. |
| 410 | urn:radiumone:payment-gateway:token:data-purged | Varies (gateway) | The card token’s data has been purged. | Do not authorize. Re-bind the card with elements.submit() and authenticate again. |
| 422 | urn:radiumone:payment-gateway:three-ds:card-token-invalid | Varies (gateway) | cardToken is not valid for this session. | Pass the BindResult.token from this session’s submit(). |
| 422 | urn:radiumone:payment-gateway:three-ds:session-not-amount-bound | Varies (gateway) | The session carries no net payable amount. A gross order total alone is not used. | Set the net payable amount on the session (PATCH /gateway/v1/sessions/{id}) from your server before calling authenticate(). |
| 400 | urn:radiumone:payment-gateway:validation-error | Varies (gateway) | The session’s outlet has no channel of the requested type, or the card token is missing or malformed. | Do not authorize. Contact support to configure the outlet channel. |
| 403 | urn:radiumone:payment-gateway:merchant:outlet-disabled | Varies (gateway) | The session’s outlet (or the merchant’s default outlet) is disabled. | Do not authorize. The outlet must be re-enabled. |
| 403 | urn:radiumone:payment-gateway:token:merchant-mismatch | Varies (gateway) | The card token belongs to another merchant. | Do not authorize. Re-bind the card with this merchant’s session. |
| 404 | urn:radiumone:payment-gateway:checkout:outlet-not-found | Varies (gateway) | The session’s outlet no longer resolves, or the merchant has no default outlet. | Do not authorize. Create a new session. |
| 409 | urn:radiumone:payment-gateway:routing:channel-disabled | Varies (gateway) | The outlet’s channel is disabled. | Do not authorize. The channel must be re-enabled. |
| 422 | urn:radiumone:payment-gateway:checkout:payment-method-not-offered | Varies (gateway) | selected_payment_method is not a catalog code (reason: unknown) or is not offered for this outlet and channel (reason: not_offered). | Do not authorize. Use a payment_methods[].type from GET /gateway/v1/payment-methods for this checkout. |
| 422 | urn:radiumone:payment-gateway:checkout:payment-method-required | Varies (gateway) | selected_payment_method is missing and the gateway requires it (rollout toggle on). The SDK checks for it locally first. | Do not authorize. Contact support. |
| 422 | urn:radiumone:payment-gateway:routing:currency-not-allowed | Varies (gateway) | The session currency is not on the outlet’s or merchant’s allow-list. | Do not authorize. Use an allowed currency in a new session. |
| 422 | urn:radiumone:payment-gateway:routing:no-acquirer-available | Varies (gateway) | No acquirer can serve this card or sale (card scheme not supported, or no capable acquirer). | Do not authorize. Ask for another card. |
| 422 | urn:radiumone:payment-gateway:routing:no-rule-match | Varies (gateway) | No routing rule matched the sale. | Do not authorize. Contact support. |
| 422 | urn:radiumone:payment-gateway:routing:rule-rejected | Varies (gateway) | A matched routing rule rejects the sale. | Do not authorize. Ask for another card or contact support. |
| 409 | urn:radiumone:payment-gateway:loyalty:device-not-validated | Varies (gateway) | Redemption checkout only: the paired loyalty terminal is not validated. | Do not authorize. An operator must resolve it. |
| 409 | urn:radiumone:payment-gateway:routing:device-unpaired | Varies (gateway) | Redemption checkout only: no loyalty terminal is paired with the payment terminal. | Do not authorize. An operator must resolve it. |
| 409 | urn:radiumone:payment-gateway:routing:operation-disabled | Varies (gateway) | Redemption checkout only: redemption is switched off on the paired loyalty terminal. | Do not authorize. An operator must resolve it. |
| 409 | urn:radiumone:payment-gateway:settlement:device-batch-rejected | Varies (gateway) | Redemption checkout only: the paired loyalty terminal’s batch was rejected at settlement. | Do not authorize. An operator must resolve it. |
| 409 | urn:radiumone:payment-gateway:settlement:device-settling | Varies (gateway) | Redemption checkout only: the paired loyalty terminal is settling. | Retry shortly when retryAllowed is true. |
| 422 | urn:radiumone:payment-gateway:routing:capability-not-supported | Varies (gateway) | Redemption checkout only: the paired loyalty acquirer does not support redemption on this channel. | Do not authorize. Pay without redemption. |
| 422 | urn:radiumone:payment-gateway:transaction:loyalty-leg-required | Varies (gateway) | Redemption checkout only: no candidate acquirer has a usable loyalty pairing. | Do not authorize. Pay without redemption. |
| 503 | urn:radiumone:payment-gateway:routing:acquirer-circuit-open | Varies (gateway) | Every acquirer that could serve the sale (for a redemption checkout, every paired acquirer) is temporarily excluded by an open circuit breaker. Not limited to redemption checkout: the server-side purchase, authorize and refund APIs return it too. | Retry shortly when retryAllowed is true. |
| 503 | urn:radiumone:payment-gateway:three-ds:not-configured | Varies (gateway) | No eligible 3DS provider is configured, or its configuration is invalid. | Do not authorize. Contact support. |
| 503 | urn:radiumone:payment-gateway:three-ds:provider-unavailable | Varies (gateway) | The gateway could not reach the 3DS provider, or routing hit an upstream outage. Distinct from the SDK’s own urn:radiumone:elements:three-ds:provider-unavailable. | Do not authorize. Check the 3DS status server-side before retrying. |