Saltar al contenido principal
POST
Crear una conexión
Crea una conexión en estado ACTIVE a partir de las credenciales y la configuración que completas según el catálogo del proveedor. La respuesta incluye el connection_id que usarás para referenciar esta conexión desde las reglas de enrutamiento.

Encabezados

string
requerido
Código de la cuenta bajo la cual se crea la conexión. La cuenta proviene de este encabezado, no del cuerpo de la solicitud.
string
requerido
UUID, con alcance de 24 horas. Reenviar la misma clave y el mismo cuerpo devuelve la respuesta en caché; la misma clave con un cuerpo distinto devuelve un 409.

Cuerpo

string
requerido
Tu etiqueta para esta conexión. Debe ser única dentro de la cuenta. Formato libre (por ejemplo, "adyen-us-prod-001", "stripe-eu-test").
string
requerido
Identificador del proveedor en Yuno (por ejemplo, "STRIPE", "ADYEN"). Debe existir en el catálogo.
enum
Opcional. Por defecto es "PAYIN", el único valor admitido.
string[]
Opcional. Subconjunto de los payment_method_type[] del proveedor (del catálogo).Omite este campo para habilitar todos los métodos de pago que admite el proveedor. Los métodos de pago que el proveedor agregue más adelante también se agregan a la conexión.Si lo envías, incluye al menos un método de pago. Un arreglo vacío ([]) se rechaza con 400 VALIDATION_ERROR: omite el campo o envíalo con valores.
object[]
requerido
Un par {param_id, value} por cada parámetro que proporcionas. Arreglo plano: incluso los parámetros anidados del catálogo se envían en el nivel superior; Yuno resuelve la jerarquía a partir del árbol del catálogo.Los parámetros obligatorios (donde el catálogo tiene optional: false) deben estar presentes y no vacíos. Activar un padre boolean ("value": true) hace obligatorios a sus hijos con optional: false.
object[]
Opcional. Configuración de costos por conexión. Omítela para una conexión sin costos. currency debe ser una admitida por el proveedor.

Respuesta

string
Identificador único de la conexión. Guarda este valor para referenciarla desde las reglas de enrutamiento.
string
Tu etiqueta interna para esta conexión.
string
El proveedor al que pertenece esta conexión (por ejemplo, ADYEN).
string
Estado actual (siempre ACTIVE al crear).
string
Siempre PAYIN.
string[]
Lista de métodos de pago admitidos.
object[]
Parámetros devueltos como eco. Los valores sensibles se enmascaran como ***.
object[]
Configuración de costos de la conexión.
string
Marca de tiempo ISO 8601.
string
Marca de tiempo ISO 8601.
Yuno valida los valores de param_id, los parámetros obligatorios y costs[].currency contra el catálogo del proveedor. No llama al proveedor para verificar las credenciales, por lo que una clave incorrecta se acepta con 201.
Manejo de secretos: cualquier parámetro marcado como secret: true en el catálogo se devuelve como "value": "***". Tu secreto enviado se almacena cifrado y nunca se devuelve.

Errores

Autorizaciones

PUBLIC-API-KEY
string
header
predeterminado:<Your PUBLIC-API-KEY>
requerido
PRIVATE-SECRET-KEY
string
header
predeterminado:<Your PRIVATE-SECRET-KEY>
requerido

Encabezados

X-account-code
string
requerido

La cuenta propietaria de la conexión.

X-Idempotency-Key
string<uuid>
requerido

Cuerpo

application/json
merchant_connection_id
string
requerido
Ejemplo:

"stripe-us-prod-001"

provider_id
string
requerido
Ejemplo:

"STRIPE"

params
object[]
requerido
flow_type
string

Opcional. El valor predeterminado es PAYIN.

Ejemplo:

"PAYIN"

payment_methods
string[]

Opcional. Subconjunto de payment_method_type[] del proveedor. Omítelo para habilitar todos los métodos de pago que admite el proveedor, incluidos los que se agreguen más adelante. Si lo envías, debe contener al menos un valor: un arreglo vacío se rechaza con 400 VALIDATION_ERROR.

Minimum array length: 1
Ejemplo:
costs
object[]

Opcional. Configuración de costos por conexión.

Respuesta

Creado

connection_id
string
Ejemplo:

"f1a3c4d5-7b8e-4a2c-9d1e-3f4a5b6c7d8e"

merchant_connection_id
string
Ejemplo:

"stripe-us-prod-001"

provider_id
string
Ejemplo:

"STRIPE"

status
string
Ejemplo:

"ACTIVE"

flow_type
string
Ejemplo:

"PAYIN"

payment_methods
string[]
Ejemplo:
params
object[]
costs
object[]
created_at
string<date-time>
Ejemplo:

"2026-05-12T10:24:00Z"

updated_at
string<date-time>
Ejemplo:

"2026-05-12T10:24:00Z"