Vincular comercio a red

Para integrar la vinculación de un comercio con un sistema de punto de venta externo, SimpleFi ofrece una URL de vinculación. El comercio que acceda a la URL de vinculación desde el sistema externo deberá tener una cuenta de SimpleFi y estar autenticado al backoffice de SimpleFi en la sesión del explorador al que acceda.

Composición de la URL

Se deberá redirigir al usuario a la URL:

https://www.app.simplefi.tech/#/network_link

Incluyendo los parámetros de querystring:

Parámetro	Valor
network	Nombre de referencia de la red de comercios
network_merchant_id	id de referencia del comercio en el sistema externo

URL ejemplo:

https://www.app.simplefi.tech/#/network_link?network=misistemadepuntodeventa&network_merchant_id=123456

Aprobación de vinculación

El usuario que acceda a la URL indicada visualizará la aplicación de SimpleFi. Si estaba correctamente autenticado en el explorador, accederá diréctamente a la pantalla de vinculación de comercio a red, caso contrario accederá a la sección 'login' para autenticarse.

Una vez dentro, se le solicitará al usuario que confirme la vinculación de su negocio en SimpleFi con la red que solicita la petición. En caso de aceptar, se envía una petición al backend que envía a su vez esta información a un webhook provisto por el sistema de punto de venta para notificar la vinculación de un comercio.

Webhook para notificar vinculación

El sistema de punto de venta deberá proveer un endpoint de su API para recibir notificaciones de vinculación de comercios. La información enviada por SimpleFi a este endpoint tendrá la forma:

{
"network": "misistemadepuntodeventa", // provisto vía querystring
"network_merchant_id": "123123",  // provisto vía querystring
"sf_api_key": "API_KEY",
"sf_merchant_id": "ObjectId()"
}

La api del sistema de punto de venta deberá encontrar el comercio a partir del network_merchant_id en su base de datos y guardar la api_key provista, para poder hacer peticiones desde su sistema en nombre del comercio vinculado.

En caso de encontrar y guardar la api_key , simplefi esperará recibir un código '200' y así confirmar al usuario la correcta vinculación.

En caso de no poder guardar esta api_key vinculada a un comercio de su sistema, responder 404 u otro error correspondiente (> =400).