#!/usr/bin/env bash
# Discover payment brands/products and their features (3DS, loyalty) for a
# currency/channel/amount. Advisory only.
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 (secret or publishable)}"
curl -sS -G "$API_BASE/v1/payment-brands" \
-H "Authorization: Bearer $RADIUMONE_ACCESS_TOKEN" \
--data-urlencode "currency=SGD" \
--data-urlencode "channel=ECOMMERCE" \
--data-urlencode "amount=5000"
#!/usr/bin/env python3
"""Discover payment brands/products and their features (3DS, loyalty) for a
currency/channel/amount. Advisory only.
"""
import json
import os
import requests
API_BASE = os.environ.get("RADIUMONE_API_BASE", "https://api-sandbox.radiumone.io/gateway")
def list_payment_brands(currency: str = "SGD", channel: str = "ECOMMERCE", amount: int = 5000) -> dict:
resp = requests.get(
f"{API_BASE}/v1/payment-brands",
params={"currency": currency, "channel": channel, "amount": amount},
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"payment-brands failed: {code} ({resp.status_code})")
return payload
if __name__ == "__main__":
print(json.dumps(list_payment_brands(), indent=2))
{
"data": {
"channel": "<string>",
"currency": "<string>",
"evaluated_at": "<string>",
"outlet_id": "<string>",
"cache_hit": false,
"payment_methods": [
{
"display_name": "<string>",
"priority_rank": 123,
"type": "<string>",
"products": [
{
"code": "<string>",
"display_name": "<string>",
"priority_rank": 123,
"features": {}
}
]
}
]
},
"message": "<string>",
"request_id": "<string>",
"status": "ok"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"request_id": "<string>",
"code": "<string>",
"retry_allowed": true,
"errors": [
{
"pointer": "<string>",
"parameter": "<string>",
"code": "<string>",
"detail": "<string>"
}
]
}{
"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"
}List payment brands - Payments API
List the payment brands your merchant account supports — for example, to show accepted card brands before the shopper enters a card.
#!/usr/bin/env bash
# Discover payment brands/products and their features (3DS, loyalty) for a
# currency/channel/amount. Advisory only.
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 (secret or publishable)}"
curl -sS -G "$API_BASE/v1/payment-brands" \
-H "Authorization: Bearer $RADIUMONE_ACCESS_TOKEN" \
--data-urlencode "currency=SGD" \
--data-urlencode "channel=ECOMMERCE" \
--data-urlencode "amount=5000"
#!/usr/bin/env python3
"""Discover payment brands/products and their features (3DS, loyalty) for a
currency/channel/amount. Advisory only.
"""
import json
import os
import requests
API_BASE = os.environ.get("RADIUMONE_API_BASE", "https://api-sandbox.radiumone.io/gateway")
def list_payment_brands(currency: str = "SGD", channel: str = "ECOMMERCE", amount: int = 5000) -> dict:
resp = requests.get(
f"{API_BASE}/v1/payment-brands",
params={"currency": currency, "channel": channel, "amount": amount},
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"payment-brands failed: {code} ({resp.status_code})")
return payload
if __name__ == "__main__":
print(json.dumps(list_payment_brands(), indent=2))
{
"data": {
"channel": "<string>",
"currency": "<string>",
"evaluated_at": "<string>",
"outlet_id": "<string>",
"cache_hit": false,
"payment_methods": [
{
"display_name": "<string>",
"priority_rank": 123,
"type": "<string>",
"products": [
{
"code": "<string>",
"display_name": "<string>",
"priority_rank": 123,
"features": {}
}
]
}
]
},
"message": "<string>",
"request_id": "<string>",
"status": "ok"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"request_id": "<string>",
"code": "<string>",
"retry_allowed": true,
"errors": [
{
"pointer": "<string>",
"parameter": "<string>",
"code": "<string>",
"detail": "<string>"
}
]
}{
"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.
Query Parameters
Outlet UUID. Defaults to merchant's DEFAULT outlet.
ISO 4217 currency code (3 alpha chars).
3^[A-Za-z]{3}$Channel type: ECOMMERCE | CARD_PRESENT | MOBILE | etc.
Amount in smallest currency unit (optional).
x >= 0Response
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.