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

# Registrar destino

> Agrega un host de terceros a la lista de permitidos de tu PCI Proxy para que el proxy de reenvío pueda enviarle datos de tarjetas.

Agrega un host a la lista de destinos permitidos de tu cuenta. El [proxy de reenvío](https://docs.y.uno/es/reference/pci-proxy/invoke-forward-proxy.md) solo envía datos de tarjetas a los hosts de esta lista; no existe un modo "cualquier host". Consulta la [guía de la lista de destinos permitidos](https://docs.y.uno/es/docs/security-and-compliance/pci-proxy/allowlist.md) para saber cómo funciona la coincidencia.

> [!NOTE]
>
> **Agregar un destino es una acción sensible**
>
> Registrar un host amplía los lugares a los que se pueden enviar tus tarjetas almacenadas. Restringe quién puede gestionar la lista de permitidos y revisa cualquier adición inesperada.


## OpenAPI

````yaml openapi/es/pci-proxy/manage-destinations.json POST /pci-proxy/destinations
openapi: 3.1.0
info:
  title: pci-proxy-manage-destinations
  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:
  /pci-proxy/destinations:
    post:
      summary: Registrar destino
      description: >-
        Agrega un host a la lista de permitidos de tu cuenta para que el proxy
        de reenvío pueda enviarle datos de tarjeta. La coincidencia es por el
        nombre de host exacto, sin distinguir mayúsculas y minúsculas; no se
        asumen subdominios ni comodines. Un host recién registrado se puede usar
        en pocos minutos.
      operationId: registerPciProxyDestination
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DestinationInput'
            example:
              hostname: api.example-processor.com
              purpose: Direct acquiring — Processor X
      responses:
        '201':
          description: El destino se registró.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Destination'
              example:
                id: d7e8f9a0-1234-4b5c-8d6e-7f8091a2b3c4
                account_id: null
                hostname: api.example-processor.com
                status: ENABLED
                purpose: Direct acquiring — Processor X
                created_at: '2026-07-09T13:05:36Z'
                updated_at: '2026-07-09T13:05:36Z'
        '400':
          description: >-
            No se pudo interpretar el cuerpo de la solicitud, o el `account_id`
            no es una cuenta válida para tu organización.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DestinationError'
              examples:
                Invalid request:
                  value:
                    code: INVALID_REQUEST
                    messages:
                      - invalid body
                Invalid account id:
                  value:
                    code: INVALID_ACCOUNT_ID
                    messages:
                      - account_id is not a valid account
        '401':
          $ref: '#/components/responses/Unauthorized'
        '409':
          description: >-
            El nombre de host ya está registrado en tu lista de permitidos (para
            este ámbito de cuenta).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DestinationError'
              examples:
                Destination exists:
                  value:
                    code: DESTINATION_EXISTS
                    messages:
                      - destination already registered
        '422':
          description: >-
            El nombre de host no es un nombre de host público simple (una URL,
            un host con esquema, puerto o ruta, una dirección IP o un comodín).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DestinationError'
              examples:
                Invalid hostname:
                  value:
                    code: INVALID_HOSTNAME
                    messages:
                      - >-
                        hostname must be a bare public FQDN with no scheme,
                        port, path, or wildcard
components:
  schemas:
    DestinationInput:
      type: object
      required:
        - hostname
      properties:
        hostname:
          type: string
          description: >-
            El nombre de host público simple que se permite, sin esquema, puerto
            ni ruta (por ejemplo, `api.example-processor.com`). Se compara de
            forma exacta, sin distinguir mayúsculas de minúsculas.
          example: api.example-processor.com
        purpose:
          type: string
          description: >-
            Una etiqueta opcional legible que describe por qué se permite este
            host. Se muestra cuando listas los destinos.
          example: Direct acquiring — Processor X
        account_id:
          type: string
          format: uuid
          nullable: true
          description: >-
            Opcional. Restringe este destino a una sola cuenta (un UUID).
            Omítelo (o envía `null`) para permitir el host en toda la
            organización.
          example: null
    Destination:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Identificador único del destino. Úsalo para eliminar el destino.
          example: d7e8f9a0-1234-4b5c-8d6e-7f8091a2b3c4
        account_id:
          type: string
          nullable: true
          description: >-
            La cuenta a la que está asociado este destino, o `null` cuando
            aplica a toda la organización.
          example: null
        hostname:
          type: string
          description: El nombre de host registrado.
          example: api.example-processor.com
        status:
          type: string
          enum:
            - ENABLED
            - DISABLED
          description: >-
            Indica si el destino está activo. Solo los destinos ENABLED se usan
            en la ruta de reenvío.
          example: ENABLED
        purpose:
          type: string
          description: La etiqueta que proporcionaste al registrar el destino.
          example: Direct acquiring — Processor X
        created_at:
          type: string
          format: date-time
          description: Cuándo se registró el destino.
          example: '2026-07-09T13:05:36Z'
        updated_at:
          type: string
          format: date-time
          description: Cuándo se cambió el destino por última vez.
          example: '2026-07-09T13:05:36Z'
    DestinationError:
      type: object
      properties:
        code:
          type: string
          description: Código de error legible por máquina.
          enum:
            - NOT_AUTHENTICATED
            - AuthenticationFail
            - INVALID_REQUEST
            - INVALID_HOSTNAME
            - INVALID_ACCOUNT_ID
            - DESTINATION_EXISTS
            - NOT_FOUND
            - INTERNAL_ERROR
        messages:
          type: array
          items:
            type: string
  responses:
    Unauthorized:
      description: Falló la autenticación. Faltan las credenciales de API o no son válidas.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/DestinationError'
          examples:
            Not authenticated:
              value:
                code: NOT_AUTHENTICATED
                messages:
                  - not authenticated
  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.