Skip to main content
GET
/
v1
/
checkouts
/
builder
/
settings
Fetch Styling & SDK Settings
curl --request GET \
  --url https://api.y.uno/v1/checkouts/builder/settings \
  --header 'PRIVATE-SECRET-KEY: <api-key>' \
  --header 'PUBLIC-API-KEY: <api-key>' \
  --header 'X-Account-Code: <api-key>'
{
  "styles": {
    "global": {
      "accent_color": "#282A30",
      "primary_background_color": "#FFFFFF",
      "primary_text_color": "#282A30",
      "primary_button_text_color": "#FFFFFF",
      "secondary_background_color": "#ECEFF2",
      "secondary_text_color": "#84807F",
      "secondary_button_background_color": "#FFFFFF",
      "secondary_button_text_color": "#282A30",
      "font_family": "Inter"
    },
    "header": {
      "logo_border_size": 0,
      "logo_border_color": "#282A30",
      "logo_corner_radius": 8,
      "font_size": 18,
      "font_weight": 700
    },
    "button": {
      "corner_radius": 8,
      "border_size": 0,
      "primary_border_color": "#282A30",
      "secondary_border_color": "#282A30",
      "font_size": 18,
      "font_weight": 400
    }
  },
  "settings": {
    "card": {
      "credit_card_only_processing": false,
      "default_network": "DOM",
      "enable_ocr": false,
      "enable_payment_retry": null,
      "save_on_success": false,
      "visualization_mode": "ONE_STEP"
    },
    "sdk_type": {
      "web": "SEAMLESS",
      "mobile": "SEAMLESS"
    },
    "web_sdk": {
      "render_mode": "MODAL",
      "hide_pay_button": true
    },
    "payment_method_list": {
      "unfolded_display": true,
      "condensed_checkout_view": false,
      "preselected_payment_method": false,
      "edit_payment_method_list": false,
      "blik_unfolded_display": null,
      "moon_active_experience": null
    },
    "payment_link": {
      "show_result_screen": false
    },
    "ui": {
      "dark_mode": false,
      "show_secure_payment_tag": true
    }
  },
  "payment_link_styles": {
    "panel": {
      "left": {
        "logo": null,
        "background": {
          "color": "#ECEFF2"
        }
      }
    },
    "checkbox": {
      "color": "#282A30"
    },
    "border": {
      "color": "#282A30"
    },
    "radio_button": {
      "color": "#282A30"
    },
    "button": {
      "background": {
        "color": "#282A30"
      },
      "text": {
        "color": "#FFFFFF"
      }
    }
  },
  "flags": {
    "force_default_styles": false
  },
  "external_fonts": [
    {
      "family_name": "Inter",
      "files": [
        {
          "url": "https://prod.y.uno/sdk-static-bundles-ms/v1/static/fonts/Inter-Regular.ttf",
          "weight": 400
        },
        {
          "url": "https://prod.y.uno/sdk-static-bundles-ms/v1/static/fonts/Inter-Medium.ttf",
          "weight": 500
        },
        {
          "url": "https://prod.y.uno/sdk-static-bundles-ms/v1/static/fonts/Inter-SemiBold.ttf",
          "weight": 600
        },
        {
          "url": "https://prod.y.uno/sdk-static-bundles-ms/v1/static/fonts/Inter-Bold.ttf",
          "weight": 700
        }
      ]
    }
  ]
}
This API is in Beta. Endpoints and schemas may change without prior notice.

Authorizations

PUBLIC-API-KEY
string
header
required

Merchant public API key. Found in Yuno dashboard → Settings → API Keys.

PRIVATE-SECRET-KEY
string
header
required

Merchant private secret key, paired with the public key. Never embed in client-side code.

X-Account-Code
string
header
required

UUID of the merchant account scope for the request.

Response

200

styles
object

Visual styles for the checkout SDK.

settings
object

SDK behavior and UI options.

Visual styles for the hosted Payment Link page. Independent from styles — does not inherit from it.

flags
object

Feature flags.

external_fonts
object[]

Font families available to the SDK. The default catalog includes 18 Yuno-hosted families (17 are constant; the 18th varies by account — run a GET to confirm the full list for your account). Custom entries can be added; they must be HTTPS and CORS-enabled.