Fetch Checkout Configuration
Retrieves the configuration of a checkout session by its checkout code
curl --request GET \
--url https://api.y.uno/v1/checkouts/{checkout_code} \
--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/{checkout_code}"
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/{checkout_code}', 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/{checkout_code}",
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/{checkout_code}"
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/{checkout_code}")
.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/{checkout_code}")
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{
"id": "8005ca91-dcfb-4428-b9f6-49c6e3446474",
"name": "Main Checkout",
"description": "",
"status": "PUBLISHED",
"is_default": true,
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-05-18T13:06:08Z",
"config": {
"payment_methods": [
{
"payment_method_type": "CARD",
"name": "Card",
"description": "Card",
"icon": "https://sdk.prod.y.uno/brands/card_logosimbolo.png",
"category": "CARD",
"short_name": "Card",
"hint": "",
"order_to_show": 1,
"is_active": true,
"type": "PAYMENT_METHOD",
"has_enrollment": true,
"conditions_quantity": 1,
"active_enrollment_type": "BOTH"
}
],
"general_settings": {
"country_documents": [
{
"country_code": "AR",
"documents": [
"DNI",
"CUIT"
]
}
]
},
"feature_flags": {
"custom_required_fields": true,
"custom_logo_icon": true
}
},
"styling": {
"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": {
"sdk_type": {
"web": "SEAMLESS",
"mobile": "SEAMLESS"
},
"card": {
"save_on_success": true,
"visualization_mode": "ONE_STEP",
"enable_ocr": false,
"credit_card_only_processing": false,
"default_network": "DOM"
},
"web_sdk": {
"render_mode": "MODAL",
"hide_pay_button": false
},
"payment_method_list": {
"unfolded_display": false,
"preselected_payment_method": false,
"condensed_checkout_view": false,
"edit_payment_method_list": false
},
"ui": {
"dark_mode": false,
"show_secure_payment_tag": true
},
"payment_link": {
"show_result_screen": false
}
},
"external_fonts": [
{
"family_name": "Inter",
"files": [
{
"weight": 400,
"url": "https://staging.y.uno/sdk-static-bundles-ms/v1/static/fonts/Inter-Regular.ttf"
}
]
}
],
"payment_link_styles": {
"panel": {
"left": {
"background": {
"color": "#ECEFF2"
},
"logo": "data:image/jpeg;base64,..."
}
},
"checkbox": {
"color": "#282A30"
},
"border": {
"color": "#282A30"
},
"radio_button": {
"color": "#282A30"
},
"button": {
"text": {
"color": "#876E6E"
},
"background": {
"color": "#282A30"
}
},
"published_at": "2026-05-14T19:34:06Z"
}
}
}{
"code": "INVALID_PARAMETERS",
"messages": [
"<string>"
]
}{
"code": "NOT_AUTHENTICATED",
"messages": [
"Not authenticated"
]
}{
"code": "<string>",
"messages": [
"<string>"
]
}styling.payment_link_styles.panel.left.logo returns the merchant logo as an embedded base64 data URI (e.g. data:image/jpeg;base64,...), not a URL.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. The tenant is resolved only from this header.
Path Parameters
The unique identifier of the checkout to retrieve (UUID, 36 chars). Non-UUID values are rejected with 400 before processing.
Response
The custom checkout, with configuration and styling composed.
Checkout UUID (the checkout_code).
"8005ca91-dcfb-4428-b9f6-49c6e3446474"
Checkout name.
"Main Checkout"
Checkout description.
Checkout status.
"PUBLISHED"
Whether this is the account's default checkout.
true
Creation timestamp (ISO 8601).
Last updated timestamp (ISO 8601).
Checkout configuration.
Show child attributes
Show child attributes
Checkout styling and SDK settings: styles, settings, external_fonts, payment_link_styles.
Was this page helpful?
curl --request GET \
--url https://api.y.uno/v1/checkouts/{checkout_code} \
--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/{checkout_code}"
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/{checkout_code}', 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/{checkout_code}",
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/{checkout_code}"
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/{checkout_code}")
.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/{checkout_code}")
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{
"id": "8005ca91-dcfb-4428-b9f6-49c6e3446474",
"name": "Main Checkout",
"description": "",
"status": "PUBLISHED",
"is_default": true,
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-05-18T13:06:08Z",
"config": {
"payment_methods": [
{
"payment_method_type": "CARD",
"name": "Card",
"description": "Card",
"icon": "https://sdk.prod.y.uno/brands/card_logosimbolo.png",
"category": "CARD",
"short_name": "Card",
"hint": "",
"order_to_show": 1,
"is_active": true,
"type": "PAYMENT_METHOD",
"has_enrollment": true,
"conditions_quantity": 1,
"active_enrollment_type": "BOTH"
}
],
"general_settings": {
"country_documents": [
{
"country_code": "AR",
"documents": [
"DNI",
"CUIT"
]
}
]
},
"feature_flags": {
"custom_required_fields": true,
"custom_logo_icon": true
}
},
"styling": {
"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": {
"sdk_type": {
"web": "SEAMLESS",
"mobile": "SEAMLESS"
},
"card": {
"save_on_success": true,
"visualization_mode": "ONE_STEP",
"enable_ocr": false,
"credit_card_only_processing": false,
"default_network": "DOM"
},
"web_sdk": {
"render_mode": "MODAL",
"hide_pay_button": false
},
"payment_method_list": {
"unfolded_display": false,
"preselected_payment_method": false,
"condensed_checkout_view": false,
"edit_payment_method_list": false
},
"ui": {
"dark_mode": false,
"show_secure_payment_tag": true
},
"payment_link": {
"show_result_screen": false
}
},
"external_fonts": [
{
"family_name": "Inter",
"files": [
{
"weight": 400,
"url": "https://staging.y.uno/sdk-static-bundles-ms/v1/static/fonts/Inter-Regular.ttf"
}
]
}
],
"payment_link_styles": {
"panel": {
"left": {
"background": {
"color": "#ECEFF2"
},
"logo": "data:image/jpeg;base64,..."
}
},
"checkbox": {
"color": "#282A30"
},
"border": {
"color": "#282A30"
},
"radio_button": {
"color": "#282A30"
},
"button": {
"text": {
"color": "#876E6E"
},
"background": {
"color": "#282A30"
}
},
"published_at": "2026-05-14T19:34:06Z"
}
}
}{
"code": "INVALID_PARAMETERS",
"messages": [
"<string>"
]
}{
"code": "NOT_AUTHENTICATED",
"messages": [
"Not authenticated"
]
}{
"code": "<string>",
"messages": [
"<string>"
]
}