#!/usr/bin/env bash
# Live acquirer status inquiry for a transaction (no new row written). Use
# this to recover after a timeout instead of guessing the outcome.
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
"""Live acquirer status inquiry for a transaction (no new row written). Use
this to recover after a timeout instead of guessing the outcome.
"""
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})")
return payload # branch on data.status
if __name__ == "__main__":
print(json.dumps(inquire_transaction_status(), indent=2))
{
"status": "ok",
"request_id": "req_b2c3d4e5f6a2",
"data": {
"request_id": "ord-1001-pay-1",
"inquiry_type": "status",
"success": true,
"response_code": "00",
"status": "success",
"switch_request_id": "sw-8f1c2e10"
}
}{
"detail": "Missing or invalid Bearer token.",
"status": 401,
"title": "Authentication Required",
"type": "urn:radiumone:gateway:authentication-required"
}{
"detail": "Insufficient permissions for this operation.",
"status": 403,
"title": "Permission Denied",
"type": "urn:radiumone:gateway:permission-denied"
}{
"detail": "The requested resource does not exist.",
"status": 404,
"title": "Not Found",
"type": "urn:radiumone:gateway:not-found"
}{
"detail": "An unexpected error occurred.",
"status": 500,
"title": "Internal Server Error",
"type": "urn:radiumone:gateway:internal-server-error"
}Transaction status - Payments API
Check a transaction’s live status with the acquirer that processed it. This is a read-only inquiry that doesn’t change the transaction.
#!/usr/bin/env bash
# Live acquirer status inquiry for a transaction (no new row written). Use
# this to recover after a timeout instead of guessing the outcome.
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
"""Live acquirer status inquiry for a transaction (no new row written). Use
this to recover after a timeout instead of guessing the outcome.
"""
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})")
return payload # branch on data.status
if __name__ == "__main__":
print(json.dumps(inquire_transaction_status(), indent=2))
{
"status": "ok",
"request_id": "req_b2c3d4e5f6a2",
"data": {
"request_id": "ord-1001-pay-1",
"inquiry_type": "status",
"success": true,
"response_code": "00",
"status": "success",
"switch_request_id": "sw-8f1c2e10"
}
}{
"detail": "Missing or invalid Bearer token.",
"status": 401,
"title": "Authentication Required",
"type": "urn:radiumone:gateway:authentication-required"
}{
"detail": "Insufficient permissions for this operation.",
"status": 403,
"title": "Permission Denied",
"type": "urn:radiumone:gateway:permission-denied"
}{
"detail": "The requested resource does not exist.",
"status": 404,
"title": "Not Found",
"type": "urn:radiumone:gateway:not-found"
}{
"detail": "An unexpected error occurred.",
"status": 500,
"title": "Internal Server Error",
"type": "urn:radiumone:gateway:internal-server-error"
}Authorizations
Bearer access token from POST /v1/auth/token. Treat it as an opaque string — do not depend on its internal encoding, which has changed before and isn't part of the contract.
Path Parameters
UUID of the transaction to query.
Response
Successful Response
Standard success envelope. Every successful response has this shape, with the operation's own payload under data.
The operation's result. Its shape is documented per operation; omitted on responses that carry no payload.
Show child attributes
Show child attributes
Optional human-readable note. Omitted from the response when not set, which is the case for every payment operation today. Never parse it.
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.
Always ok on a successful (2xx) response. Errors use a different body shape entirely (RFC 9457 problem details), so branch on the HTTP status code, not on this field.