> ## 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 el reemplazo de instrucciones de un proveedor

> Guarda tus propias instrucciones de conexión para un proveedor, reemplazando los textos del catálogo de Yuno donde las sobrescribas.

Guarda tus propias instrucciones de conexión para este proveedor, reemplazando los textos del catálogo de Yuno donde las sobrescribas.

> [!WARNING]
>
> **El documento se guarda completo, no se combina.** Un campo que este cuerpo omite se borra, y el proveedor vuelve al valor del catálogo para ese campo. La edición segura es: leer el documento actual con [Obtener el reemplazo de instrucciones de un proveedor](https://docs.y.uno/es/reference/organizations/whitelabel/retrieve-provider-instructions.md), cambiar el único campo y volver a enviar todo.

Debe estar presente al menos uno de `instructions`, `setup_instructions`, `more_info_url` y `name`. Las claves desconocidas de nivel superior se rechazan en lugar de ignorarse, y el documento serializado no puede superar los 64 KB.

Sobrescribir los textos de un proveedor **no** lo agrega a tu lista de permitidos: editar texto nunca cambia lo que ofreces.

### Parámetros de ruta

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

ID de proveedor del catálogo de Yuno en UPPER\_SNAKE\_CASE. No distingue mayúsculas de minúsculas: se normaliza a mayúsculas.

### Cuerpo

**instructions** `object[]`

Los pasos de conexión que se muestran a tus propios usuarios.

**paso**

**step** `integer`

Posición del paso.

**text** `string | object`

El texto del paso. Una cadena simple o un mapa de idiomas como `{"EN": "...", "ES": "..."}`.

**text\_link** `string | object`

Etiqueta del enlace. Mismas reglas de forma que `text`.

**link** `string`

URL de destino. **Debe ser https**: el dashboard la muestra como href.

**type** `string`

Tipo de paso.

**has\_sub\_instructions** `boolean`

Indica si este paso incluye pasos anidados.

**sub\_instructions\_type** `string`

Tipo de los pasos anidados.

**sub\_instructions** `object[]`

Pasos anidados, con la misma forma. Hasta 3 niveles de profundidad.

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

Pasos de configuración agrupados.

**grupo**

**title** `string`

Encabezado del grupo.

**order** `integer`

Posición del grupo.

**instructions\_type** `string`

Tipo de los pasos de este grupo.

**instructions** `object[]`

Los pasos, con la misma forma que `instructions` más arriba.

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

Enlace a tu propia documentación sobre este proveedor. Debe ser una URL https.

**name** `string`

Nombre para mostrar que reemplaza al del catálogo. Máximo 255 caracteres.

Se acepta **solo para proveedores propiedad de Yuno**: un ID de catálogo que contenga `YUNO`, como `YUNO_3DS` o `YUNO_FRAUD_SCREENING`. Cualquier otro proveedor se rechaza con `400`.

### Respuesta

El documento guardado, con la misma forma que [Obtener el reemplazo de instrucciones de un proveedor](https://docs.y.uno/es/reference/organizations/whitelabel/retrieve-provider-instructions.md), incluidos los campos de solo lectura `created_at`, `updated_at`, `created_by` y `updated_by`.

```bash cURL theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
curl -X PUT 'https://api.y.uno/v1/whitelabel/providers/STRIPE/instructions' \
  -H 'public-api-key: <YOUR_PUBLIC_KEY>' \
  -H 'private-secret-key: <YOUR_SECRET_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "more_info_url": "https://docs.example.com/stripe",
    "instructions": [
      {
        "step": 1,
        "text": { "EN": "Open your Stripe dashboard.", "ES": "Abre tu panel de Stripe." },
        "type": "TEXT"
      },
      {
        "step": 2,
        "text": "Copy the secret API key and paste it below.",
        "text_link": "Where do I find my key?",
        "link": "https://docs.example.com/stripe#api-keys",
        "type": "LINK"
      }
    ]
  }'
```

```json 200 OK theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "provider_id": "STRIPE",
  "more_info_url": "https://docs.example.com/stripe",
  "instructions": [
    {
      "step": 1,
      "text": { "EN": "Open your Stripe dashboard.", "ES": "Abre tu panel de Stripe." },
      "type": "TEXT"
    },
    {
      "step": 2,
      "text": "Copy the secret API key and paste it below.",
      "text_link": "Where do I find my key?",
      "link": "https://docs.example.com/stripe#api-keys",
      "type": "LINK"
    }
  ],
  "created_at": "2026-09-02T13:54:13Z",
  "updated_at": "2026-09-02T13:54:13Z",
  "created_by": "00000000-0000-0000-0000-000000000000",
  "updated_by": "00000000-0000-0000-0000-000000000000"
}
```

```json 400 — rename refused theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "title": "Invalid provider instructions",
  "status": 400,
  "detail": "The instruction override was rejected",
  "violations": [
    "name: only Yuno's own providers can be renamed; 'STRIPE' cannot"
  ]
}
```

> [!NOTE]
>
> `violations` enumera **todos** los problemas del documento a la vez: corrígelos juntos en lugar de reenviar para descubrir el siguiente.

### Errores

| HTTP | Envoltorio | Cuándo |
| - | - | - |
| `400` | `VALIDATION_ERROR` | `provider_id` no es un ID de catálogo válido. |
| `400` | problem+json | Se rechazó el documento: una clave desconocida de nivel superior, un `link` o `more_info_url` que no es https, `name` en un proveedor que no es propiedad de Yuno, un documento vacío, o más de 64 KB. |
| `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/replace-provider-instructions.json PUT /whitelabel/providers/{provider_id}/instructions
openapi: 3.1.0
info:
  title: White-label Providers API - Replace Instructions
  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}/instructions:
    put:
      summary: Reemplazar la personalización de instrucciones de un proveedor
      description: >-
        Almacena tus propias instrucciones de conexión para este proveedor,
        reemplazando la redacción del catálogo de Yuno donde la personalices.


        El documento se almacena completo, no se combina. Un campo que este
        cuerpo omite se borra y el proveedor vuelve al valor del catálogo para
        ese campo, por lo que debes leer el documento actual con `GET`, editarlo
        y volver a enviarlo completo. Debe estar presente al menos uno de
        `instructions`, `setup_instructions`, `more_info_url` y `name`, las
        claves de nivel superior desconocidas se rechazan en lugar de ignorarse,
        y el documento serializado no puede superar los 64 KB.


        Todo `link`, y `more_info_url`, debe ser https. `name` cambia el nombre
        del proveedor y solo se acepta para proveedores propiedad de Yuno (un id
        de catálogo que contenga `YUNO`); cualquier otro proveedor se rechaza
        con `400`. Los rechazos enumeran todas las infracciones a la vez en
        `violations`.


        Personalizar la redacción de un proveedor no lo agrega a tu lista de
        permitidos.
      operationId: replace-whitelabel-provider-instructions
      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: El documento de personalización completo.
        content:
          application/json:
            schema:
              type: object
              description: >-
                El documento de personalización completo. Debe estar presente al
                menos una propiedad.
              minProperties: 1
              properties:
                instructions:
                  type: array
                  description: >-
                    Los pasos de conexión que se muestran a tus propios
                    usuarios. Todo `link` debe ser https.
                  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.
                  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 tu propia documentación para este proveedor. Debe
                    ser una URL https.
                  example: https://docs.example.com/stripe
                name:
                  type: string
                  maxLength: 255
                  description: >-
                    Nombre visible que reemplaza al del catálogo. Se acepta solo
                    para proveedores propiedad de Yuno (un id de catálogo que
                    contenga `YUNO`, por ejemplo `YUNO_3DS`); cualquier otro
                    proveedor se rechaza con `400`.
                  example: Acme Risk
      responses:
        '200':
          description: La anulación almacenada.
          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
                  instructions:
                    type: array
                    description: Pasos de conexión que reemplazan 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 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
                  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
                  created_at:
                    type: string
                    format: date-time
                    readOnly: true
                    description: Cuándo se escribió la anulación por primera vez.
                    example: '2026-09-02T13:54:13Z'
                  updated_at:
                    type: string
                    format: date-time
                    readOnly: true
                    description: Cuándo se escribió la anulación por última vez.
                    example: '2026-09-02T13:54:13Z'
                  created_by:
                    type: string
                    format: uuid
                    readOnly: true
                    description: >-
                      El usuario del Dashboard que la creó. Las anulaciones
                      escritas mediante esta API llevan el valor centinela con
                      todos ceros `00000000-0000-0000-0000-000000000000`, que
                      significa "escrito mediante la API" y no por una persona
                      en el Dashboard.
                    example: 00000000-0000-0000-0000-000000000000
                  updated_by:
                    type: string
                    format: uuid
                    readOnly: true
                    description: >-
                      El usuario del Dashboard que la actualizó por última vez,
                      con la misma regla del valor centinela que `created_by`.
                    example: 00000000-0000-0000-0000-000000000000
        '400':
          description: >-
            El documento fue rechazado: provider_id inválido, clave desconocida,
            enlace que no es https, `name` en un proveedor que no es propiedad
            de Yuno, o tamaño superior a 64 KB.
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    example: about:blank
                  title:
                    type: string
                    example: Invalid provider instructions
                  status:
                    type: integer
                    example: 400
                  detail:
                    type: string
                    example: The instruction override was rejected
                  violations:
                    type: array
                    description: >-
                      Todas las infracciones de la solicitud, informadas juntas
                      en lugar de una por cada ida y vuelta.
                    items:
                      type: string
                    example:
                      - >-
                        name: only Yuno's own providers can be renamed; 'STRIPE'
                        cannot
        '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.