Autenticación

Esta sección te ayudará a realizar el alta de tus clientes en Talo y a intercambiar las credenciales de acceso a la API.

La idea es que desde tu plataforma redirijas a tu usuario a Talo para que se cree una cuenta, Talo te envíe un token de acceso y luego el usuario sea nuevamente redirigido a tu plataforma.

Alta de Partner en Talo

Antes de comenzar deberás darte de alta como partner en Talo. Para ello deberás contactar a nuestro equipo de soporte y brindarnos la siguiente información:

• Nombre del partner
• Url de redirección a tu plataforma (para que el usuario sea redirigido luego de la autenticación)

A continuación te proporcionaremos un partner_id, un client_id y un client_secret que deberás utilizar en las siguientes llamadas.

Alta de cliente en Talo

Deberás redirigir al usuario a la siguiente URL:

https://app.talo.com.ar/authorize?partner_id={partner_id}

El usuario completará el registro en Talo y una vez finalizado, se le mostrará una pantalla de consentimiento. Aquí tendrá que confirmar que desea dar al partner acceso a su cuenta.

Una vez que el usuario confirma, Talo lo redirigirá a la url de redirección que proporcionó el partner al momento de registrarse, con un code en el query string.

https://{redirection_url}?code={code}

Intercambio de credenciales

Una vez que el usuario haya confirmado el consentimiento, Talo te redirigirá a la url de redirección que proporcionaste al momento de registrarte como partner.

En esta url recibirás code como query string, el cual deberás utilizar para obtener el access_token de tu usuario. Este código tiene una validez de 5 minutos.

Para obtener el access_token tendrás que utilizar el siguiente endpoint, enviando el code que recibiste en la redirección y el client_id y client_secret que te proporcionamos al momento de registrarte como partner.

POST https://api.talo.com.ar/auth/tokens

Request

{
    "code": {code},
    "client_id": {client_id},
    "client_secret": {client_secret}
}

Response

El endpoint te devolverá un access_token y un user_id que te permitirán realizar llamadas a la API de Talo.

{
    "data":{
        "access_token": {access_token},
        "user_id": {user_id}
    },
    "status": "ok",
    "error": false
}