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 início do ciclo de vida, então, acontece quando um novo cartão é aprovado ou um cartão atual é desbloqueado, ou seja, quando os benefícios do LATAM Pass devem 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:

Requisição

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

Dados do cliente LATAM Pass (member);
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-01",
   "details": {
      "member.ffn": "must not be null"
   }
}

Limite de requisições foi excedido

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

Documentação técnica

Clique aqui para acessá-la.

Iniciar ciclo de vida