Introducción

La API PNA Cobrand LATAM Pass es la forma por la cual nuestras alianzas bancarias administran el ciclo de vida de los beneficios que se entregan a nuestros socios LATAM Pass que poseen una tarjeta cobrand.

El inicio del ciclo de vida, entonces, ocurre cuando se aprueba una nueva tarjeta o se desbloquea una tarjeta actual, es decir, cuando se deben entregar los beneficios de LATAM Pass al socio.

Para poder realizar peticiones a la API, primero se debe obtener el token de acceso. Consulte la documentación Autenticación para obtener toda la información.

Carta Gantt base

Accede a la carta Gantt base para cada tipo de alianza con el programa utilizando los siguientes enlaces:

  1. Nuevas alianzas;
  2. Alianzas existentes migrando a la API PNA LATAM Pass.

Petición

Para iniciar ciclo de vida se deben proporcionar los siguientes datos:

  1. Datos del socio LATAM Pass (member);
  2. Datos no confidenciales de la tarjeta de crédito cobrand (card);

Consulte la documentación técnica para los campos que los componen.

Encabezado

  • client_id: valor obtenido del  menú Dev Tools > Mis Apps > Client ID y obligatorio en todas las peticiones
  • access_token: token de acceso obtenido previamente
  • x-issue-bank: identificación del banco emisor de la tarjeta, debe corresponder a uno de los valores presentados en la documentación técnica para permitir derivar adecuadamente las reglas de segmentación de socios
  • x-latam-test: fijo LatamPass, para usarse solo en el entorno de prueba, es decir, no debe usarse en el entorno de producción

Respuesta

Errores más comunes

Faltan campos obligatorios o valores inválidos

{
   "code": 400,
   "message": "Invalid request content",
   "instructions": "Evaluate the request fields",
   "issuedDateTime": "2024-10-01",
   "details": {
      "member.ffn": "must not be null"
   }
}

Límite de solicitud excedido

{
   "code": 429,
   "message": "Current rate exceeds the maximum for internal integrations",
   "instructions": "Please, try again late",
   "issuedDateTime": "2024-10-01",
   "details": null
}

Documentación técnica

Haga clic aquí para acceder.