> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Subir el logo de un proveedor

> Sube tu propio logo para un proveedor propiedad de Yuno. La imagen viaja en base64 dentro de JSON, no como multipart.

Sube tu propio logo para este proveedor. La imagen viaja en **base64 dentro de JSON**, no como multipart.

> [!WARNING]
>
> Un logo es la identidad del proveedor y no su redacción, por lo que sigue la misma regla que `name`: se acepta **solo para proveedores propiedad de Yuno**, es decir, un id de catálogo que contiene `YUNO`, como `YUNO_3DS` o `YUNO_FRAUD_SCREENING`. Subir un logo para el proveedor de otra empresa se rechaza con `400`.

Escribir un logo no modifica el reemplazo de instrucciones ni agrega el proveedor a tu lista de permitidos.

### Requisitos de la imagen

| Regla | Detalle |
| - | - |
| Formato | PNG o JPEG, determinado por los **bytes del propio archivo**: un SVG renombrado como `.png` se rechaza. |
| Estructura | Cuadrada. Se dibuja en la misma caja fija que los íconos propios del catálogo. |
| Tamaño mínimo | 200x200 píxeles. |
| Tamaño máximo | 64 KB decodificado. |
| Cuerpo de la solicitud | Como máximo 256 KB, incluido el base64. Los cuerpos más grandes se rechazan con `413`. |

### Parámetros de ruta

**provider\_id** `string` *required*

Id de proveedor del catálogo de Yuno en UPPER\_SNAKE\_CASE, y debe ser un proveedor propiedad de Yuno (el id contiene `YUNO`). No distingue mayúsculas y minúsculas: se normaliza a mayúsculas.

### Cuerpo

**file\_name** `string` *required*

Nombre original del archivo, de máximo 255 caracteres. Se almacena solo para mostrarlo: el formato lo determinan los bytes, nunca esta extensión.

**base64\_data** `string` *required*

La imagen en sí, codificada en base64.

### Respuesta

**status** `string`

Siempre `stored` si la operación es exitosa.

La clave almacenada no se devuelve. Vuelve a leer el proveedor con [Consultar la capa de un proveedor](https://docs.y.uno/es/reference/organizations/whitelabel/retrieve-provider.md) para obtener un `logo_url` prefirmado nuevo, que es el único tipo de URL que existe para él.

```bash cURL theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
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>"
  }'
```

```json 200 OK theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "status": "stored"
}
```

```json 400 — image too small theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "title": "Invalid provider logo",
  "status": 400,
  "detail": "The logo was rejected",
  "violations": [
    "The logo must be at least 200x200 pixels. This image is 1x1."
  ]
}
```

> [!NOTE]
>
> `violations` enumera **todos** los problemas de la imagen a la vez (tamaño, forma y formato juntos), en lugar de uno por cada intento.

### Errores

| HTTP | Envoltorio | Cuándo |
| - | - | - |
| `400` | `VALIDATION_ERROR` | `provider_id` no es un id de catálogo válido. |
| `400` | problem+json | Se rechazó el logo: no es PNG/JPEG, no es cuadrado, es menor de 200x200, supera los 64 KB decodificado, falta un campo o el proveedor no es propiedad de Yuno. |
| `401` | `NOT_AUTHENTICATED` | Claves de API ausentes o no válidas. |
| `413` | — | Cuerpo de la solicitud mayor de 256 KB. |


## OpenAPI

````yaml openapi/es/organizations/whitelabel/upload-provider-logo.json PUT /whitelabel/providers/{provider_id}/logo
openapi: 3.1.0
info:
  title: White-label Providers API - Upload Logo
  version: 1.0.0
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - sec0: []
    sec1: []
paths:
  /whitelabel/providers/{provider_id}/logo:
    put:
      summary: Subir el logo de un proveedor
      description: >-
        Sube tu propio logo para este proveedor. La imagen viaja en base64
        dentro de JSON, no como multipart.


        Un logo es la identidad del proveedor y no su redacción, por lo que se
        rige por la misma regla que `name`: solo se acepta para proveedores
        propiedad de Yuno (un id de catálogo que contiene `YUNO`) y se rechaza
        con `400` para los de cualquier otra empresa. El archivo debe ser PNG o
        JPEG, lo cual se decide por los bytes del propio archivo y nunca por la
        extensión, así que un SVG renombrado como `.png` se rechaza, y debe ser
        cuadrado, de al menos 200x200 píxeles y de máximo 64 KB decodificado.
        Los rechazos enumeran todas las infracciones a la vez en `violations`.


        La clave almacenada no se devuelve: vuelve a leer el proveedor para
        obtener un `logo_url` prefirmado nuevo. Escribir un logo no modifica la
        anulación de instrucciones ni agrega el proveedor a tu lista de
        permitidos.
      operationId: upload-whitelabel-provider-logo
      parameters:
        - name: provider_id
          in: path
          required: true
          description: >-
            ID del proveedor del catálogo de Yuno en UPPER_SNAKE_CASE. No
            distingue mayúsculas de minúsculas; se normaliza a mayúsculas.
          schema:
            type: string
            example: YUNO_3DS
      requestBody:
        required: true
        description: El logo, codificado en base64.
        content:
          application/json:
            schema:
              type: object
              required:
                - file_name
                - base64_data
              properties:
                file_name:
                  type: string
                  maxLength: 255
                  description: >-
                    Nombre original del archivo, máximo 255 caracteres. Se
                    almacena solo para mostrarlo; el formato se decide por los
                    bytes, nunca por esta extensión.
                  example: acme-risk.png
                base64_data:
                  type: string
                  description: >-
                    La imagen, codificada en base64. Solo PNG o JPEG (se
                    verifica con los bytes mágicos del archivo), cuadrada, de al
                    menos 200x200 píxeles y de máximo 64 KB decodificada.
                  example: >-
                    iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==
      responses:
        '200':
          description: Logo almacenado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: Siempre `stored` cuando la operación es exitosa.
                    example: stored
        '400':
          description: >-
            El logo fue rechazado: provider_id inválido, no es PNG/JPEG, no es
            cuadrado, es menor de 200x200, supera los 64 KB decodificado o el
            proveedor no es propiedad de Yuno.
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    example: about:blank
                  title:
                    type: string
                    example: Invalid provider logo
                  status:
                    type: integer
                    example: 400
                  detail:
                    type: string
                    example: The logo was rejected
                  violations:
                    type: array
                    description: >-
                      Todas las infracciones de la solicitud, informadas juntas
                      en lugar de una por cada ida y vuelta.
                    items:
                      type: string
                    example:
                      - >-
                        The logo must be at least 200x200 pixels. This image is
                        1x1.
        '401':
          description: 'No autorizado: las claves de API no son válidas o faltan.'
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: NOT_AUTHENTICATED
                  messages:
                    type: array
                    items:
                      type: string
                    example:
                      - Not authenticated
        '413':
          description: El cuerpo de la solicitud supera los 256 KB.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: VALIDATION_ERROR
                  messages:
                    type: array
                    items:
                      type: string
                    example:
                      - Request body is too large
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: PUBLIC-API-KEY
      x-default: <Your PUBLIC-API-KEY>
    sec1:
      type: apiKey
      in: header
      name: PRIVATE-SECRET-KEY
      x-default: <Your PRIVATE-SECRET-KEY>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.