Versiones pasadas
v1
Integraciones comerciales
Autenticación por link

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:

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

CampoTipoDescripciónRequerido
callbackUrlQuery stringPágina de redirección al completar la autenticación contra Ualá.
stateQuery stringEstado 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>

CampoTipoDescripciónRequerido
codeQuery stringCódigo de autenticación obtenido luego del inicio de sesión en Ualá.
stateQuery stringEstado retornado luego del inicio se sesión en Ualá.

Respuestas


Status 200:

{
  "username": "clientUsername",
  "client_id": "5qqGKGm4AaawnAJ0J6xluc6AWdQBvLW6",
  "client_secret_id": "cLp1iGEB-PA6KtL4Hi7tocsopP2pZxzaBLciOCApWH92e9_Jloe8CD2ilM63NppG"
}
CampoTipoDescripción
usernamestringNombre del usuario de la cuenta Ualá.
client_idstringID del usuario registrado.
client_secret_idstringID secreto generado por la aplicación.

Posibles respuestas de error:


CampoTipoDescripción
codestringCódigo de error.
descriptionstringDescripció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:

  1. Deben tener un recuadro de Ualá Bis como método de cobro disponible dentro de tu plataforma.

  2. Al clickearlo, van a ser redireccionados al inicio de sesión de Ualá.

  3. Una vez que inicien sesión, les pediremos que acepten permisos.

  4. 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.