Mint a signed Swapped widget URL (fiat on-ramp)
Returns a signed Swapped widget URL the modal embeds in an iframe for the fiat on-ramp. The destination asset is fixed server-side (the configured currency code); the caller supplies the smart account that receives the crypto. methodSelectionSource: "personalized" opts a trusted regional selection into strict merchant-catalog validation; fallback, configured, and legacy selections retain exact-method pass-through.
Headers
API key for authentication (omit when sending Authorization)
"your-api-key"
Bearer platform token (e.g. forwarded by user-service). Takes precedence over x-api-key when both are present.
"Bearer eyJhbGciOi..."
Trusted edge-resolved ISO country. When present it overrides body.baseCountry and x-client-ip, and enables country-specific payment-method validation.
^[A-Z]{2}$"PH"
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.
"203.0.113.7"
Body
Ethereum address (0x followed by 40 hex characters)
^0x[a-fA-F0-9]{40}$"0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91"
ISO-3166-1 alpha-2 country code
^[A-Z]{2}$"US"
ISO fiat currency code
^[A-Z]{3,4}$"USD"
Optional. Preselects a Swapped payment method (a payment_group) in the widget — e.g. "creditcard", "apple-pay", "bank-transfer", "skrill", "pix", "sepa-bank-transfer". Any Swapped-supported value is accepted and forwarded as-is; omit it to let Swapped auto-select the best method for the user based on their location and other signals. See Swapped's Get Payment Methods endpoint for the full, per-region list.
"apple-pay"
How the caller obtained method. Use personalized only for a method rendered from the regional payment-method response; with a trusted x-user-country, this opts into strict catalog validation. fallback, configured, and omission preserve the legacy exact-method pass-through behavior.
personalized, fallback, configured "personalized"