Saltar al contenido principal
PATCH
Actualizar una conexión
Actualiza parcialmente una conexión que creaste previamente. Solo se aplican los campos presentes en el cuerpo: todo lo que omitas conserva su valor actual.
Lo que no puedes cambiar aquí: provider_id, flow_type, payment_methods y el parámetro INTEGRATION_TYPE son inmutables. Para cambiar cualquiera de ellos, crea una nueva conexión y redirige tus reglas de enrutamiento hacia ella.

Parámetros de ruta

string
requerido
El id devuelto por Crear una conexión. Debe pertenecer a la cuenta a la que está asociada tu clave de API.

Cuerpo

string
requerido
UUID de la cuenta a la que pertenece la conexión.
string
Nueva etiqueta para esta conexión. Máximo 255 caracteres, y debe seguir siendo única dentro de la cuenta. Omítela para conservar la etiqueta actual.
object[]
Parámetros a cambiar, como un arreglo plano de pares {param_id, value}: la misma estructura que en Crear una conexión.Los parámetros se combinan por param_id sobre los parámetros actuales de la conexión: un param_id que no envías conserva su valor actual. Solo necesitas enviar lo que realmente cambias. Cada param_id que envías se valida contra el catálogo del proveedor.
object[]
Configuración de costos. A diferencia de params, costs no se combina: cuando está presente reemplaza toda la tabla de costos de la conexión. Omítela para dejar intactos los costos existentes.

Respuesta

Devuelve la conexión actualizada, con la misma estructura que Obtener una conexión.
string
Identificador único de la conexión. Una actualización no lo modifica.
string
Tu etiqueta interna para esta conexión.
string
El proveedor al que pertenece esta conexión.
string
Estado actual.
string
Siempre PAYIN.
string[]
Lista de métodos de pago admitidos.
object[]
El conjunto completo de parámetros de la conexión tras la combinación, no solo los que enviaste. 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. Se actualiza con cada actualización exitosa.
Manejo de secretos: los parámetros marcados como secret: true en el catálogo siempre se devuelven como "value": "***". Reenviar "***" no es la forma de conservar un secreto: simplemente omite el param_id por completo y se conserva su valor almacenado.

Errores

Autorizaciones

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

Parámetros de ruta

connection_id
string<uuid>
requerido

Cuerpo

application/json
account_id
string<uuid>
requerido
Ejemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

merchant_connection_id
string
Maximum string length: 255
Ejemplo:

"stripe-us-prod-002"

params
object[]
costs
object[]

Respuesta

OK

connection_id
string
Ejemplo:

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

merchant_connection_id
string
Ejemplo:

"stripe-us-prod-002"

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-12T11:02:17Z"