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

# Reemplazar la lista de proveedores permitidos

> Reemplaza todo el conjunto de proveedores que ofrece tu organización por los ids del cuerpo.

Reemplaza todo el conjunto de proveedores que ofrece tu organización por los ids del cuerpo.

**Un proveedor que el cuerpo omite deja de ofrecerse.** Esto es un reemplazo, no una fusión: usa [Actualizar la visibilidad de varios proveedores](https://docs.y.uno/es/reference/organizations/whitelabel/update-providers-visibility.md) para cambiar algunos proveedores sin volver a indicar el resto.

Quitar un proveedor **conserva** su personalización de instrucciones, de modo que desactivarlo y volver a activarlo no pierde tu redacción.

### Cuerpo

**provider\_ids** `string[]` *required*

El conjunto completo de ids de proveedores que ofrece tu organización. Ids de catálogo en UPPER\_SNAKE\_CASE (`[A-Z0-9_]`), de máximo 100 caracteres cada uno y como máximo 500 entradas. No distingue mayúsculas de minúsculas: se normaliza a mayúsculas.

Un **arreglo vacío es una solicitud válida** y borra la lista de permitidos, con el mismo estado final que [Borrar la lista de proveedores permitidos](https://docs.y.uno/es/reference/organizations/whitelabel/clear-provider-allowlist.md). Por lo tanto, una pantalla de administración de "guardar todo" no necesita un caso especial para "se desmarcó el último proveedor".

> [!WARNING]
>
> Bajo la regla de opt-in, un `provider_ids` vacío deja a tu organización sin ninguna entrada en la lista de permitidos: **no** es un interruptor de "mostrar todo". Envía los ids que quieres ofrecer en lugar de borrar la lista para ampliarla.

### Respuesta

La personalización actualizada, con la misma estructura que [Listar la personalización de proveedores de marca blanca](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 PUT '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 '{ "provider_ids": ["STRIPE", "ADYEN", "YUNO_3DS"] }'
```

```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"
    },
    {
      "provider_id": "YUNO_3DS",
      "allowed": true,
      "has_instruction_override": false,
      "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"}}
{
  "title": "Bad Request",
  "status": 400,
  "detail": "provider_ids contains an invalid catalogue id"
}
```

### Errores

| HTTP | Envoltorio | Cuándo |
| - | - | - |
| `400` | problem+json | Un campo desconocido, más de 500 ids, o un id que no es un id de catálogo válido. |
| `401` | `NOT_AUTHENTICATED` | Faltan las claves de API o no son válidas. |
| `413` | — | Cuerpo de la solicitud mayor a 256 KB. |


## OpenAPI

````yaml openapi/es/organizations/whitelabel/replace-provider-allowlist.json PUT /whitelabel/providers
openapi: 3.1.0
info:
  title: White-label Providers API - Replace Allowlist
  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:
    put:
      summary: Reemplazar la lista de proveedores permitidos
      description: >-
        Reemplaza todo el conjunto de proveedores que ofrece tu organización por
        los ids del cuerpo. Un proveedor que el cuerpo omite deja de ofrecerse:
        esto es un reemplazo, no una combinación; usa `PATCH
        /v1/whitelabel/providers` para cambiar algunos proveedores sin volver a
        indicar el resto.


        Un `provider_ids` vacío es una solicitud válida y borra la lista de
        permitidos, con el mismo estado final que `DELETE
        /v1/whitelabel/providers`, por lo que una pantalla de administración de
        tipo guardar todo no necesita un caso especial para "se desmarcó el
        último proveedor".


        Quitar un proveedor conserva su personalización de instrucciones, por lo
        que desactivarlo y volver a activarlo no hace que pierdas tu redacción.
      operationId: replace-whitelabel-provider-allowlist
      requestBody:
        required: true
        description: El conjunto completo de ids de proveedores que se ofrecerán.
        content:
          application/json:
            schema:
              type: object
              required:
                - provider_ids
              properties:
                provider_ids:
                  type: array
                  description: >-
                    El conjunto completo de ids de proveedores que ofrece la
                    organización. Ids de catálogo en UPPER_SNAKE_CASE
                    (`[A-Z0-9_]`), de hasta 100 caracteres cada uno, con un
                    máximo de 500 entradas.
                  maxItems: 500
                  items:
                    type: string
                    maxLength: 100
                  example:
                    - STRIPE
                    - ADYEN
                    - YUNO_3DS
      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, más de 500 ids, o un id que
            no es un id de catálogo válido.
          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_ids contains an invalid catalogue id
        '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.