# 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.&#x20;



## Composición de la URL

Se deberá redirigir al usuario a la URL:

```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:**

```url
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.&#x20;

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.&#x20;

## 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:

```json
{
"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.&#x20;

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).&#x20;



