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>'import requests
url = "https://api.y.uno/v1/checkouts/builder/settings"
headers = {
"PUBLIC-API-KEY": "<api-key>",
"PRIVATE-SECRET-KEY": "<api-key>",
"X-Account-Code": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'PUBLIC-API-KEY': '<api-key>',
'PRIVATE-SECRET-KEY': '<api-key>',
'X-Account-Code': '<api-key>'
}
};
fetch('https://api.y.uno/v1/checkouts/builder/settings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.y.uno/v1/checkouts/builder/settings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"PRIVATE-SECRET-KEY: <api-key>",
"PUBLIC-API-KEY: <api-key>",
"X-Account-Code: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.y.uno/v1/checkouts/builder/settings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("PUBLIC-API-KEY", "<api-key>")
req.Header.Add("PRIVATE-SECRET-KEY", "<api-key>")
req.Header.Add("X-Account-Code", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.y.uno/v1/checkouts/builder/settings")
.header("PUBLIC-API-KEY", "<api-key>")
.header("PRIVATE-SECRET-KEY", "<api-key>")
.header("X-Account-Code", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.y.uno/v1/checkouts/builder/settings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["PUBLIC-API-KEY"] = '<api-key>'
request["PRIVATE-SECRET-KEY"] = '<api-key>'
request["X-Account-Code"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
}
]
}
]
}{
"code": "INVALID_CREDENTIALS",
"messages": [
"Invalid credentials"
]
}{
"code": "AUTHORIZATION_REQUIRED",
"messages": [
"The merchant has no authorization to use this API."
]
}Styling & SDK Settings
Fetch Styling & SDK Settings
Returns the full styling and SDK configuration — colors, fonts, button shapes, SDK render mode, payment-method-list layout, dark mode, Payment Link branding, and the available font catalog.
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>'import requests
url = "https://api.y.uno/v1/checkouts/builder/settings"
headers = {
"PUBLIC-API-KEY": "<api-key>",
"PRIVATE-SECRET-KEY": "<api-key>",
"X-Account-Code": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'PUBLIC-API-KEY': '<api-key>',
'PRIVATE-SECRET-KEY': '<api-key>',
'X-Account-Code': '<api-key>'
}
};
fetch('https://api.y.uno/v1/checkouts/builder/settings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.y.uno/v1/checkouts/builder/settings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"PRIVATE-SECRET-KEY: <api-key>",
"PUBLIC-API-KEY: <api-key>",
"X-Account-Code: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.y.uno/v1/checkouts/builder/settings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("PUBLIC-API-KEY", "<api-key>")
req.Header.Add("PRIVATE-SECRET-KEY", "<api-key>")
req.Header.Add("X-Account-Code", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.y.uno/v1/checkouts/builder/settings")
.header("PUBLIC-API-KEY", "<api-key>")
.header("PRIVATE-SECRET-KEY", "<api-key>")
.header("X-Account-Code", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.y.uno/v1/checkouts/builder/settings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["PUBLIC-API-KEY"] = '<api-key>'
request["PRIVATE-SECRET-KEY"] = '<api-key>'
request["X-Account-Code"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
}
]
}
]
}{
"code": "INVALID_CREDENTIALS",
"messages": [
"Invalid credentials"
]
}{
"code": "AUTHORIZATION_REQUIRED",
"messages": [
"The merchant has no authorization to use this API."
]
}This API is in Beta. Endpoints and schemas may change without prior notice.
Authorizations
Merchant public API key. Found in Yuno dashboard → Settings → API Keys.
Merchant private secret key, paired with the public key. Never embed in client-side code.
UUID of the merchant account scope for the request.
Response
200
Visual styles for the checkout SDK.
Show child attributes
Show child attributes
SDK behavior and UI options.
Show child attributes
Show child attributes
Visual styles for the hosted Payment Link page. Independent from styles — does not inherit from it.
Show child attributes
Show child attributes
Feature flags.
Show child attributes
Show child attributes
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.
Show child attributes
Show child attributes
Was this page helpful?
⌘I