Saltar al contenido principal
POST
/
v1
/
discovery
/
aggregator-connections
Crear conexión de aggregator
curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/discovery/aggregator-connections \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountRef": "<string>",
  "baseUrl": "<string>",
  "clientId": "<string>",
  "configName": "<string>",
  "secret": "<string>"
}
'
{
  "accountRef": "<string>",
  "baseUrl": "<string>",
  "configName": "<string>"
}

Autorizaciones

​
Authorization
string
header
requerido

Autenticación con token Bearer (formato: "Bearer {token}")

Cuerpo

application/json
​
accountRef
string
requerido

Referencia de cuenta de proveedor opaca (Pluggy itemId, Belvo link id) que el pull del webhook incorpora en su solicitud

Minimum string length: 1
Ejemplo:

"a1b2c3d4-5678-90ab-cdef-1234567890ab"

​
baseUrl
string<uri>
requerido

URL base de la API del proveedor, almacenada como el host de la conexión

Minimum string length: 1
Ejemplo:

"https://api.pluggy.ai"

​
clientId
string
requerido

ID de cliente de la API del aggregator (sellado; nunca emitido)

Minimum string length: 1
​
configName
string
requerido

Nombre único de la configuración de conexión (con alcance de tenant); el endpoint de emisión vincula un token a este nombre

Minimum string length: 1
Ejemplo:

"pluggy-main"

​
secret
string
requerido

Secreto de cliente de la API del aggregator (sellado; nunca emitido)

Minimum string length: 1
​
vendor
enum<string>
requerido

Proveedor de aggregator: pluggy (aggregator de Open Finance Pluggy) o belvo (aggregator Belvo)

Opciones disponibles:
pluggy,
belvo
Ejemplo:

"pluggy"

Respuesta

Creado

​
accountRef
string
requerido

Referencia de cuenta de proveedor opaca almacenada (Pluggy itemId, Belvo link id)

Ejemplo:

"a1b2c3d4-5678-90ab-cdef-1234567890ab"

​
baseUrl
string<uri>
requerido

URL base de la API del proveedor almacenada

Ejemplo:

"https://api.pluggy.ai"

​
configName
string
requerido

Nombre de la configuración de conexión contra la que el operador emite un token

Ejemplo:

"pluggy-main"

​
vendor
enum<string>
requerido

Proveedor de aggregator al que está vinculada la conexión

Opciones disponibles:
pluggy,
belvo
Ejemplo:

"pluggy"