Migrar de API v1 a v2

El proceso completo toma menos de una hora. Tus credenciales no cambian, tanto en test como en producción.

🔑

Mismas credenciales

Tu client_id y client_secret_id no cambian.

🔗

Nuevas URLs

Los dominios cambian. El resto de la lógica es igual.

⚡

Menos campos

v2 simplifica los requests: menos campos requeridos.

1. Actualizá las URLs base

El único cambio obligatorio en todos los requests es la URL base.

v1 — deprecada

auth.prod.ua.la/1

auth.stage.ua.la/1

checkout.prod.ua.la/1

checkout.stage.ua.la/1

v2 — actual

auth.developers.ar.ua.la/v2/api

auth.stage.developers.ar.ua.la/v2/api

checkout.developers.ar.ua.la/v2/api

checkout.stage.developers.ar.ua.la/v2/api

2. Cambios en los requests

Crear token (`POST /auth/token`)

Un solo campo cambia de nombre:

Antes (v1)

{
  "user_name": "mi-usuario",
  "client_id": "...",
  "client_secret_id": "...",
  "grant_type": "client_credentials"
}

Después (v2)

{
  "username": "mi-usuario",
  "client_id": "...",
  "client_secret_id": "...",
  "grant_type": "client_credentials"
}

⚠️

user_name (con guión bajo) → username (sin guión bajo). El resto del body es idéntico.

Crear orden (`POST /checkout`)

Se elimina un campo, se modifica el formato de otro y se agrega uno opcional:

Antes (v1)

{
  "amount": "10.21",
  "description": "Venta",
  "userName": "mi-usuario",
  "callback_fail": "https://...",
  "callback_success": "https://..."
}

Después (v2)

{
  "amount": "1021",
  "description": "Venta",
  "callback_fail": "https://...",
  "callback_success": "https://...",
  "external_reference": "tu-id-interno"
}

🚫

userName eliminado. El token ya identifica al usuario, no hace falta enviarlo.

⚠️

amount en centavos. "10.21" → "1021". Multiplicá por 100 y eliminá los decimales.

Respuesta de Crear orden

El atributo para el campo link cambió:

Campo	v1	v2
Link de pago	`links.checkoutLink`	`links.checkout_link`
`external_reference`	❌ no existe	✅ presente
`orderNumber`, `currency`, `refNumber`	✅ presentes	❌ eliminados

Obtener orden (`GET /orders/:uuid`)

El path cambió levemente:

	v1	v2
Path	`GET /order/:id`	`GET /orders/:uuid`
Estado `REFUNDED`	❌ no existe	✅ nuevo estado

3. Checklist antes de ir a producción

☐URLs base actualizadas a los nuevos dominios de v2

☐Campo user_name renombrado a username en el token

☐Campo userName eliminado del body de crear orden

☐amount enviado en centavos como string entero (ej: “1021” = $10,21)

☐Link de pago leído desde links.checkout_link (con guión bajo)

☐Flujo completo probado en entorno de test antes de producción

¿Necesitás ayuda?

Consultá la página de errores frecuentes para ver los problemas más comunes y sus soluciones.

Si no encontrás lo que buscás, escribinos a developers.ualabis@uala.com.ar y te ayudamos con la migración.

Crear token

→

Migrar de API v1 a v2

1. Actualizá las URLs base

2. Cambios en los requests

Crear token (POST /auth/token)

Crear orden (POST /checkout)