Checkout Builder
Fetch Checkout Configuration
Retrieves the configuration of a checkout session by its checkout code
GET
/
checkouts
/
{checkout_code}
Fetch Checkout Configuration
curl --request GET \
--url https://api-sandbox.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-sandbox.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-sandbox.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-sandbox.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-sandbox.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-sandbox.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-sandbox.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>"
]
}This API is in Beta. Endpoints and schemas may change without prior notice.
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
Path Parameters
Response
The custom checkout, with configuration and styling composed.
Was this page helpful?
⌘I
Fetch Checkout Configuration
curl --request GET \
--url https://api-sandbox.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-sandbox.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-sandbox.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-sandbox.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-sandbox.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-sandbox.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-sandbox.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>"
]
}