Payment method errors - Payments API

You’ll hit these on payment-method discovery, UOB Rewards loyalty redemption and balance calls, and any operation a terminal can’t currently route or a token can’t support. Branch on the problem+json type URN and HTTP status returned in the body — never on title. See Problem format and retries for the response shape, the full HTTP status guide, and retry rules; the Retry? column below is that same per-status rule applied to each error.

Loyalty (UOB Rewards)

See Handle UOB Rewards void and refund restrictions, Handle UOB Rewards redemption failures, and Balance inquiry for where these surface.

URN	HTTP	Meaning	What to do	Retry?
`urn:radiumone:transaction:single-leg-void-forbidden`	409	Can’t void one leg of a loyalty-grouped sale on its own	Handle UOB Rewards void and refund restrictions	Depends — see Retry rules
`urn:radiumone:transaction:product-not-supported`	422	e.g. refunding a loyalty leg directly	Handle UOB Rewards void and refund restrictions	No
`urn:radiumone:transaction:loyalty-leg-required`	422	Purchase sent `loyalty`, but the routed acquirer has no loyalty leg	Handle UOB Rewards redemption failures	No
`urn:radiumone:loyalty:redemption-kind-not-supported`	422	`kind: voucher\|coupon` is schema-accepted but not dispatchable	Handle UOB Rewards redemption failures	No
`urn:radiumone:loyalty:validation-disabled`	403	Programme validation is off for your outlet	Contact support	No
`urn:radiumone:loyalty:terminal-unknown`	404	Terminal not provisioned on the loyalty host	Contact support	No
`urn:radiumone:loyalty:device-not-validated`	409	The device is set up but hasn’t been validated as configured and ready to accept loyalty transactions	Contact support to validate the device	No — not until support has validated the device
`urn:radiumone:loyalty:param-download-failed`	503	Loyalty host transport failure	Retry later	Yes — after a delay

Discovery

GET /v1/payment-methods and GET /v1/payment-brands — see Show payment methods at checkout.

URN	HTTP	Meaning	Retry?
`urn:radiumone:checkout:origin-not-allowed`	403	A publishable-key caller’s `Origin` header isn’t on your allow-list	No
`urn:radiumone:checkout:outlet-not-found`	404	Unknown `outlet_id`	No
`urn:radiumone:checkout:currency-not-supported`	422	No candidate acquirer for that currency	No
`urn:radiumone:checkout:no-candidates`	404	No payment methods configured for this combination	No

Routing and capability

These occur when no acquirer terminal can currently handle the operation you requested — distinct from a card decline, which always requires a live terminal to have been reached. See Fix operations unavailable for your outlet for the full walkthrough.

URN	HTTP	Resolution	Meaning	What to do
`urn:radiumone:routing:operation-disabled`	409	`operator`	Every candidate terminal has this operation toggled off	Contact support to enable it, or don’t attempt the operation for this outlet
`urn:radiumone:routing:no-device-available` / `urn:radiumone:routing:terminal-inactive`	409	varies	No usable terminal could be routed for this request	Retry later if `resolution` is `transient`; contact support if it’s `operator`
`urn:radiumone:device:operation-not-supported`	422	—	The terminal that was routed has this specific operation toggled off	Same as above
`urn:radiumone:routing:capability-not-supported`	422	—	The acquirer channel a follow-up operation (capture/void/refund) inherits from its original doesn’t have that operation enabled — most often seen on refunds, which are disabled by default	Contact support to enable the operation for that acquirer channel

Tokens

See Elements: expired sessions and tokens.

URN	HTTP	Meaning	What to do	Retry?
`urn:radiumone:token:transient-expired` / `urn:radiumone:token:data-purged`	410	The bind token lapsed (about 30 minutes) before you charged it	Re-tokenize the card. See Elements: expired sessions and tokens	No

Next steps

Problem format and retries

The problem+json shape, HTTP status guide, and retry rules.

Payment operation errors

Auth, validation, idempotency, transaction-state, and reversal errors.

Decline codes

How a declined payment appears — that’s not an error.

Handle failures

Find the right recovery page by symptom.

Introduction

Guides

Payment methods

3D Secure

Handle failures

Webhooks

Errors

Reference

Payment method errors - Payments API

Loyalty (UOB Rewards)

Discovery

Routing and capability

Tokens

Next steps

Problem format and retries

Payment operation errors

Decline codes

Handle failures

​Loyalty (UOB Rewards)

​Discovery

​Routing and capability

​Tokens

​Next steps

Problem format and retries

Payment operation errors

Decline codes

Handle failures

Loyalty (UOB Rewards)

Discovery

Routing and capability

Tokens

Next steps