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

# Listar la capa de proveedores white-label

> Devuelve la capa de tu organización sobre el catálogo de proveedores de Yuno: qué proveedores ofrece tu dashboard y los textos, enlaces y logos que definiste para ellos.

Devuelve la capa de tu organización sobre el catálogo de proveedores de Yuno: qué proveedores ofrece tu dashboard y los textos, enlaces y logos personalizados que definiste para ellos.

Es una **capa, no el catálogo**. Consulta el catálogo de proveedores por separado y combina esta capa encima: esta respuesta solo cubre los proveedores sobre los que has definido algo.

> [!NOTE]
>
> Esto filtra un selector. **No es autorización**: no impide que se cree una conexión con un proveedor que no ofreces.

### Respuesta

**filtered** `boolean`

Indica si tu organización tiene al menos una entrada en la lista de permitidos. `false` significa que una organización white-label no ofrece ningún proveedor por ahora (la lista de permitidos es opt-in), no que se ofrezca todo. **Decide según este campo, nunca según la longitud de `providers`**: la lista también tiene elementos cuando tus únicas entradas son reemplazos de instrucciones o de logos.

**providers** `object[]`

La unión de tu lista de permitidos, tus reemplazos de instrucciones y tus reemplazos de logos. Un proveedor puede tener textos o un logo personalizados sin ser ofrecido; en ese caso aparece aquí con `allowed: false`.

**elemento**

**provider\_id** `string`

Id de proveedor del catálogo de Yuno, UPPER\_SNAKE\_CASE.

**allowed** `boolean`

Indica si tu organización ofrece este proveedor.

**has\_instruction\_override** `boolean`

Indica si existe algún reemplazo de instrucciones. Es un indicador económico para una insignia: redundante con los campos de contenido de abajo y no es autoritativo para mostrarlos.

**name** `string`

Nombre visible que reemplaza al del catálogo, cuando hay reemplazo. Si está ausente, se mantiene el del catálogo.

**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 y de corta duración. Nunca la almacenes: vuelve a leer para obtener una nueva.

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

```json 200 OK — with an allowlist theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "filtered": true,
  "providers": [
    {
      "provider_id": "ADYEN",
      "allowed": true,
      "has_instruction_override": false
    },
    {
      "provider_id": "STRIPE",
      "allowed": true,
      "has_instruction_override": true,
      "more_info_url": "https://docs.example.com/stripe"
    },
    {
      "provider_id": "YUNO_3DS",
      "allowed": false,
      "has_instruction_override": false,
      "logo_url": "https://s3.amazonaws.com/whitelabel/logo.png?X-Amz-Signature=..."
    }
  ]
}
```

```json 200 OK — no allowlist theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "filtered": false,
  "providers": []
}
```

```json 401 Unauthorized theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "code": "NOT_AUTHENTICATED",
  "messages": ["Not authenticated"]
}
```

> [!NOTE]
>
> `YUNO_3DS` en el ejemplo anterior **no se ofrece** (`allowed: false`) y aun así aparece, porque tiene un logo personalizado. Por eso `allowed` debe leerse por proveedor y no inferirse del contenido de la lista.

### Errores

| HTTP | `code` | Cuándo |
| - | - | - |
| `401` | `NOT_AUTHENTICATED` | Claves de API ausentes o no válidas. |


## OpenAPI

````yaml openapi/es/organizations/whitelabel/list-providers.json GET /whitelabel/providers
openapi: 3.1.0
info:
  title: White-label Providers API - List
  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:
    get:
      summary: Listar la capa de proveedores white-label
      description: >-
        Devuelve la capa de tu organización sobre el catálogo de proveedores de
        Yuno: qué proveedores ofrece tu dashboard y la redacción, los enlaces y
        los logotipos personalizados que configuraste para ellos. Es una capa,
        no el catálogo: únela al catálogo de proveedores en lugar de leerla como
        la lista de proveedores.


        Bifurca según `filtered`, nunca según la longitud de `providers`: un
        proveedor con redacción personalizada pero sin entrada en la lista de
        permitidos aparece aquí con `allowed: false`.


        Esto filtra un selector. No es autorización y no impide que se cree una
        conexión con un proveedor que no ofreces.
      operationId: list-whitelabel-providers
      responses:
        '200':
          description: La capa de proveedores de la organización.
          content:
            application/json:
              schema:
                type: object
                properties:
                  filtered:
                    type: boolean
                    description: >-
                      Indica si la organización tiene al menos una entrada en la
                      lista de permitidos. `false` significa que una
                      organización white-label actualmente no ofrece ningún
                      proveedor (la lista de permitidos es opt-in), no que se
                      ofrezca todo. Bifurca según este campo, nunca según la
                      longitud de `providers`: la lista también tiene elementos
                      cuando las únicas entradas son personalizaciones de
                      instrucciones o logotipos.
                    example: true
                  providers:
                    type: array
                    description: >-
                      La unión de la lista de permitidos, las personalizaciones
                      de instrucciones y las personalizaciones de logotipos. Un
                      proveedor puede tener redacción o logotipo personalizado
                      sin ser ofrecido, en cuyo caso aparece con `allowed:
                      false`.
                    items:
                      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
                        has_instruction_override:
                          type: boolean
                          description: >-
                            Indica si existe alguna personalización de
                            instrucciones. Es una marca económica para
                            insignias, redundante con los campos de contenido y
                            no autoritativa para mostrarlos.
                          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=...
        '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.