Autenticación por Link

Introducción

Con esta opción podrás ofrecerle a los clientes de tu plataforma online la posibilidad de cobrar con Ualá Bis en su sitio.

Los únicos requisitos que tendrán que cumplir son: tener una cuenta en Ualá y tener habilitada la sección Tu negocio. Dentro de tu plataforma tendrán que iniciar sesión y aceptar los permisos para activar Ualá Bis como método de pago.

El proceso es tan ágil y rápido que tus usuarios no necesitarán generar credenciales en la App.

Al finalizar la integración, tus clientes, cuando seleccionen integrar Ualá Bis, visualizarán lo siguiente:

Paso 1 de 2

Inicia sesión con Ualá

Tu cliente ingresa el mail con el que tiene cuenta en Ualá.

Luego serán redirigidos a la URL que hayas definido como callbackUrl.

Estos son los pasos sugeridos para la integración.

¿Cómo funciona?

Frontend

Una vez seleccionada la opción de Ualá Bis como medio de cobro, tu frontend debe ser capaz de redirigir a tu usuario a:

https://web.prod.adquirencia.ar.ua.la/

con los siguientes parámetros en formato queryString:

Campo	Tipo	Descripción	Requerido
callbackUrl	Query string	Página de redirección al completar la autenticación contra Ualá.	Sí
state	Query string	Estado secreto para determinar origen de la consulta. De no ser especificado se generará un estado que deberá ser devuelto para su verificación.	No

Tu cliente deberá iniciar sesión con su cuenta de Ualá y autorizar a la tienda el acceso a sus credenciales.

Una vez completada la autorización, se redirigirá a la url provista previamente bajo el parámetro callbackUrl recibiendo como respuesta en formato queryString el state y el code.

⚠️

Recordá que el code tiene vigencia de 30 segundos una vez recibido. Superado este tiempo, tu usuario tendrá que repetir el proceso.

Backend

La operación se realiza mediante el consumo de un endpoint específico.

BASE URL:

https://checkout-bff.prod.adquirencia.ar.ua.la/1

GET /apps/authorize?state=<your_state>&code=<provided_code>

Campo	Tipo	Descripción	Requerido
code	Query string	Código de autenticación obtenido luego del inicio de sesión en Ualá.	Sí
state	Query string	Estado retornado luego del inicio se sesión en Ualá.	Sí

Respuestas

Estas son las posibles respuestas que tu backend recibirá al consumir GET /apps/authorize con el code obtenido en la redirección:

{
  "username": "clientUsername",
  "client_id": "5qqGKGm4AaawnAJ0J6xluc6AWdQBvLW6",
  "client_secret_id": "cLp1iGEB-PA6KtL4Hi7tocsopP2pZxzaBLciOCApWH92e9_Jloe8CD2ilM63NppG"
}

Campo	Tipo	Descripción
username	string	Nombre del usuario de la cuenta Ualá.
client_id	string	ID del usuario registrado.
client_secret_id	string	ID secreto generado por la aplicación.

Campos insuficientes

{
  "code": "1000",
  "description": "missing input value"
}

Not found

{
  "code": "1006",
  "description": "no record found"
}

Error interno

{
  "code": "999",
  "description": "unexpected error occurred. Please try again"
}

En las respuestas de error, code y description describen el motivo de la falla:

Campo	Tipo	Descripción
code	string	Código de error.
description	string	Descripción del error.

Pasos sugeridos para la integración

Les servirán a tus clientes para completar su integración:

Deben tener un recuadro de Ualá Bis como método de cobro disponible dentro de tu plataforma.
Al clickearlo, van a ser redireccionados al inicio de sesión de Ualá.
Una vez que inicien sesión, les pediremos que acepten permisos.
Cuando esté realizada la integración, tu cliente verá un mensaje de confirmación en tu plataforma.

Preguntas frecuentes

Errores frecuentes

→