cURL
#!/usr/bin/env bash
# Status inquiry: returns the transaction as RadiumOne holds it (read-only).
# data.status PENDING or REVERSAL_PENDING = still resolving, ask again in 60
# seconds (stop after 60 minutes and contact Support); INCONSISTENT = under
# manual review, stop and contact Support; anything else is final.
set -euo pipefail
API_BASE="${RADIUMONE_API_BASE:-https://api-sandbox.radiumone.io/gateway}"
: "${RADIUMONE_ACCESS_TOKEN:?set RADIUMONE_ACCESS_TOKEN to a Bearer access token}"
: "${RADIUMONE_TRANSACTION_ID:?set RADIUMONE_TRANSACTION_ID to the transaction to inquire}"
curl -sS "$API_BASE/v1/transactions/$RADIUMONE_TRANSACTION_ID/status" \
-H "Authorization: Bearer $RADIUMONE_ACCESS_TOKEN"
#!/usr/bin/env python3
"""Status inquiry: returns the transaction as RadiumOne holds it (read-only,
no new row written). Branch on data.status: PENDING or REVERSAL_PENDING = still
resolving, ask again in 60 seconds (stop after 60 minutes and contact
Support); INCONSISTENT = under manual review, stop and contact Support;
anything else is final.
"""
import json
import os
import requests
API_BASE = os.environ.get("RADIUMONE_API_BASE", "https://api-sandbox.radiumone.io/gateway")
def inquire_transaction_status() -> dict:
transaction_id = os.environ["RADIUMONE_TRANSACTION_ID"]
resp = requests.get(
f"{API_BASE}/v1/transactions/{transaction_id}/status",
headers={"Authorization": f"Bearer {os.environ.get('RADIUMONE_ACCESS_TOKEN', '')}"},
timeout=30,
)
payload = resp.json()
if not resp.ok:
code = payload.get("type") or payload.get("code")
raise RuntimeError(f"status inquiry failed: {code} ({resp.status_code})")
status = payload["data"]["status"]
if status in ("PENDING", "REVERSAL_PENDING"):
return {"settled": False, "payload": payload} # ask again in 60 s
if status == "INCONSISTENT":
return {"settled": False, "contact_support": True, "payload": payload} # manual review
return {"settled": True, "payload": payload} # final: CAPTURED, AUTHORIZED, DECLINED, REVERSED, ...
if __name__ == "__main__":
print(json.dumps(inquire_transaction_status(), indent=2))
{
"status": "ok",
"request_id": "req_b2c3d4e5f6a2",
"data": {
"id": "8f1c2e10-4b3a-4c5d-9e6f-7a8b9c0d1e2f",
"request_id": "ord-1001-pay-1",
"type": "PURCHASE",
"status": "CAPTURED",
"amount": 5000,
"currency": "SGD",
"currency_minor_units": 2,
"payment_method_type": "card",
"order_reference": "ORD-1001",
"response_code": "00",
"auth_code": "A1B2C3",
"rrn": "427310000101",
"parent_transaction_id": null,
"switch_request_id": "sw-8f1c2e10",
"created_at": "2026-09-14T10:00:00.000Z",
"updated_at": "2026-09-14T10:00:01.000Z"
}
}{
"detail": "Request payload failed validation.",
"status": 400,
"title": "Validation Error",
"type": "urn:radiumone:payment-gateway:validation-error"
}{
"detail": "Missing or invalid Bearer token.",
"status": 401,
"title": "Authentication Required",
"type": "urn:radiumone:payment-gateway:authentication-required"
}{
"type": "urn:radiumone:payment-gateway:auth:insufficient-scope",
"title": "Insufficient Scope",
"status": 403,
"detail": "Token is missing the required scope 'payment-gateway:transaction-read'."
}{
"type": "urn:radiumone:payment-gateway:transaction-not-found",
"title": "Not Found",
"status": 404,
"detail": "Transaction '1b2c3d4e-5f60-4718-9a2b-3c4d5e6f7081' not found."
}{
"detail": "An unexpected error occurred.",
"status": 500,
"title": "Internal Server Error",
"type": "urn:radiumone:payment-gateway:internal-error"
}{
"detail": "A downstream dependency is unavailable or did not respond in time. `urn:radiumone:payment-gateway:service-unavailable` carries `retry_allowed` true when the failure came before any work (signing keys unavailable, service starting). `urn:radiumone:payment-gateway:request-deadline-exceeded` carries `retry_allowed` true only for GET/HEAD/OPTIONS -- a mutating request may have reached a host.",
"status": 503,
"title": "Service Unavailable",
"type": "urn:radiumone:payment-gateway:service-unavailable"
}Transaction status - Payments API
Check a transaction’s current status to recover after a timeout or follow a pending result. Read-only, so it never changes the transaction.
GET
/
v1
/
transactions
/
{transaction_id}
/
status
cURL
#!/usr/bin/env bash
# Status inquiry: returns the transaction as RadiumOne holds it (read-only).
# data.status PENDING or REVERSAL_PENDING = still resolving, ask again in 60
# seconds (stop after 60 minutes and contact Support); INCONSISTENT = under
# manual review, stop and contact Support; anything else is final.
set -euo pipefail
API_BASE="${RADIUMONE_API_BASE:-https://api-sandbox.radiumone.io/gateway}"
: "${RADIUMONE_ACCESS_TOKEN:?set RADIUMONE_ACCESS_TOKEN to a Bearer access token}"
: "${RADIUMONE_TRANSACTION_ID:?set RADIUMONE_TRANSACTION_ID to the transaction to inquire}"
curl -sS "$API_BASE/v1/transactions/$RADIUMONE_TRANSACTION_ID/status" \
-H "Authorization: Bearer $RADIUMONE_ACCESS_TOKEN"
#!/usr/bin/env python3
"""Status inquiry: returns the transaction as RadiumOne holds it (read-only,
no new row written). Branch on data.status: PENDING or REVERSAL_PENDING = still
resolving, ask again in 60 seconds (stop after 60 minutes and contact
Support); INCONSISTENT = under manual review, stop and contact Support;
anything else is final.
"""
import json
import os
import requests
API_BASE = os.environ.get("RADIUMONE_API_BASE", "https://api-sandbox.radiumone.io/gateway")
def inquire_transaction_status() -> dict:
transaction_id = os.environ["RADIUMONE_TRANSACTION_ID"]
resp = requests.get(
f"{API_BASE}/v1/transactions/{transaction_id}/status",
headers={"Authorization": f"Bearer {os.environ.get('RADIUMONE_ACCESS_TOKEN', '')}"},
timeout=30,
)
payload = resp.json()
if not resp.ok:
code = payload.get("type") or payload.get("code")
raise RuntimeError(f"status inquiry failed: {code} ({resp.status_code})")
status = payload["data"]["status"]
if status in ("PENDING", "REVERSAL_PENDING"):
return {"settled": False, "payload": payload} # ask again in 60 s
if status == "INCONSISTENT":
return {"settled": False, "contact_support": True, "payload": payload} # manual review
return {"settled": True, "payload": payload} # final: CAPTURED, AUTHORIZED, DECLINED, REVERSED, ...
if __name__ == "__main__":
print(json.dumps(inquire_transaction_status(), indent=2))
{
"status": "ok",
"request_id": "req_b2c3d4e5f6a2",
"data": {
"id": "8f1c2e10-4b3a-4c5d-9e6f-7a8b9c0d1e2f",
"request_id": "ord-1001-pay-1",
"type": "PURCHASE",
"status": "CAPTURED",
"amount": 5000,
"currency": "SGD",
"currency_minor_units": 2,
"payment_method_type": "card",
"order_reference": "ORD-1001",
"response_code": "00",
"auth_code": "A1B2C3",
"rrn": "427310000101",
"parent_transaction_id": null,
"switch_request_id": "sw-8f1c2e10",
"created_at": "2026-09-14T10:00:00.000Z",
"updated_at": "2026-09-14T10:00:01.000Z"
}
}{
"detail": "Request payload failed validation.",
"status": 400,
"title": "Validation Error",
"type": "urn:radiumone:payment-gateway:validation-error"
}{
"detail": "Missing or invalid Bearer token.",
"status": 401,
"title": "Authentication Required",
"type": "urn:radiumone:payment-gateway:authentication-required"
}{
"type": "urn:radiumone:payment-gateway:auth:insufficient-scope",
"title": "Insufficient Scope",
"status": 403,
"detail": "Token is missing the required scope 'payment-gateway:transaction-read'."
}{
"type": "urn:radiumone:payment-gateway:transaction-not-found",
"title": "Not Found",
"status": 404,
"detail": "Transaction '1b2c3d4e-5f60-4718-9a2b-3c4d5e6f7081' not found."
}{
"detail": "An unexpected error occurred.",
"status": 500,
"title": "Internal Server Error",
"type": "urn:radiumone:payment-gateway:internal-error"
}{
"detail": "A downstream dependency is unavailable or did not respond in time. `urn:radiumone:payment-gateway:service-unavailable` carries `retry_allowed` true when the failure came before any work (signing keys unavailable, service starting). `urn:radiumone:payment-gateway:request-deadline-exceeded` carries `retry_allowed` true only for GET/HEAD/OPTIONS -- a mutating request may have reached a host.",
"status": 503,
"title": "Service Unavailable",
"type": "urn:radiumone:payment-gateway:service-unavailable"
}Authorizations
Response
Successful Response
Standard success envelope. Every successful response has this shape, with the operation's own payload under data.
Correlation ID for this HTTP request, for logs and support. Send your own in the X-Request-Id header (letters, digits and hyphens, up to 36 characters -- other characters are stripped) or the gateway generates one. This is NOT the request_id idempotency key you send in a transaction body; the two are unrelated.