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 fin del ciclo de vida, entonces, ocurre cuando una tarjeta vigente es cancelada o bloqueada, es decir, cuando los beneficios LATAM Pass ya no deben ser entregados 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 que se finalice un ciclo de vida se deben proporcionar los siguientes datos:

  1. Código de identificación del socio LATAM Pass o Frequent Flyer Number (ffn);
  2. Datos no confidenciales de la tarjeta de crédito cobrand (card).

Consultar 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-21T18:38:00.101662Z",
   "details": {
      "member.ffn": "must not be null",
      "card": "must not be null"
   }
}

No existe un ciclo de vida iniciado previamente para el socio, banco y tarjeta

{
   "code": 400,
   "message": "Member not found on database",
   "instructions": "Evaluate the request fields",
   "issuedDateTime": "2024-10-01T18:40:54.112746395Z",
   "details": null
}

Documentación técnica

Haga clic aquí para acceder.