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 aceptar los Términos y condiciones en la sección de Cobros de la App. 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 visualizarán lo siguiente:

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/apps/authorize

GET <BASE_URL>?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

Status 200:

{
  "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.

Posibles respuestas de error:

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

Status 400 - Campos insuficientes:

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

Status 404 - Not found:

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

Status 500

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

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

¿Es necesario que mis clientes soliciten las credenciales de acceso en la app de Ualá?

No es necesario. Te enviaremos las credenciales de acceso de tus clientes cuando inicien sesión en su cuenta y configuren Ualá Bis en tu plataforma.

¿Qué pasa si mi cliente ya solicitó las credenciales en la app de Ualá?

Si tu cliente ya solicitó las credenciales en la App de Ualá, la activación del método de cobro en tu plataforma no se modifica.

Casos de uso GET Notificaciones fallidas