POST
Registrar o reinstalar una conexión de plataforma

Autorizaciones

Authorization
string
header
requerido

El conector de plataforma y el operador. Registra conexiones, entrega webhooks, corre la saga de instalación y da de alta conexiones custom. Es el único principal obligatorio del proceso: los otros tres se apagan dejando su token vacío, y una puerta que no se monta no la abre ningún token.

Cuerpo

application/json

connectorprotocol.RegisterConnectionRequest. provider y provider_app_id tienen que coincidir con el principal del token: el servidor no los cree, los compara (connection.go), y una diferencia es 401 y no 403.

provider
string
requerido
Minimum string length: 1
provider_app_id
string
requerido
Minimum string length: 1
external_store_id
string
requerido
Minimum string length: 1
access_token
string
requerido

El token del merchant, en claro y sólo en esta llamada. Se cifra en la misma transacción que registra la conexión y nunca vuelve a salir.

Minimum string length: 1
scope
string
requerido

Los scopes que concedió el merchant, separados por coma o espacio.

Respuesta

La conexión ya existía; se reemplazó la credencial.

connection_id
string
requerido
Minimum string length: 1
webhook_endpoint_id
string
requerido
Minimum string length: 1
created
boolean
requerido

true con 201 en un alta nueva, false con 200 en una reinstalación. La reinstalación conserva conexión y endpoint y reemplaza la credencial.