---
updatedAt: 2026-08-13T15:05:22.000Z
agentTools:
  siteIndex: https://docs.cielo.com.br/llms.txt
  projectIndex: https://docs.cielo.com.br/conecta/llms.txt
---

# PPC_CMD_MF_AUTH

Este comando efetua o processo de autenticação de um bloco usando uma chave fornecida. Se a chave não for definida, a chave padrão de fábrica será usada. Se for fornecido o número de série do cartão (opcional), a chave é obrigatória. A autenticação é necessária para executar outros comandos.

# Parâmetros de entrada

| Constante            | Presença | Observação                                                                |
| -------------------- | -------- | ------------------------------------------------------------------------- |
| PPC\_INP\_MF\_BLKADR | M        | Block Address ("0000" a "9999").                                          |
| PPC\_INP\_MF\_KEYTYP | M        | Key Type, "A" ou "B".                                                     |
| PPC\_INP\_MF\_KEYVAL | O        | Key Value. Se não definido, será usado o valor "default" de fábrica.      |
| PPC\_INP\_MF\_SERNO  | O        | Serial Number. Se fornecido, PPC\_INP\_MF\_KEYVAL passa a ser mandatório. |

# Dados de resposta

Não há.

# Retorno

| Retorno            | Descrição                                                                              |
| ------------------ | -------------------------------------------------------------------------------------- |
| PPC\_OK            | Sucesso.                                                                               |
| PPC\_NOTOPEN       | Comando PPC\_CMD\_OPEN não foi previamente chamado.                                    |
| PPC\_NOCARD        | Não há cartão no leitor.                                                               |
| PPC\_CARDINV       | Cartão não suportado.                                                                  |
| PPC\_CTLSSMULTIPLE | Mais de um cartão apresentado.                                                         |
| PPC\_CTLSSCOMMERR  | Erro de comunicação com o cartão.                                                      |
| PPC\_CTLSSAPPNAUT  | Falha no processo de autenticação, na chave fornecida ou no número de série fornecido. |

Outros retornos: Ver [Códigos de retorno](https://docs.cielo.com.br/conecta/docs/codigos-de-retorno-1).