Introdução

A API PNA Cobrand LATAM Pass é a forma pela qual nossas parcerias bancárias gerenciam o ciclo de vida dos benefícios entregues aos nossos associados LATAM Pass que possuem um cartão cobrand.

O encerramento do ciclo de vida ocorre quando um cartão vigente é cancelado ou bloqueado, ou seja, quando os benefícios LATAM Pass não devem mais ser entregues ao associado.

Importante: Um código de status 200 não significa que o cartão foi desativado com sucesso. O resultado final pode ser consultado 24 horas após a criação do processamento, utilizando o correlationId obtido na resposta.

Para realizar requisições à API, primeiro é necessário obter o token de acesso. Consulte a documentação Autenticação para obter todas as informações.

Cronograma base (Carta Gantt)

Acesse o cronograma base para cada tipo de parceria com o programa utilizando os seguintes links:

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

Fluxo do processo

Requisição

Cabeçalhos

Corpo (Body)

CobrandedLifeCycleDeleteRequest

MemberSimplified

Card

Os campos marcados com (*) podem ser obrigatórios ou não conforme a configuração do banco emissor do cartão.

Exemplo de requisição

Pode variar dependendo das configurações do banco emissor

{
  "member": {
    "ffn": "68245775886"
  },
  "card": {
    "brand": "VISA",
    "category": "PLATINUM",
    "lastFour": 1234,
    "approvedAt": "2026-06-15T22:49:47.035Z"
  }
}

Resposta

200 — Requisição recebida

Um código 200 indica que a requisição foi recebida e o processamento foi criado. Não garante que o cartão foi desativado. O resultado final deve ser consultado com o correlationId através do endpoint de consulta de status.

CobrandedLifeCycleDeleteResponse

MemberSimplified

Trace

{
  "member": {
    "ffn": "68245775886"
  },
  "trace": {
    "correlationId": "96bd0750-71e0-4ed6-9489-96ddfd0e34cd",
    "threadId": "c0fead84-234d-4fb2-a865-b070f77ec086",
    "receivedDateTime": "2023-10-05T12:53:00Z",
    "returnedDateTime": "2023-10-05T12:53:24Z"
  }
}

Erros mais comuns

Campos obrigatórios ausentes ou valores inválidos

{
  "code": 1,
  "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 existe um ciclo de vida iniciado anteriormente para o associado

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

Limite de requisições excedido

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

Erro interno do servidor

{
  "code": 33,
  "message": "Internal server error",
  "instructions": "Retry the request later. If the problem persists, contact LATAM Pass support with the correlationId.",
  "issuedDateTime": "2023-10-05T12:53:10Z",
  "details": {
    "correlationId": "96bd0750-71e0-4ed6-9489-96ddfd0e34cd"
  }
}

Estrutura de ErrorException

Documentação técnica

Clique aqui para acessar a especificação técnica completa (Swagger).