Introdução

A API PNA Cobrand LATAM Pass é a forma pela qual os nossos parceiros bancos fazem a gestão do ciclo de vida de benefícios que são entregues aos nossos clientes LATAM Pass detentores de cartão cobrand.

O fim do ciclo de vida, então, acontece quando um cartão atual é cancelado ou bloqueado, ou seja, quando os benefícios do LATAM Pass devem deixar de ser entregues ao cliente.

Para poder realizar requisições à API, deve-se primeiro obter o token de acesso. Consulte a documentação Autenticação para todas as informações.

Cronograma base

Acesse por meio dos itens abaixo o cronograma base de cada tipo de parceria do programa:

  1. Novas parcerias;
  2. Parcerias vigentes migrando para a API PNA LATAM Pass.

Requisição

Para que um ciclo de vida seja finalizado, é necessário informar os seguintes dados:

  1. Código de identificação do cliente LATAM Pass ou Frequent Flyer Number (ffn);
  2. Os dados não sensíveis do cartão de crédito cobrand (card);

Consulte a documentação técnica para os campos que os compõem.

Cabeçalho

  • client_id: valor obtido a partir do menu API Tools > Minhas Apps > Client ID e obrigatório em todas as requisições
  • access_token: token de acesso obtido anteriormente
  • x-issue-bank: identificação do banco emissor do cartão, deve corresponder a um dos valores apresentados na documentação técnica para devidamente permitir derivar as regras para segmentação do cliente
  • x-latam-test: fixo LatamPass, a ser utilizado apenas em ambiente de teste, ou seja, não deve ser utilizado em ambiente de produção

Resposta

Erros mais comuns

Campos obrigatórios ausentes ou 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"
   }
}

Não há um ciclo de vida iniciado anteriormente para o cliente, banco e cartão

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

Documentação técnica

Clique aqui para acessá-la.