curl --request PATCH \
--url https://api.y.uno/v1/checkouts/builder/settings \
--header 'Content-Type: application/json' \
--header 'PRIVATE-SECRET-KEY: <api-key>' \
--header 'PUBLIC-API-KEY: <api-key>' \
--header 'X-Account-Code: <api-key>' \
--data '
{
"styles": {
"global": {
"accent_color": "#1A73E8"
}
}
}
'{
"updated_at": "2026-05-18T14:00:00Z"
}{
"code": "INVALID_REQUEST",
"messages": [
"Invalid request"
]
}{
"code": "INVALID_CREDENTIALS",
"messages": [
"Invalid credentials"
]
}{
"code": "AUTHORIZATION_REQUIRED",
"messages": [
"The merchant has no authorization to use this API."
]
}Update Styling & SDK Settings
Updates styling and SDK configuration. The BFF deep-merges what you send with the existing config — only include the sections you want to change. Changes take effect immediately; there is no separate publish step.
curl --request PATCH \
--url https://api.y.uno/v1/checkouts/builder/settings \
--header 'Content-Type: application/json' \
--header 'PRIVATE-SECRET-KEY: <api-key>' \
--header 'PUBLIC-API-KEY: <api-key>' \
--header 'X-Account-Code: <api-key>' \
--data '
{
"styles": {
"global": {
"accent_color": "#1A73E8"
}
}
}
'{
"updated_at": "2026-05-18T14:00:00Z"
}{
"code": "INVALID_REQUEST",
"messages": [
"Invalid request"
]
}{
"code": "INVALID_CREDENTIALS",
"messages": [
"Invalid credentials"
]
}{
"code": "AUTHORIZATION_REQUIRED",
"messages": [
"The merchant has no authorization to use this API."
]
}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.
Headers
Client-generated UUID. Re-sending the same request with the same key is safe and will not double-publish.
Body
Visual styles for the checkout SDK. Send {} to leave unchanged.
Show child attributes
Show child attributes
SDK behavior and UI options. Send {} to leave unchanged.
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
Response
200
Timestamp of the update.
"2026-05-18T14:00:00Z"
Was this page helpful?