> ## 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.

# Recuperar la personalización de un proveedor

> Devuelve la personalización de tu organización sobre un único proveedor: si lo ofreces, y cualquier nombre, instrucciones, enlace de documentación y logo personalizados.

Devuelve la personalización de tu organización sobre un único proveedor: si lo ofreces, y cualquier nombre, instrucciones, enlace de documentación y logo personalizados.

> [!NOTE]
>
> **Este endpoint nunca devuelve `404`.** Un proveedor que nunca has modificado responde `200` con `allowed` y sin campos de personalización: exactamente lo que necesita un editor para mostrar un formulario vacío. Usa [Recuperar la personalización de instrucciones de un proveedor](https://docs.y.uno/es/reference/organizations/whitelabel/retrieve-provider-instructions.md) cuando necesites saber específicamente si existe una personalización.

Un campo **ausente** significa "conserva el valor del catálogo de Yuno para ese campo". Una personalización reemplaza un campo por completo y nunca se fusiona con él.

### Parámetros de ruta

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

Id del proveedor del catálogo de Yuno en UPPER\_SNAKE\_CASE (`STRIPE`, `ADYEN`, `YUNO_3DS`, …). No distingue mayúsculas de minúsculas: se normaliza a mayúsculas.

### Respuesta

**provider\_id** `string`

Id del proveedor del catálogo de Yuno, normalizado a mayúsculas.

**allowed** `boolean`

Indica si tu organización ofrece este proveedor.

**name** `string`

Nombre para mostrar que reemplaza al del catálogo, cuando está personalizado.

**instructions** `object[]`

Pasos de conexión que reemplazan a los del catálogo, cuando se personalizan.

**setup\_instructions** `object[]`

Pasos de configuración agrupados que reemplazan a los del catálogo, cuando se personalizan.

**more\_info\_url** `string`

Enlace de documentación que reemplaza al del catálogo, cuando está personalizado. Siempre https.

**logo\_url** `string`

Prefirmada en esta lectura, válida solo durante un período corto, y nunca la misma dos veces.

```bash cURL theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
curl -X GET 'https://api.y.uno/v1/whitelabel/providers/STRIPE' \
  -H 'public-api-key: <YOUR_PUBLIC_KEY>' \
  -H 'private-secret-key: <YOUR_SECRET_KEY>'
```

```json 200 OK — never touched theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "provider_id": "STRIPE",
  "allowed": false
}
```

```json 200 OK — customized theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "provider_id": "YUNO_3DS",
  "allowed": true,
  "name": "Acme Risk",
  "more_info_url": "https://docs.example.com/acme-risk",
  "logo_url": "https://s3.amazonaws.com/whitelabel/logo.png?X-Amz-Signature=..."
}
```

```json 400 Bad Request theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "code": "VALIDATION_ERROR",
  "messages": ["provider_id is invalid"]
}
```

> [!WARNING]
>
> `logo_url` se prefirma en cada lectura y caduca poco después. Muéstrala de inmediato; nunca la persistas ni la guardes en caché.

### Errores

| HTTP | `code` | Cuándo |
| - | - | - |
| `400` | `VALIDATION_ERROR` | `provider_id` no es un id de catálogo válido (`[A-Z0-9_]`, máximo 100 caracteres). |
| `401` | `NOT_AUTHENTICATED` | Faltan las claves de API o no son válidas. |


## OpenAPI

````yaml openapi/es/organizations/whitelabel/retrieve-provider.json GET /whitelabel/providers/{provider_id}
openapi: 3.1.0
info:
  title: White-label Providers API - Retrieve
  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}:
    get:
      summary: Obtener la superposición de un proveedor
      description: >-
        Devuelve la superposición de tu organización sobre un solo proveedor: si
        lo ofreces y cualquier nombre, instrucciones, enlace de documentación y
        logo personalizados.


        Nunca devuelve 404. Un proveedor que nunca modificaste responde `200`
        con `allowed` y sin campos de anulación: exactamente lo que necesita un
        editor para mostrar un formulario vacío. Un campo ausente significa
        "conservar el valor del catálogo de Yuno"; una anulación reemplaza un
        campo por completo y nunca se combina con él.


        `logo_url` se prefirma en esta lectura y dura poco: vuelve a leer el
        proveedor para obtener una URL nueva en lugar de almacenar esta.
      operationId: retrieve-whitelabel-provider
      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: STRIPE
      responses:
        '200':
          description: La superposición del proveedor.
          content:
            application/json:
              schema:
                type: object
                properties:
                  provider_id:
                    type: string
                    description: ID del proveedor del catálogo de Yuno, UPPER_SNAKE_CASE.
                    example: STRIPE
                  allowed:
                    type: boolean
                    description: Indica si la organización ofrece este proveedor.
                    example: true
                  name:
                    type: string
                    description: >-
                      Nombre visible que reemplaza al del catálogo, cuando se
                      personaliza. Solo los proveedores propiedad de Yuno pueden
                      tener uno.
                    example: Acme Risk
                  instructions:
                    type: array
                    description: >-
                      Pasos de conexión que reemplazan a los del catálogo,
                      cuando se personalizan. Si está ausente, se conservan los
                      del catálogo.
                    items:
                      type: object
                      additionalProperties: true
                      description: >-
                        Un paso de instrucciones. Acepta `step`, `text`,
                        `text_link`, `link`, `type`, `has_sub_instructions`,
                        `sub_instructions_type` y `sub_instructions` (anidados
                        hasta 3 niveles). `text` y `text_link` son una cadena
                        simple o un mapa de idiomas como `{"EN": "...", "ES":
                        "..."}`. Todo `link` debe ser https.
                  setup_instructions:
                    type: array
                    description: >-
                      Pasos de configuración agrupados que reemplazan a los del
                      catálogo, cuando se personalizan. Si está ausente, se
                      conservan los del catálogo.
                    items:
                      type: object
                      additionalProperties: true
                      description: >-
                        Un grupo de configuración. Acepta `title`, `order`,
                        `instructions_type` e `instructions` (la misma
                        estructura de paso).
                  more_info_url:
                    type: string
                    format: uri
                    description: >-
                      Enlace a la documentación que reemplaza al del catálogo,
                      cuando se personaliza. Siempre https.
                    example: https://docs.example.com/stripe
                  logo_url:
                    type: string
                    readOnly: true
                    description: >-
                      Solo lectura y efímera: una URL prefirmada generada en
                      esta lectura y válida solo durante una ventana corta.
                      Nunca la almacenes: vuelve a leer el proveedor para
                      obtener una nueva.
                    example: >-
                      https://s3.amazonaws.com/whitelabel/logo.png?X-Amz-Signature=...
        '400':
          description: provider_id no válido.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: VALIDATION_ERROR
                  messages:
                    type: array
                    items:
                      type: string
                    example:
                      - provider_id is invalid
        '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
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.