Upload a Provider Logo - Yuno API Documentation

PUT

whitelabel

providers

{provider_id}

logo

Upload a Provider Logo

curl --request PUT \
  --url https://api-sandbox.y.uno/v1/whitelabel/providers/{provider_id}/logo \
  --header 'Content-Type: application/json' \
  --header 'PRIVATE-SECRET-KEY: <api-key>' \
  --header 'PUBLIC-API-KEY: <api-key>' \
  --data '
{
  "file_name": "acme-risk.png",
  "base64_data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
}
'

import requests

url = "https://api-sandbox.y.uno/v1/whitelabel/providers/{provider_id}/logo"

payload = {
    "file_name": "acme-risk.png",
    "base64_data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
}
headers = {
    "PUBLIC-API-KEY": "<api-key>",
    "PRIVATE-SECRET-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {
    'PUBLIC-API-KEY': '<api-key>',
    'PRIVATE-SECRET-KEY': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    file_name: 'acme-risk.png',
    base64_data: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=='
  })
};

fetch('https://api-sandbox.y.uno/v1/whitelabel/providers/{provider_id}/logo', 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/whitelabel/providers/{provider_id}/logo",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'file_name' => 'acme-risk.png',
    'base64_data' => 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=='
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "PRIVATE-SECRET-KEY: <api-key>",
    "PUBLIC-API-KEY: <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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.y.uno/v1/whitelabel/providers/{provider_id}/logo"

	payload := strings.NewReader("{\n  \"file_name\": \"acme-risk.png\",\n  \"base64_data\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("PUBLIC-API-KEY", "<api-key>")
	req.Header.Add("PRIVATE-SECRET-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api-sandbox.y.uno/v1/whitelabel/providers/{provider_id}/logo")
  .header("PUBLIC-API-KEY", "<api-key>")
  .header("PRIVATE-SECRET-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"file_name\": \"acme-risk.png\",\n  \"base64_data\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.y.uno/v1/whitelabel/providers/{provider_id}/logo")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["PUBLIC-API-KEY"] = '<api-key>'
request["PRIVATE-SECRET-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"file_name\": \"acme-risk.png\",\n  \"base64_data\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "stored"
}

{
  "type": "about:blank",
  "title": "Invalid provider logo",
  "status": 400,
  "detail": "The logo was rejected",
  "violations": [
    "The logo must be at least 200x200 pixels. This image is 1x1."
  ]
}

{
  "code": "NOT_AUTHENTICATED",
  "messages": [
    "Not authenticated"
  ]
}

{
  "code": "VALIDATION_ERROR",
  "messages": [
    "Request body is too large"
  ]
}

Uploads your own logo for this provider. The image travels base64 inside JSON, not multipart.

A logo is the provider’s identity rather than its wording, so it follows the same rule as name: it is accepted only for Yuno-owned providers — a catalogue id containing YUNO, such as YUNO_3DS or YUNO_FRAUD_SCREENING. Uploading a logo for anyone else’s provider is rejected with 400.

Writing a logo does not touch the instruction override, and does not add the provider to your allowlist.

Image requirements

Rule	Detail
Format	PNG or JPEG, decided by the file’s own bytes — an SVG renamed `.png` is refused.
Shape	Square. It is drawn into the same fixed box as the catalogue’s own icons.
Minimum size	200x200 pixels.
Maximum size	64 KB decoded.
Request body	At most 256 KB, base64 included. Larger bodies are rejected with `413`.

Path Parameters

string

required

Yuno catalogue provider id in UPPER_SNAKE_CASE, and it must be a Yuno-owned provider (the id contains YUNO). Case-insensitive — normalized to upper case.

Body

string

required

Original file name, at most 255 characters. Stored for display only — the format is decided by the bytes, never by this extension.

string

required

The image itself, base64-encoded.

Response

string

Always stored on success.

The stored key is not returned. Read the provider again with Retrieve a Provider Overlay to get a fresh presigned logo_url, which is the only kind of URL that exists for it.

curl -X PUT 'https://api.y.uno/v1/whitelabel/providers/YUNO_3DS/logo' \
  -H 'public-api-key: <YOUR_PUBLIC_KEY>' \
  -H 'private-secret-key: <YOUR_SECRET_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "file_name": "acme.png",
    "base64_data": "<BASE64_ENCODED_IMAGE>"
  }'

{
  "status": "stored"
}

{
  "title": "Invalid provider logo",
  "status": 400,
  "detail": "The logo was rejected",
  "violations": [
    "The logo must be at least 200x200 pixels. This image is 1x1."
  ]
}

violations lists every problem with the image at once — size, shape and format together — rather than one per round trip.

Errors

HTTP	Envelope	When
`400`	`VALIDATION_ERROR`	`provider_id` is not a valid catalogue id.
`400`	problem+json	The logo was rejected: not PNG/JPEG, not square, smaller than 200x200, larger than 64 KB decoded, a missing field, or the provider is not Yuno-owned.
`401`	`NOT_AUTHENTICATED`	Missing or invalid API keys.
`413`	—	Request body larger than 256 KB.

Authorizations

PUBLIC-API-KEY

string

header

default:<Your PUBLIC-API-KEY>

required

PRIVATE-SECRET-KEY

string

header

default:<Your PRIVATE-SECRET-KEY>

required

Path Parameters

provider_id

string

required

Yuno catalogue provider id in UPPER_SNAKE_CASE. Case-insensitive; normalized to upper case.

Example:

"YUNO_3DS"

Body

application/json

The logo, base64-encoded.

file_name

string

required

Original file name, at most 255 characters. Stored for display only; the format is decided by the bytes, never by this extension.

Maximum string length: 255

Example:

"acme-risk.png"

base64_data

string

required

The image itself, base64-encoded. PNG or JPEG only (checked against the file's magic bytes), square, at least 200x200 pixels and at most 64 KB decoded.

Example:

"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="

Response

Logo stored.

status

string

Always stored on success.

Example:

"stored"

⌘I

Upload a Provider Logo

curl --request PUT \
  --url https://api-sandbox.y.uno/v1/whitelabel/providers/{provider_id}/logo \
  --header 'Content-Type: application/json' \
  --header 'PRIVATE-SECRET-KEY: <api-key>' \
  --header 'PUBLIC-API-KEY: <api-key>' \
  --data '
{
  "file_name": "acme-risk.png",
  "base64_data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
}
'

import requests

url = "https://api-sandbox.y.uno/v1/whitelabel/providers/{provider_id}/logo"

payload = {
    "file_name": "acme-risk.png",
    "base64_data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
}
headers = {
    "PUBLIC-API-KEY": "<api-key>",
    "PRIVATE-SECRET-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {
    'PUBLIC-API-KEY': '<api-key>',
    'PRIVATE-SECRET-KEY': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    file_name: 'acme-risk.png',
    base64_data: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=='
  })
};

fetch('https://api-sandbox.y.uno/v1/whitelabel/providers/{provider_id}/logo', 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/whitelabel/providers/{provider_id}/logo",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'file_name' => 'acme-risk.png',
    'base64_data' => 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=='
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "PRIVATE-SECRET-KEY: <api-key>",
    "PUBLIC-API-KEY: <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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.y.uno/v1/whitelabel/providers/{provider_id}/logo"

	payload := strings.NewReader("{\n  \"file_name\": \"acme-risk.png\",\n  \"base64_data\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("PUBLIC-API-KEY", "<api-key>")
	req.Header.Add("PRIVATE-SECRET-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api-sandbox.y.uno/v1/whitelabel/providers/{provider_id}/logo")
  .header("PUBLIC-API-KEY", "<api-key>")
  .header("PRIVATE-SECRET-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"file_name\": \"acme-risk.png\",\n  \"base64_data\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.y.uno/v1/whitelabel/providers/{provider_id}/logo")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["PUBLIC-API-KEY"] = '<api-key>'
request["PRIVATE-SECRET-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"file_name\": \"acme-risk.png\",\n  \"base64_data\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "stored"
}

{
  "type": "about:blank",
  "title": "Invalid provider logo",
  "status": 400,
  "detail": "The logo was rejected",
  "violations": [
    "The logo must be at least 200x200 pixels. This image is 1x1."
  ]
}

{
  "code": "NOT_AUTHENTICATED",
  "messages": [
    "Not authenticated"
  ]
}

{
  "code": "VALIDATION_ERROR",
  "messages": [
    "Request body is too large"
  ]
}