Códigos de resposta
Como o SDK interpreta o CODRESP do m-SiTef e como tratar cada categoria no seu aplicativo
Em construção
O m-SiTef devolve o desfecho da transação no extra CODRESP. O SDK traduz esse número em
CodResp, com código, categoria e descrição, para o seu app não precisar interpretar
números soltos.
data class CodResp(
val code: Int,
val category: Category, // SUCCESS | DENIED | CANCELED | ERROR
val description: String,
)Categorias
Trate a venda pela categoria; use o código apenas em log e suporte.
| Categoria | Significado | O que fazer no app |
|---|---|---|
SUCCESS | CODRESP == 0 — função executada com sucesso | Exibir comprovante e concluir o pedido |
DENIED | Recusada pelo autorizador ou pelo servidor SiTef | Informar a recusa e oferecer outro meio de pagamento |
CANCELED | Cancelada pelo operador, pelo portador ou pela automação | Voltar ao carrinho sem tratar como erro |
ERROR | Configuração, comunicação, parâmetros ou erro interno | Exibir mensagem técnica e registrar para suporte |
approved só é true quando a Activity retorna RESULT_OK e CODRESP == 0. Um
CODRESP ausente ou mal formado vira categoria ERROR — nunca é interpretado como
aprovação.
Códigos positivos
Indicam erro de inicialização ou configuração; categoria ERROR.
| Código | Descrição |
|---|---|
1 | Endereço IP inválido ou não resolvido |
2 | Código da loja inválido |
3 | Código de terminal inválido |
6 | Erro na inicialização do TCP/IP |
7 | Falta de memória |
8 | Não encontrou a CliSiTef ou ela está com problemas |
9 | Configuração de servidores SiTef foi excedida |
10 | Erro de acesso na pasta CliSiTef (possível falta de permissão de escrita) |
11 | Dados inválidos passados pela automação |
12 | Modo seguro não ativo |
13 | Caminho DLL inválido |
Qualquer outro código positivo é classificado como DENIED — negada pelo autorizador.
Códigos negativos
| Código | Descrição | Categoria |
|---|---|---|
-1 | Módulo não inicializado | ERROR |
-2 | Operação cancelada pelo operador | CANCELED |
-3 | Função/modalidade inexistente ou inválida | ERROR |
-4 | Falta de memória no PDV | ERROR |
-5 | Sem comunicação com o SiTef | ERROR |
-6 | Operação cancelada pelo usuário (no pinpad) | CANCELED |
-9 | Função iterativa continuada sem ter sido iniciada | ERROR |
-10 | Parâmetro obrigatório não passado pela automação | ERROR |
-12 | Erro na execução de rotina iterativa | ERROR |
-13 | Documento fiscal não encontrado nos registros da CliSiTef | ERROR |
-15 | Operação cancelada pela automação comercial | CANCELED |
-20 | Parâmetro inválido passado para a função | ERROR |
-25 | Erro no Correspondente Bancário: deve realizar sangria | ERROR |
-30 | Erro de acesso ao arquivo (direitos de leitura/escrita) | ERROR |
-40 | Transação negada pelo servidor SiTef | ERROR |
-41 | Dados inválidos | ERROR |
-43 | Problema na execução de rotina no pinpad | ERROR |
-50 | Transação não segura | ERROR |
-100 | Erro interno do módulo | ERROR |
Códigos negativos fora desta lista são classificados como ERROR com a descrição
genérica "Erro detectado internamente pela rotina".
Diagnóstico dos erros mais comuns
| Código | Causa provável na integração |
|---|---|
-5 | Aparelho sem internet, ou enderecoSitef inacessível a partir da rede do vendedor |
-10 | Extra obrigatório ausente — normalmente configuração incompleta vinda do backend |
2 / 3 | empresaSitef ou terminal não provisionados para aquele PDV |
-2 / -6 | Fluxo normal: alguém desistiu da cobrança |
A tabela reproduz a "Tabela 3 — Valores do CODRESP" do guia de integração do m-SiTef.
Códigos específicos de Tap on Phone que venham a ser publicados pela Fiserv caem hoje na
classificação genérica por sinal (DENIED para positivos, ERROR para negativos), sem
quebrar o seu app.