Versiones pasadas
v1
Autenticación
POST Crear Token

Credenciales

Acceso a los entornos de prueba y producción

Ambas credenciales de acceso: productivas y de prueba, se encuentran en el email de bienvenida.

¿Todavía no las solicitaste? Ingresá a Tiendas online > Página web en la sección de cobros de la App o en WebApp para recibirlas.

⚠️

Recordá que estas son privadas, que no se deben compartir y que ninguna persona del equipo de Ualá las va a solicitar.

Token de Acceso

Todas nuestras integraciones requieren de la generación de un token para realizar consultas HTTP.

BASE URL:

https://auth.prod.ua.la/1/auth/token

Parámetros


POST https://auth.prod.ua.la/1/auth/token

Body json:

{
  "user_name": "your-username",
  "client_id": "5qqGKGm4AaawnAJ0J6xluc6AWdQBvLW6",
  "client_secret_id": "cLp1iGEB-PA6KtL4Hi7tocsopP2pZxzaBLciOCApWH92e9_Jloe8CD2ilM63NppG",
  "grant_type": "client_credentials"
}
CampoTipoDescripciónRequerido
user_namestringNombre del usuario de la cuenta Ualá
client_idstringID del usuario registrado
client_secret_idstringID secreto generado por la aplicación
grant_typestringTipo de operación a realizar para obtener un token

Respuestas

Respuesta exitosa

Status 200:

{
  "access_token": "eyJhbGciXVCIsImtpZ9.eyJpc3ImF1ZudC1jcmVkZW50aWFscyJ9.f4otnnYF60E1j_TfdSxFQy",
  "expires_in": 86400,
  "token_type": "Bearer"
}
CampoTipoDescripción
access_tokenstringToken de acceso generado
expires_innumberTiempo de vida del token previo a su expiración expresado en segundos
token_typestringTipo de token

Respuestas de error

CampoTipoDescripción
codestringCódigo de error
descriptionstringDescripción del error

Status 400 - Campos insuficientes:

{
  "code": "3001",
  "description": "One or more required fields are empty"
}

Status 400 - Grant Type erróneo:

{
  "code": "3002",
  "description": "Unsupported grant type"
}

Status 401 - Usuario inexistente:

{
  "code": "3003",
  "description": "User account not found"
}

Status 401 - Id de cliente inválido:

{
  "code": "3005",
  "description": "The provided client id does not correspond to any active user"
}

Status 401 - Id secreto de cliente inválido:

{
  "code": "3006",
  "description": "Error authenticating user. Invalid credentials"
}

Status 500

{
  "description": "Something bad happened. Please try again."
}