Skip to main content
GET
List localized Swapped payment methods

Headers

x-api-key
string

API key for authentication (omit when sending Authorization)

Example:

"your-api-key"

authorization
string

Bearer platform token (e.g. forwarded by user-service). Takes precedence over x-api-key when both are present.

Example:

"Bearer eyJhbGciOi..."

x-user-country
string

Trusted edge-resolved ISO country. When present it overrides body.baseCountry and x-client-ip, and enables country-specific payment-method validation.

Pattern: ^[A-Z]{2}$
Example:

"PH"

x-client-ip
string

The end user's IP address as observed by the edge, for edges that can name the IP but cannot resolve a country themselves (no local GeoIP database). Used only when x-user-country is absent, and ignored unless it is a publicly-routable address. Prefer x-user-country when your edge already has a country — for example Cloudflare's cf-ipcountry — since it needs no lookup here.

Example:

"203.0.113.7"

Response

Localized payment methods or the generic fallback

country
string | null
required

ISO-3166-1 alpha-2 country code

Pattern: ^[A-Z]{2}$
Example:

"US"

methods
object[]
required