How it works
- A purchase or authorize request starts a transaction as
PENDING. - It resolves to
AUTHORIZED(authorize) orCAPTURED(purchase), or ends immediately asDECLINEDorFAILED. - An
AUTHORIZEDtransaction is captured (→CAPTURED), or lapses (→AUTH_EXPIRED) if it isn’t captured in time. You can’t void an uncaptured authorization — a void is refused with409 tx:invalid-state-transition— so a hold you don’t capture is released when its capture window runs out. - A
CAPTUREDtransaction can still be voided while its settlement batch is open, or moves on into settlement (SUBMITTED→SETTLING→SETTLED). - Once
SETTLED, a refund creates a new transaction rather than changing this one. - If a purchase, authorize, or referenced refund request times out and its outcome at the processor is unknown, RadiumOne reverses it automatically (
REVERSAL_PENDING→REVERSED) rather than leaving itFAILED— no merchant action needed. A capture or void that times out this way is reversed itself, not the transaction under it: the transaction readsREVERSAL_PENDING, then returns toAUTHORIZED(after a capture) orCAPTURED(after a void). The same happens to a sale the card network answered but whose result RadiumOne couldn’t save: it’s reversed, never left charged without a record.
AUTHORIZED and never reaches AUTH_EXPIRED. Its first answer is CAPTURED, DECLINED, FAILED, PENDING, or REVERSAL_PENDING; later it can move into settlement, to REVERSED or INCONSISTENT (after a timeout), or to VOIDED (a void before settlement).
Statuses
A decline is a normal 2xx response with
data.status: "DECLINED", not an HTTP error — see Charge or authorize a payment.
FAILED, and what it does and doesn’t mean
FAILED means the transaction did not complete — either the acquirer returned a non-decline error code, or RadiumOne couldn’t place the request at all. On a purchase, FAILED means the host didn’t approve it, so nothing was charged: retry with a new request_id if the shopper still wants to pay — unless response_code is "**", which means the request itself was rejected and needs fixing first. When the outcome is genuinely unknown after an upstream timeout, RadiumOne never leaves the transaction FAILED — it sets REVERSAL_PENDING and issues a compensating reversal automatically (see Understand automatic reversals), so keep checking the status while it’s PENDING or REVERSAL_PENDING. For any other operation, confirm a FAILED result with status inquiry before a new attempt.
Mechanically: an acquirer response code of 00 approves. A defined set of decline codes map to DECLINED. Every other non-00 code — including gateway- or host-level errors such as 91, 96, or 99 — maps to FAILED. So does RadiumOne’s own "**", set when the payment network rejected the request before it reached the acquirer. So FAILED isn’t a card decline, but on a purchase it still means nothing was approved.
INCONSISTENT is a rare row-level exception state, not the same thing as a settlement-batch rollup being indeterminate — if you ever see an unexpected aggregate state at the batch level, treat it the same way: contact support rather than guessing at the underlying transaction states.
Void or refund — not both
Void while the settlement batch is OPEN. Refund once it’s CLOSED. You can’t do either the other way around:
- Voiding a transaction whose batch has already closed returns
409 urn:radiumone:payment-gateway:tx:void-on-non-open-batch. - Refunding a transaction whose batch is still open returns
409 urn:radiumone:payment-gateway:tx:refund-on-open-batch.
GET /v1/transactions/{id}/status or a settlement.* webhook if you’re unsure which state you’re in. See Resolve void and refund conflicts if you hit either error.Settlement stages
Captured funds move through a settlement batch:SUBMITTED (queued), SETTLING (in progress at the acquirer), SETTLED (funds moved). See Settlement and reconciliation for batch webhooks and reconciliation.
Reversals
AREVERSAL_PENDING → REVERSED transition happens automatically when a request to the card network times out and its outcome is unknown, or when RadiumOne couldn’t save the network’s answer. You don’t request a reversal — RadiumOne resolves it and reports the final state through a webhook. The exception is a timed-out capture or void: when its reversal clears, the transaction is back in the status you already had (AUTHORIZED or CAPTURED) and no webhook is sent, so poll status. Treat REVERSAL_PENDING as “wait,” not as a failure.
Authorization expiry
AnAUTHORIZED transaction that isn’t captured within the capture window (7 days by default, configurable per acquirer) automatically lapses to AUTH_EXPIRED, which releases the hold and sends the authorization.expired webhook. This is the only way to release a hold you don’t capture — a void of an AUTHORIZED transaction is refused. Capturing after that point fails with 422 urn:radiumone:payment-gateway:tx:capture-window-expired — create a new authorization instead.
Next steps
Capture an authorization
Capture within the window, for the full authorized amount.
Void a payment
Cancel a captured payment while its batch is open.
Refund a payment
Return funds after the batch closes.
Settlement and reconciliation
Track batches end to end with webhooks.