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

# Obtener el catálogo de un proveedor

> Devuelve el esquema que debes completar para crear una conexión con un proveedor determinado.

Devuelve el esquema que debes completar para crear una conexión con un proveedor determinado: qué métodos de pago admite el proveedor y la lista recursiva de parámetros (credenciales, interruptores, opciones) que el proveedor requiere.

Este es el endpoint de descubrimiento: llámalo primero para saber qué espera un proveedor y luego usa su respuesta como entrada de [Crear una conexión](https://docs.y.uno/es/reference/organizations/connections/create-connection.md).

> [!NOTE]
>
> Este endpoint está limitado al proveedor, no a la conexión. Devuelve un esquema, no tus conexiones existentes.

### Parámetros de ruta

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

Identificador de proveedor de Yuno (`STRIPE`, `ADYEN`, `CYBERSOURCE`, …). Distingue mayúsculas y minúsculas, UPPER\_SNAKE\_CASE.

### Respuesta

**payment\_method\_type** `string[]`

Los enums de método de pago de Yuno que admite este proveedor. Pasa cualquiera de estos valores en `payment_methods[]` en [Crear una conexión](https://docs.y.uno/es/reference/organizations/connections/create-connection.md).

**params** `object[]`

Esquema de parámetros recursivo.

**elemento**

**param\_id** `string`

Identificador que debes devolver en `POST /v1/connections.params[].param_id`. Respeta las mayúsculas y minúsculas **tal cual**.

**field\_type** `enum`

Uno de `string`, `boolean`, `array`, `number`.

**description** `string | object`

Etiqueta visible. Puede ser un string simple o un objeto de localización `{ "EN": "...", "ES": "...", "PT": "..." }`.

**placeholder** `string | object`

Texto de marcador opcional. Mismas reglas de estructura que `description`.

**tooltip** `string | null`

Texto de ayuda opcional.

**editable\_field** `boolean`

Si es `false`, el valor es fijo y de solo lectura.

**secret** `boolean`

Si es `true`, el valor es sensible: se almacena cifrado y se muestra como `"***"` en lecturas posteriores.

**allow\_custom** `boolean`

Solo tiene sentido cuando `options[]` está presente. Si es `true`, puedes enviar un valor de formato libre junto con las opciones del catálogo (semántica de combobox).

**optional** `boolean`

Si es `false`, debes proporcionar un valor.

**is\_hidden** `boolean`

Si es `true`, el parámetro existe pero no debe mostrarse a los usuarios finales.

**sdk\_required** `boolean`

Si es `true`, el valor también es obligatorio al configurar el Yuno SDK del lado del cliente.

**options** `string[] | object[]`

Presente cuando el campo es un enum restringido. Con `field_type = "string"` → selección única. Con `field_type = "array"` → selección múltiple. Strings simples u objetos `{value, params}` (estos últimos cuando una opción lleva sus propios parámetros anidados).

**params** `object[]`

Hijos anidados: se activan cuando el valor de este nodo es `true` (padre booleano) o coincide con una de las `options` (padre string/array).

```bash cURL theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
curl -X GET 'https://api.y.uno/v1/connections/catalog/STRIPE' \
  -H 'public-api-key: <YOUR_PUBLIC_KEY>' \
  -H 'private-secret-key: <YOUR_SECRET_KEY>'
```

```json 200 OK — Stripe theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "payment_method_type": [
    "CARD",
    "GOOGLE_PAY",
    "APPLE_PAY",
    "ACH",
    "KLARNA_PAY_NOW",
    "KLARNA_PAY_LATER",
    "IDEAL",
    "GIROPAY",
    "BANCONTACT",
    "SEPA_DEBIT"
  ],
  "params": [
    {
      "param_id": "API_KEY",
      "field_type": "string",
      "secret": true,
      "description": "Stripe Secret API Key",
      "editable_field": true,
      "optional": false
    },
    {
      "param_id": "PUBLISHABLE_KEY",
      "field_type": "string",
      "description": "Stripe Publishable Key",
      "editable_field": true,
      "optional": false
    },
    {
      "param_id": "INTEGRATION_TYPE",
      "field_type": "string",
      "description": "Stripe integration variant",
      "editable_field": true,
      "optional": false,
      "options": [
        "PAYMENT_INTENTS",
        "CHARGES",
        "CONNECT_DESTINATION"
      ]
    },
    {
      "param_id": "3DS_ENABLED",
      "field_type": "boolean",
      "description": "Enable 3DS validation flow",
      "editable_field": true,
      "optional": true,
      "params": [
        {
          "param_id": "ORIGIN_URL",
          "field_type": "string",
          "description": "Your checkout origin URL",
          "editable_field": true,
          "optional": true
        }
      ]
    }
  ]
}
```

```json 404 Not Found theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "type": "not_found",
  "code": "PROVIDER_NOT_FOUND",
  "message": "Provider 'NOT_A_PROVIDER' is not in the Yuno provider catalog",
  "details": { "provider_id": "NOT_A_PROVIDER" }
}
```

```json 403 Forbidden theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "type": "auth_error",
  "code": "INSUFFICIENT_SCOPE",
  "message": "API key is missing required scope 'connections:read'",
  "details": { "required_scope": "connections:read" }
}
```

### Cómo leer un nodo

| Lo que ves | Qué significa |
| - | - |
| `field_type: "string"`, sin `options[]` | Campo de texto de formato libre. |
| `field_type: "string"`, `secret: true` | Contraseña / clave de API: solo escritura. Se devuelve como `"***"` en `GET`. |
| `field_type: "string"`, `options[]` presente | Enum de opción única. El valor que envíes debe ser uno de `options[]`. |
| `field_type: "string"`, `options[]` presente, `allow_custom: true` | Combobox. Envía uno de `options[]` **o** un valor de formato libre. |
| `field_type: "boolean"` | Interruptor. Establecerlo en `true` activa los `params[]` anidados y hace obligatorios a sus hijos con `optional: false`. |
| `field_type: "array"`, `options[]` presente | Selección múltiple. Envía un arreglo JSON cuyos elementos sean un subconjunto de `options[]`. |
| `field_type: "array"`, sin `options[]` | Lista de strings de formato libre. |

### Errores

| HTTP | `code` | Cuándo |
| - | - | - |
| `404` | `PROVIDER_NOT_FOUND` | El `provider_id` no está en el catálogo de proveedores de Yuno. |
| `403` | `INSUFFICIENT_SCOPE` | A tu clave de API le falta el scope `connections:read`. |


## OpenAPI

````yaml openapi/es/organizations/connections/get-provider-catalog.json GET /connections/catalog/{provider_id}
openapi: 3.1.0
info:
  title: Connections API - Get Provider Catalog
  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:
  /connections/catalog/{provider_id}:
    get:
      summary: Obtener el catálogo de proveedores
      description: >-
        Devuelve el esquema que debes completar para crear una conexión para un
        proveedor determinado.
      operationId: get-provider-catalog
      parameters:
        - name: provider_id
          in: path
          required: true
          schema:
            type: string
            example: ADYEN
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  payment_method_type:
                    type: array
                    items:
                      type: string
                    example:
                      - CARD
                      - GOOGLE_PAY
                      - APPLE_PAY
                      - ACH
                      - KLARNA_PAY_NOW
                      - KLARNA_PAY_LATER
                      - IDEAL
                      - GIROPAY
                      - BANCONTACT
                      - SEPA_DEBIT
                  params:
                    type: array
                    items:
                      type: object
                      properties:
                        param_id:
                          type: string
                          example: API_KEY
                        field_type:
                          type: string
                          example: string
                          enum:
                            - string
                            - boolean
                            - array
                            - number
                        description:
                          type: string
                          example: Stripe Secret API Key
                        editable_field:
                          type: boolean
                          example: true
                        optional:
                          type: boolean
                          example: false
                        secret:
                          type: boolean
                          example: true
        '403':
          description: Prohibido
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    example: auth_error
                  code:
                    type: string
                    example: INSUFFICIENT_SCOPE
                  message:
                    type: string
                    example: API key is missing required scope 'connections:read'
        '404':
          description: No encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    example: not_found
                  code:
                    type: string
                    example: PROVIDER_NOT_FOUND
                  message:
                    type: string
                    example: >-
                      Provider 'NOT_A_PROVIDER' is not in the Yuno provider
                      catalog
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.