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

# Actualizar la visibilidad de varios proveedores

> Activa o desactiva los proveedores indicados en una sola solicitud, sin tocar a ningún otro proveedor.

Activa o desactiva los proveedores indicados en una sola solicitud. **Solo se modifican los proveedores que enumeras**: cualquier otro proveedor conserva lo que tenía, y eso es lo que lo diferencia de [Reemplazar la lista de proveedores permitidos](https://docs.y.uno/es/reference/organizations/whitelabel/replace-provider-allowlist.md).

Es idempotente, y desactivar un proveedor conserva su reemplazo de instrucciones.

> [!NOTE]
>
> Toda la solicitud se valida antes de escribir la primera fila: un `provider_id` repetido no cambia **nada**, en lugar de cambiar solo la mitad de lo que pediste.

### Cuerpo

**providers** `object[]` *required*

Los proveedores cuya visibilidad cambia en esta solicitud. Máximo 500 entradas, y cada `provider_id` puede aparecer como máximo una vez.

**elemento**

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

Id de proveedor del catálogo de Yuno en UPPER\_SNAKE\_CASE. No distingue mayúsculas y minúsculas: se normaliza a mayúsculas antes de la verificación de repetidos, por lo que `stripe` y `STRIPE` cuentan como la misma entrada.

**visible** `boolean` *required*

Indica si tu organización ofrece este proveedor. `visible: false` en un proveedor que no está en la lista de permitidos no tiene efecto.

### Respuesta

La capa actualizada, con la misma estructura que [Listar la capa de proveedores white-label](https://docs.y.uno/es/reference/organizations/whitelabel/list-providers.md).

**filtered** `boolean`

Indica si tu organización tiene al menos una entrada en la lista de permitidos, después de este cambio.

**providers** `object[]`

La unión de tu lista de permitidos, tus personalizaciones de instrucciones y tus personalizaciones de logo.

```bash cURL theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
curl -X PATCH 'https://api.y.uno/v1/whitelabel/providers' \
  -H 'public-api-key: <YOUR_PUBLIC_KEY>' \
  -H 'private-secret-key: <YOUR_SECRET_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "providers": [
      { "provider_id": "STRIPE", "visible": true },
      { "provider_id": "DLOCAL", "visible": false }
    ]
  }'
```

```json 200 OK 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"
    }
  ]
}
```

```json 400 — repeated provider_id theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "title": "Bad Request",
  "status": 400,
  "detail": "provider_id must appear at most once per request; repeated: STRIPE"
}
```

### Errores

| HTTP | Envoltorio | Cuándo |
| - | - | - |
| `400` | problem+json | Un `provider_id` aparece más de una vez, un id no es un id de catálogo válido, hay más de 500 entradas o hay un campo desconocido. |
| `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/update-providers-visibility.json PATCH /whitelabel/providers
openapi: 3.1.0
info:
  title: White-label Providers API - Bulk Update Visibility
  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:
    patch:
      summary: Actualizar la visibilidad de varios proveedores
      description: >-
        Activa o desactiva los proveedores indicados en una sola solicitud. Solo
        se modifican los proveedores listados: todos los demás conservan lo que
        tenían, y eso es lo que lo distingue de `PUT /v1/whitelabel/providers`.


        Cada id se normaliza y se revisa que no esté repetido antes de escribir
        la primera fila, por lo que una solicitud con un id repetido no cambia
        nada en lugar de cambiar solo una parte. Es idempotente, y al desactivar
        un proveedor se conserva su anulación de instrucciones.
      operationId: update-whitelabel-providers-visibility
      requestBody:
        required: true
        description: Los proveedores cuya visibilidad cambia.
        content:
          application/json:
            schema:
              type: object
              required:
                - providers
              properties:
                providers:
                  type: array
                  description: >-
                    Los proveedores cuya visibilidad cambia en esta solicitud.
                    Máximo 500 entradas, cada provider_id como máximo una vez.
                  maxItems: 500
                  items:
                    type: object
                    required:
                      - provider_id
                      - visible
                    properties:
                      provider_id:
                        type: string
                        description: >-
                          ID del proveedor del catálogo de Yuno,
                          UPPER_SNAKE_CASE.
                        example: STRIPE
                      visible:
                        type: boolean
                        description: Indica si la organización ofrece este proveedor.
                        example: true
      responses:
        '200':
          description: La capa actualizada.
          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. 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=...
        '400':
          description: >-
            Error de validación: campo desconocido, un id que no es un id de
            catálogo válido o un provider_id repetido.
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    example: about:blank
                  title:
                    type: string
                    example: Bad Request
                  status:
                    type: integer
                    example: 400
                  detail:
                    type: string
                    example: >-
                      provider_id must appear at most once per request;
                      repeated: STRIPE
        '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.