cURL
#!/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": {
"loyalty": [
{
"club_code": "<string>",
"display_name": "<string>",
"pool_id": "<string>",
"type": "<string>"
}
]
}
}
]
}
]
},
"message": "<string>",
"request_id": "<string>",
"status": "ok"
}{
"detail": "Request payload failed validation.",
"status": 400,
"title": "Validation Error",
"type": "urn:radiumone:payment-gateway:validation-error"
}{
"detail": "Missing or invalid Bearer token, or `urn:radiumone:payment-gateway:authentication-required` because your merchant account is not active (suspended, disabled or deleted). Checked on every request, not only when the token is issued.",
"status": 401,
"title": "Authentication Required",
"type": "urn:radiumone:payment-gateway:authentication-required"
}{
"detail": "Insufficient permissions for this operation; `urn:radiumone:payment-gateway:auth:outlet-binding-violation` (the request's `outlet_id` differs from your key's bound outlet); `urn:radiumone:payment-gateway:checkout:origin-not-allowed` (payment-brands / payment-methods only: the browser Origin is not allowed); or `urn:radiumone:payment-gateway:merchant:outlet-disabled` (`retry_allowed: false`): the outlet -- named, key-bound or your DEFAULT -- is disabled.",
"status": 403,
"title": "Permission Denied",
"type": "urn:radiumone:payment-gateway:auth:outlet-binding-violation"
}{
"detail": "The requested resource does not exist, or `urn:radiumone:payment-gateway:checkout:outlet-not-found`: the outlet (named, key-bound, or your DEFAULT outlet) does not exist for your account. One answer on every surface (was 400 `payment-gateway:validation-error` on transactions).",
"status": 404,
"title": "Not Found",
"type": "urn:radiumone:payment-gateway:checkout:outlet-not-found"
}{
"detail": "`urn:radiumone:payment-gateway:checkout:currency-not-supported` (the currency is not enabled for this outlet). Currency: `urn:radiumone:payment-gateway:currency:unknown-currency` (the currency is well-formed but not an active ISO 4217 currency -- an unknown, fund, N.A. or withdrawn code; `errors[]` names the field, `retry_allowed: false`) or `urn:radiumone:payment-gateway:currency:minor-units-not-supported` (a valid ISO 4217 currency whose minor units are not 2, e.g. JPY or KWD -- only 2-decimal currencies are supported; `retry_allowed: false`).",
"status": 422,
"title": "Unprocessable Content",
"type": "urn:radiumone:payment-gateway:checkout:currency-not-supported"
}{
"detail": "An unexpected error occurred.",
"status": 500,
"title": "Internal Server Error",
"type": "urn:radiumone:payment-gateway:internal-error"
}{
"detail": "`urn:radiumone:payment-gateway:database-unavailable`: the database could not be reached or a query could not run. `retry_allowed` is true only for GET/HEAD/OPTIONS -- a mutating request may have reached a host before the failed write.",
"status": 503,
"title": "Database Unavailable",
"type": "urn:radiumone:payment-gateway:database-unavailable"
}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.
GET
/
v1
/
payment-brands
cURL
#!/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": {
"loyalty": [
{
"club_code": "<string>",
"display_name": "<string>",
"pool_id": "<string>",
"type": "<string>"
}
]
}
}
]
}
]
},
"message": "<string>",
"request_id": "<string>",
"status": "ok"
}{
"detail": "Request payload failed validation.",
"status": 400,
"title": "Validation Error",
"type": "urn:radiumone:payment-gateway:validation-error"
}{
"detail": "Missing or invalid Bearer token, or `urn:radiumone:payment-gateway:authentication-required` because your merchant account is not active (suspended, disabled or deleted). Checked on every request, not only when the token is issued.",
"status": 401,
"title": "Authentication Required",
"type": "urn:radiumone:payment-gateway:authentication-required"
}{
"detail": "Insufficient permissions for this operation; `urn:radiumone:payment-gateway:auth:outlet-binding-violation` (the request's `outlet_id` differs from your key's bound outlet); `urn:radiumone:payment-gateway:checkout:origin-not-allowed` (payment-brands / payment-methods only: the browser Origin is not allowed); or `urn:radiumone:payment-gateway:merchant:outlet-disabled` (`retry_allowed: false`): the outlet -- named, key-bound or your DEFAULT -- is disabled.",
"status": 403,
"title": "Permission Denied",
"type": "urn:radiumone:payment-gateway:auth:outlet-binding-violation"
}{
"detail": "The requested resource does not exist, or `urn:radiumone:payment-gateway:checkout:outlet-not-found`: the outlet (named, key-bound, or your DEFAULT outlet) does not exist for your account. One answer on every surface (was 400 `payment-gateway:validation-error` on transactions).",
"status": 404,
"title": "Not Found",
"type": "urn:radiumone:payment-gateway:checkout:outlet-not-found"
}{
"detail": "`urn:radiumone:payment-gateway:checkout:currency-not-supported` (the currency is not enabled for this outlet). Currency: `urn:radiumone:payment-gateway:currency:unknown-currency` (the currency is well-formed but not an active ISO 4217 currency -- an unknown, fund, N.A. or withdrawn code; `errors[]` names the field, `retry_allowed: false`) or `urn:radiumone:payment-gateway:currency:minor-units-not-supported` (a valid ISO 4217 currency whose minor units are not 2, e.g. JPY or KWD -- only 2-decimal currencies are supported; `retry_allowed: false`).",
"status": 422,
"title": "Unprocessable Content",
"type": "urn:radiumone:payment-gateway:checkout:currency-not-supported"
}{
"detail": "An unexpected error occurred.",
"status": 500,
"title": "Internal Server Error",
"type": "urn:radiumone:payment-gateway:internal-error"
}{
"detail": "`urn:radiumone:payment-gateway:database-unavailable`: the database could not be reached or a query could not run. `retry_allowed` is true only for GET/HEAD/OPTIONS -- a mutating request may have reached a host before the failed write.",
"status": 503,
"title": "Database Unavailable",
"type": "urn:radiumone:payment-gateway:database-unavailable"
}Authorizations
Query Parameters
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.