> ## 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 un proveedor

> Activa o desactiva un solo proveedor en la pestaña Proveedores de tu marca blanca.

Activa o desactiva un solo proveedor. Es idempotente, y al desactivarlo se **conserva** su instrucción personalizada, de modo que tu redacción sobrevive al cambio.

La respuesta es la capa actualizada del proveedor, con `allowed` reflejando el valor de `visible` que enviaste.

> [!WARNING]
>
> Tu lista de permitidos es opt-in: una organización de marca blanca sin entradas en la lista de permitidos no ofrece ningún proveedor. Enviar `visible: true` en una organización así **inicia** la lista de permitidos con ese único proveedor: los demás siguen sin ofrecerse hasta que los agregues uno por uno, o de forma masiva con [Actualizar la visibilidad de varios proveedores](https://docs.y.uno/es/reference/organizations/whitelabel/update-providers-visibility.md) o [Reemplazar la lista de proveedores permitidos](https://docs.y.uno/es/reference/organizations/whitelabel/replace-provider-allowlist.md).

### Parámetros de ruta

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

Id del proveedor del catálogo de Yuno en UPPER\_SNAKE\_CASE. No distingue mayúsculas de minúsculas: se normaliza a mayúsculas, por lo que `stripe` y `STRIPE` direccionan al mismo proveedor.

### Cuerpo

**visible** `boolean` *required*

Indica si tu organización ofrece este proveedor. `true` lo agrega a la lista de permitidos, `false` lo elimina.

Obligatorio. Un cuerpo que lo omite, o que envía un `null` explícito, produce un `400`: nunca se trata como `false`.

### Respuesta

La capa actualizada del proveedor, con la misma estructura que [Obtener la capa de un proveedor](https://docs.y.uno/es/reference/organizations/whitelabel/retrieve-provider.md).

**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, después de este cambio.

**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 se personaliza.

**logo\_url** `string`

Prefirmada en esta lectura y de corta duración.

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

```json 200 OK theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "provider_id": "ADYEN",
  "allowed": true
}
```

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

### Errores

| HTTP | `code` | Cuándo |
| - | - | - |
| `400` | `VALIDATION_ERROR` | `provider_id` no válido, o un cuerpo con `visible` ausente o nulo. |
| `401` | `NOT_AUTHENTICATED` | Claves de API ausentes o no válidas. |
| `413` | — | Cuerpo de la solicitud mayor a 256 KB. |


## OpenAPI

````yaml openapi/es/organizations/whitelabel/update-provider-visibility.json PATCH /whitelabel/providers/{provider_id}
openapi: 3.1.0
info:
  title: White-label Providers API - 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/{provider_id}:
    patch:
      summary: Actualizar la visibilidad de un proveedor
      description: >-
        Activa o desactiva un solo proveedor. Es idempotente, y al desactivarlo
        se conserva su anulación de instrucciones, de modo que tu redacción
        sobrevive al cambio.


        La respuesta es la superposición actualizada del proveedor, con
        `allowed` reflejando el valor de `visible` que enviaste.
      operationId: update-whitelabel-provider-visibility
      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
      requestBody:
        required: true
        description: Indica si la organización ofrece este proveedor.
        content:
          application/json:
            schema:
              type: object
              required:
                - visible
              properties:
                visible:
                  type: boolean
                  description: >-
                    Indica si la organización ofrece este proveedor. `true` lo
                    agrega a la lista de permitidos, `false` lo quita. Quitarlo
                    conserva cualquier anulación de instrucciones. Obligatorio:
                    un `visible` omitido o nulo devuelve `400`, nunca se asume
                    `false` por defecto.
                  example: true
      responses:
        '200':
          description: La superposición actualizada 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 o cuerpo invá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
        '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.