---
title: "List localized Swapped payment methods"
method: GET
path: "/onramp/swapped/payment-methods"
tags: ["Onramp"]
---

# List localized Swapped payment methods

`GET /onramp/swapped/payment-methods`

Returns the configured popular method (when merchant-enabled) followed by the supported subset of credit card, bank transfer, and Apple Pay for the trusted edge-resolved x-user-country. A missing/unknown country or unavailable catalog returns the null-country fallback so clients can use their built-in global defaults.

## Headers

- `x-api-key` string — API key for authentication (omit when sending Authorization)
- `authorization` string — Bearer platform token (e.g. forwarded by user-service). Takes precedence over `x-api-key` when both are present.
- `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.
- `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.

## Response `200`

Localized payment methods or the generic fallback

- SwappedPaymentMethodsResponse
  - `country` string, nullable, required — ISO-3166-1 alpha-2 country code
  - `methods` object[], required
    - `method` string, required
    - `label` string, required
    - `iconUrl` string, nullable, required
    - `iconUrlLight` string, nullable, required
    - `minAmount` number, nullable, required
    - `maxAmount` number, nullable, required
    - `badge` 'Popular', nullable, required
  - `recommendedMethod` string, nullable, required

## Other responses

- `400` — Invalid country header
- `401` — Authentication required or invalid credential
- `403` — API key lacks required deposits scope
- `503` — Swapped on-ramp is not configured

---

[API](https://skmtc.net/rhinestonewtf/apis/deposit-service-api.md) · [All operations](https://skmtc.net/rhinestonewtf/apis/deposit-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rhinestonewtf/deposit-service-api/versions/ce4e0abfe33a/schema)