Get Provider Catalog

Returns the schema you need to fill in to create a connection for a given provider.

GET /connections/catalog/{provider_id}

Get Provider Catalog

cURL

curl --request GET \
  --url https://api-sandbox.y.uno/v1/connections/catalog/{provider_id} \
  --header 'PRIVATE-SECRET-KEY: <api-key>' \
  --header 'PUBLIC-API-KEY: <api-key>'

200

{
  "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",
      "description": "Stripe Secret API Key",
      "editable_field": true,
      "optional": false,
      "secret": true
    }
  ]
}

Returns the schema you need to fill in to create a connection for a given provider: which payment methods the provider supports, and the recursive list of parameters (credentials, toggles, choices) the provider requires.

This is the discovery endpoint — call it first to find out what a provider expects, then use its response as the input to Create a Connection.

This endpoint is provider-scoped, not connection-scoped. It returns a schema, not your existing connections.

Path Parameters

provider_id · string · required

Yuno provider identifier (STRIPE, ADYEN, CYBERSOURCE, …). Case-sensitive, UPPER_SNAKE_CASE.

Response

payment_method_type · string[]

The Yuno payment-method enums this provider supports. Pass any of these values into payment_methods[] on Create a Connection.

params · object[]

Recursive parameter schema.

Show item

param_id · string

Identifier to echo back in POST /v1/connections.params[].param_id. Pass casing verbatim.

field_type · enum

One of string, boolean, array, number.

description · string | object

Display label. May be a plain string or a localization object { "EN": "...", "ES": "...", "PT": "..." }.

placeholder · string | object

Optional placeholder text. Same shape rules as description.

tooltip · string | null

Optional helper text.

editable_field · boolean

If false, value is fixed/read-only.

secret · boolean

If true, the value is sensitive — stored encrypted and surfaced as "***" on subsequent reads.

allow_custom · boolean

Only meaningful when options[] is present. If true, you may submit a free-form value alongside the catalog options (combobox semantics).

optional · boolean

If false, you must supply a value.

is_hidden · boolean

If true, the param exists but should not be rendered to end users.

sdk_required · boolean

If true, the value is also required when configuring the Yuno SDK on the client side.

options · string[] | object[]

Present when the field is a constrained enum. With field_type = "string" → single-select. With field_type = "array" → multi-select. Plain strings or {value, params} objects (the latter when an option carries its own nested params).

params · object[]

Nested children — activated when this node’s value is true (boolean parent) or matches one of the options (string/array parent).

cURL

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>'

How to read a node

What you see	What it means
field_type: "string", no options[]	Free-form text input.
field_type: "string", secret: true	Password / API key — write-only. Returned as "***" on GET.
field_type: "string", options[] present	Single-choice enum. The value you submit must be one of options[].
field_type: "string", options[] present, allow_custom: true	Combobox. Submit one of options[] or a free-form value.
field_type: "boolean"	Toggle. Setting it to true activates nested params[] and makes their optional: false children required.
field_type: "array", options[] present	Multi-select. Submit a JSON array whose elements are a subset of options[].
field_type: "array", no options[]	Free-form list of strings.

Errors

HTTP	code	When
404	PROVIDER_NOT_FOUND	The provider_id is not in Yuno’s provider catalog.
403	INSUFFICIENT_SCOPE	Your API key is missing the connections:read scope.

Authorizations

PUBLIC-API-KEY · string · header · default: <Your PUBLIC-API-KEY> · required

PRIVATE-SECRET-KEY · string · header · default: <Your PRIVATE-SECRET-KEY> · required

Path Parameters

provider_id · string · required

Example:

"ADYEN"

Response

200

application/json

OK

payment_method_type · string[]

Example:

[
  "CARD",
  "GOOGLE_PAY",
  "APPLE_PAY",
  "ACH",
  "KLARNA_PAY_NOW",
  "KLARNA_PAY_LATER",
  "IDEAL",
  "GIROPAY",
  "BANCONTACT",
  "SEPA_DEBIT"
]

params · object[]

Show child attributes