Códigos de Erro e de Retorno

Ao utilizar a SmartPos, você receberá códigos de erro e de retorno que servem para te informar sobre o resultado da operação executada. Nessa página, os códigos são divididos em razão da origem da operação:

Código de resultado: oriundos da utilização do método getResult().
Código de erro: oriundos da utilização do método getErrorCode().
Códigos de erro de leitura de cartão.

As seções a seguir apresentam mais detalhes sobre os códigos de retorno que você pode receber.

Códigos de resultado

Códigos de retorno são obtidos ao chamar o método getResult() de um PlugPagTransactionResult retornado por um dos métodos de transação de um objeto PlugPag:

doPayment(PlugPagPaymentData)
voidPayment(PlugPagVoidData)
getLastApprovedTransaction()

A tabela abaixo apresenta a lista completa de códigos de retorno que você pode receber e suas respectivas descrições.

Valor	Descrição	Ação
0000	Transação concluída com sucesso.
1001	Mensagem gerada maior que buffer dimensionado.	Coletar log (se existir) e enviar para o suporte.
1002	Parâmetro de aplicação inválido.	Coletar log (se existir) e enviar para o suporte.
1003	Terminal não está pronto para transacionar.	Tente novamente.
1004	Transação não realizada.	Verificar mensagem retornada.
1005	Buffer de resposta da transação inválido ao obter as informações de resultado da transação.	Realizar consulta de última transação.
1006	Parâmetro de valor da transação não pode ser nulo.	Verificar implementação da chamada da biblioteca.
1007	Parâmetro de valor total da transação não pode ser nulo.	Verificar implementação da chamada da biblioteca.
1008	Parâmetro de código de venda não pode ser nulo.	Verificar implementação da chamada da biblioteca.
1009	Parâmetro de resultado da transação não pode ser nulo.	Verificar implementação da chamada da biblioteca.
1010	Driver de conexão não encontrado.	Verificar se todos os arquivos estão no diretório correto.
1011	Erro ao utilizar driver de conexão.	Reinstalar os arquivos do driver de conexão.
1012	Formato do valor da venda inválido.	Valor deve ser um número inteiro sem vírgula.
1013	Comprimento do código de venda superior a 10 dígitos.	Truncar código de venda para no máximo 10 dígitos.
1014	Buffer de recepção corrompido.	Refaça a transação.
1015	Nome da aplicação maior que 25 caracteres.	Limitar nome da aplicação a 25 caracteres.
1016	Versão da aplicação maior que 10 caracteres.	Limitar versão da aplicação em 10 caracteres.
1017	Necessário definir nome da aplicação.	Definir nome e versão da aplicação com setVersionName(String, String)
1018	Não existem dados da última transação.	Refaça a transação.
1019	Erro de comunicação com terminal (resposta inesperada).	Realizar consulta de última transação.
1024	Erro na carga de tabelas.	Refazer inicialização (carga de tabelas).
1030	Token não encontrado	Refazer autenticação.
1031	Valor inválido	Verificar o valor configurado para pagamento e tentar novamente. Valor mínimo: R$ 1,00
1032	Parcelamento inválido	Verificar o número de parcelas e tentar novamente.
1033	Erro de autenticação.	Verificar usuário/senha ou código de ativação e tentar novamente.
1034	Coeficientes de parcelamento ausentes.	Coeficientes de parcelamento (parcelado comprador) inválidos. Tente fazer novo login/ativação.
1035	Identificação de aparelho inválida.
1036	Pinpad (leitor) não inicializado.	Verificar se o método initializeAndActivatePinpad foi chamado corretamente no código.
1037	Pinpad (leitor) inválido.	Verificar o nome do pinpad (leitor) utilizado no código.
1038	Valor inválido	Verificar se o valor sendo transacionado é válido.
1047	PP 1047	Forçar parada do PlugPag e entrar novamente no App.
3001	Permissão de root	Remover permissão de root do aparelho.
4046	Não existe dados de autenticação	Efetuar a autenticação.

Código de erro

Códigos de retorno são obtidos ao chamar o método getErrorCode() de um PlugPagTransactionResult retornado por um dos métodos de transação de um objeto PlugPag:

doPayment(PlugPagPaymentData)
voidPayment(PlugPagVoidData)
getLastApprovedTransaction()

A tabela abaixo apresenta a lista completa de códigos de retorno que você pode receber e suas respectivas descrições.

Valor	Descrição	Ação	Observação
S01	Erro imprevisto	Enviar para análise o email do vendedor, data, hora e número do terminal.
S02	Tempo de operação excedido	Tentar passar a venda novamente, se o problema persistir, pode haver alguma indisponibilidade.
S03	Conexão recusada	Tentar passar a venda novamente, se o problema persistir, pode haver alguma indisponibilidade.
S04	Erro imprevisto	Enviar para análise o email do vendedor, data, hora e número do terminal.
S05	Erro imprevisto	Enviar para análise o email do vendedor, data, hora e número do terminal.
S06	Erro imprevisto	Enviar para análise o email do vendedor, data, hora e número do terminal.
S07	Erro imprevisto	Enviar para análise o email do vendedor, data, hora e número do terminal.
S08	Transação não encontrada	Enviar para análise o email do vendedor, data, hora e número do terminal.
S09	Tempo de operação excedido	Vendedor deve passar a venda novamente.
S12	Erro imprevisto	Enviar para análise o email do vendedor, data, hora e número do terminal.
S14	Modo de entrada inválido	Se a transação passou com a autenticação pelo chip, o estorno deve ser efetuado com o chip, se passou na tarja, estorno com tarja.
S15	Bin-Holder inválido	Fazer estorno com o mesmo cartão que passou a transação.
S16	Transação já estornada
S17	Erro imprevisto	Enviar para análise o email do vendedor, data, hora e número do terminal.
S18	TLV de resposta com tamanho maior que o esperado	Enviar para análise o email do vendedor, data, hora e número do terminal.
S19	Modo inválido	Se a transação for de crédito, verificar se o cartão possui o modo crédito habilitado, mesmo caso para débito.
S20	Transação duplicada	Se a intenção for realmente passar 2x o mesmo valor no mesmo cartão, o valor deverá ser alterado..
S21	Operação não realizada. Digite senha para esta operação	Digitar a senha.
S22	Use CHIP para esta transação	Efetuar o estorno usando o chip.
S24	Erro na abertura do criptograma	Enviar para análise o email do vendedor, data, hora e número do terminal.
S25	Erro ao confirmar transação	Tentar passar a venda novamente.
S26	Terminal não encontrado	Verificar cadastro do terminal no sistema.
S28	Produto não habilitado	Cliente deve se cadastrar na bandeira de voucher desejada.
S29	Falha ao gerar MAC	Entrar em contato com PagSeguro/Integrações
S30	Apenas Estorno Total Permitido	Realizar Estorno Total.
S31	Erro na validação da Mensagem de Resposta	Entrar em contato com PagSeguro/Integrações
S32	Chave POS Inválida	Entrar em contato com PagSeguro/Integrações
S33	Chave POS Inválida	Entrar em contato com PagSeguro/Integrações
S38	Transação Inválida	Entrar em contato com PagSeguro/Integrações
S39	Transação Inválida	Realizar a venda à vista.
S40	Transação Inválida	Entrar em contato com PagSeguro/Integrações
S41	Transação Inválida	Entrar em contato com PagSeguro/Integrações
S42	Transação MasterDebit Inválida	Utilizar a função débito e não crédito.
S96	Chave POS Inválida	Entrar em contato com PagSeguro/Integrações
S99	Transação não autorizada Pagseguro	Validar com o comercial da conta/área de risco.
S899	Transação não autorizada PagSeguro	Validar com o comercial da conta/área de risco.
S510	Funcao indisponivel no momento. Cancele pelo site PagSeguro	O estorno deve ser efetuado pelo iBanking.
A001	Operação cancelada.	Usuário cancelou a operação em curso.
A002	Moderninha Desativada.	Moderninha não está ativada.
A003	Não há mensagem a ser exibida.	Não há última mensagem de erro a ser exibida.
A004	Operação não realizada.	Transação negada pelo Host.
A008	Cartão inválido.	Pode ocorrer porque o usuário utilizou uma bandeira que o PagSeguro não aceita ou ele passou o cartão na modalidade errada (cartão de crédito no modo débito ou vice e versa) ou por outros motivos desconhecidos.
A009	Operação não realizada pelo cartão.	Erro inesperado pelo terminal.
A010	Operadora de telefonia indisponível. Tente novamente.	Problema de comunicação com a operadora de Telefonia.
A011	Operadora de telefonia indisponível. Tente novamente.	O tempo para que o host respondesse a uma mensagem enviada pelo terminal foi excedido.
A012	Falha na transação. Tente novamente.	Entrar em contato com PagSeguro/Integrações.
A013	Falha na transação .Tente novamente.	Entrar em contato com PagSeguro/Integrações.
A014	Erro de SIMCARD (chip). Contate a central de Suporte.	Erro de SIM Card. Ocorreu um erro de comunicação entre o terminal e o SIM Card.
A015	Erro de SIMCARD (chip) Contate a central de suporte.	SIM Card ausente.
A016	Operadora de telefonia indisponível. Tente novamente.	Sem sinal de operadora GSM.
A017	Problema na comunicação. Contate o PagSeguro.	Não foi possível se conectar na Operadora (Erro de Attach).
A018	Falha na autenticação PPP.Contate a central de suporte.	Problema para se conectar na rede GPRS (Erro de Contexto).
A019	Problema na comunicação. Tente novamente.	Não foi possível se conectar com o Host (erro Socket).
A021	Impressora sem papel. Troque a bobina.	O papel da impressora acabou.
A022	Operação não autorizada.	Operação não autorizada pelo Host.
A023	Rede WiFi indisponível. Tente novamente.	Não há nenhuma rede Wi-Fi disponível.
A024	Não conectada a rede WiFi.	Execute a função Configurar WiFi.
A025	Erro de SIM CARD (chip).	Contate a central de suporte.
A026	Problema de Sobretensão.	Impressora acusando sobretensão.
A027	Problema de superaquecimento.	Impressora acusando superaquecimento.
A028	O SIM Card ainda não respondeu. Aguarde.	Aguardando o modem responder a inicialização.
A029	Erro de Autenticação WiFi. Verifique sua conexao WiFi.	Verificar se a senha da rede WiFi foi digitada corretamente ou a rede esta configurada corretamente.
A030	Erro de Conexão. Tente Novamente.	Erro de conexão com o PagSeguro, Internet do cliente esta OK.
A031	Erro de Conexão. Verifique a conexão com a Internet.	Erro de conexao com o PagSeguro, cliente sem Internet.
A032	Erro de Autenticação WiFi. Verifique sua conexao WiFi.	Erro de conexão com uma rede WiFi.
A033	Erro de Conexão WiFi. Verifique sua conexão.	Cliente não tem conectividade GPRS. Possui rede WiFi conhecida mas esta desconectado e fora de alcance.
A034	Erro de Conexão. Verifique SIMCARD (chip) e sua rede WiFi.	Cliente com Erro de SIM Card e problema na rede WiFi.
A035	Falha na transação.	Tente novamente.
A037	Falha na transação.	Tente novamente.
A038	Falha na transação.	Tente novamente.
A038	Falha na transação.	Tente novamente.
A039	Falha na transação.	Tente novamente.
A039	Tente novamente tempo de comunicação excedido.	O tempo para realizar a transação foi maior que o esperado pelo terminal.
A040	Falha na transação.	Tente novamente.
A040	Falha na transação.	Tente novamente.
A041	Falha na transação.	Tente novamente.
A042	Falha na transação.	Tente novamente.
A043	Falha na transação.	Tente novamente.
A043	Falha na comunicação, tente novamente.	O modem do terminal não está conseguindo se comunicar com a operadora.
A044	Falha na transação.	Tente novamente.
A044	Falha na comunicação tente novamente.	O modem do terminal não está conseguindo se comunicar com a operadora.
A045	Falha na transação.	Tente novamente.
A045	Falha na comunicação tente novamente.	O modem do terminal não está conseguindo se comunicar com a operadora.
A046	Falha na transação.	Tente novamente.
A046	Falha na comunicação tente novamente.	O modem do terminal não está conseguindo se comunicar com a operadora.
A047	Falha na transação.	Tente novamente.
A047	Falha na comunicação tente novamente.	O modem do terminal não está conseguindo se comunicar com a operadora.
A048	Falha na transação. Tente Novamente.	Erro SSL(wifi).
A049	Falha na transação. Tente Novamente.	Erro SSL(wifi).
A050	Erro de comunicação WIFI. Tente novamente.	O WIFI não está conseguindo se comunicar com o servidor do PagSeguro ou o certificado SSL do terminal não conseguiu autenticação.
A052	Erro de impressão devido a bateria fraca. Conecte o carrgador e tente novamente.	Bateria com pouca carga.
A053	Falha na comunicação tente novamente.	A comunicação entre o terminal e o servidor foi interrompida. Tente novamente.
A054	Falha na comunicação tente novamente.		O modem do terminal não está conseguindo se comunicar com a operadora.
A055	Falha na comunicação tente novamente.		O modem do terminal não está conseguindo se comunicar com a operadora.
A056	Falha na comunicação tente novamente.		O modem do terminal não está conseguindo se comunicar com a operadora.
A057	Falha na comunicação tente novamente.		O modem do terminal não está conseguindo se comunicar com a operadora.
A058	Problema na comunicação, tente novamente.	Timeout na subida da transação para o servidor.
A059	Problema na comunicação. Aguarde alguns minutos e tente novamente.	Semelhante ao erro A017 (Erro de Attach) porém devido a camada SS (Supplementary service).
A099	Terminal não configurado.	Os Parâmetros de comunicação não estão configurados corretamente.
A099	Erro nas tabelas de inicialização.	Houve algum erro na carga de tabelas de inicialização.
A099	Erro 5009.	Terminal não configurado.
A099	Erro 5024.	Problema no carregamento de alguns dados da nova versão para o terminal.
A099	Erro 5127.	Erro no cabeçote de impressão.
A102	Problema de comunicação.	Erro genérico de comunicação.
A104	Problema na comunicação Contate o PagSeguro.
A201	Parâmetro invalido.	Erro interno da aplicação, função retornou valores inválidos.
A202	Operação cancelada pelo usuário.	Usuário apertou o botão cancelar.
A205	Erro na inicialização reinicie o terminal.	Erro durante a inicialização, refaça o processo.
A206	Operação não realizada tente novamente .	Erro no retorno dos valores de parcelamento.
A207	Operação não realizada tente novamente .	Erro no retorno dos valores de estorno.
A208	Senha incorreta tente novamente.	Senha administrativa incorreta.
A209	Transação negada. Refaça a transação.	O Servidor negou a transação.
A214	Falha na comunicação tente novamente.	Erro na configuração do protocolo de envio da comunicação GPRS.
A215	Falha na comunicação tente novamente.	Erro na configuração do protocolo de envio da comunicação GPRS.
A219	Tente novamente erro na comunicação.	Erro na configuração do protocolo de envio da comunicação GPRS.
A220	Tente novamente erro na comunicação.	Erro na configuração do protocolo de envio da comunicação GPRS.
A221	Tente novamente erro na comunicação.	Erro na configuração do protocolo de envio da comunicação GPRS.
A222	Tente novamente erro na comunicação.	Erro na configuração do protocolo de envio da comunicação GPRS.
A223	Tente novamente. Tempo de comunicação excedido.	Erro na configuração do protocolo de envio da comunicação GPRS.
A224	Tente novamente erro na comunicação.	Erro na configuração do protocolo de envio da comunicação GPRS.
A225	Falha na comunicação tente novamente.	Erro na configuração do protocolo de envio da comunicação GPRS.
A226	Falha na comunicação tente novamente.	Erro na configuração do protocolo de envio da comunicação GPRS.
A227	Falha na comunicação tente novamente.	Erro na configuração do protocolo de envio da comunicação GPRS.
A228	Falha na comunicação tente novamente.	Erro na configuração do protocolo de envio da comunicação GPRS.
A229	Falha na comunicação tente novamente.	Erro na configuração do protocolo de envio da comunicação GPRS.
A230	Falha na comunicação tente novamente.	Erro na configuração do protocolo de envio da comunicação GPRS.
A231	Tente novamente falha na operação com o servidor.	Erro na configuração do protocolo de envio da comunicação GPRS.
A232	Tente novamente falha na operação com o servidor.	Erro na configuração do protocolo de envio da comunicação GPRS.
A233	Tente novamente falha na operação com o servidor.	Erro na configuração do protocolo de envio da comunicação GPRS.
A234	Tente novamente falha na operação com o servidor.	Erro na configuração do protocolo de envio da comunicação GPRS.
A235	Tente novamente falha na operação com o servidor.	Erro na configuração do protocolo de envio da comunicação GPRS.
A236	Tente novamente falha na operação com o servidor.	Erro na configuração do protocolo de envio da comunicação GPRS.
A237	Tente novamente falha na operação com o servidor.	Erro na configuração do protocolo de envio da comunicação GPRS.
A238	Tente novamente falha na operação com o servidor.	Erro na configuração do protocolo de envio da comunicação GPRS.
A239	Opção de menu invalida.	Opção de menu inválida. Não deve ser exibido na aplicação.
A240	Tempo de operação excedido.	Aplicação demorou mais tempo que o previsto para processar a operação
A242	Operação cancelada pelo usuário.	Usuário cancelou a operação.
A243	Tente novamente falha na operação reinicie o terminal .	Aplicação não conseguiu executar uma operação com algum arquivo.
A244	Tente novamente falha na operação reinicie o terminal .	Aplicação não conseguiu executar uma operação com algum arquivo.
A245	Tente novamente falha na operação reinicie o terminal .	Aplicação não conseguiu executar uma operação com algum arquivo.
A246	Erro de autenticação WIFI. Verifique a conexão.	Erro interno do WIFI.
A247	Redes WIFI não localizadas. Tente novamente .	Erro ao buscar redes ou nenhuma rede encontrada
A248	Bateria fraca. Conecte o carregador e tente novamente.	Bateria com pouca carga
A249	Impressora ocupada. Aguarde a impressora terminar de imprimir para tentar novamente.	Usuário tentou realizar impressão enquanto já havia outra operação de impressão sendo executada.
A250	Impressora sem papel. Troque a bobina e tente novamente.	A bobina do dispositivo acabou.
A251	Erro no formato do pacote de dados para impressão. Tente outro formato de arquivo.	Usuário tentou realizar impressão com arquivo de formato incompatível.
A252	Impressora defeituosa. Entre em contato com o suporte.	Erro desconhecido da impressora.
A253	Superaquecimento na impressora. Tente novamente mais tarde.	Impressora superaqueceu.
A254	Erro de impressão devido a bateria fraca. Conecte o carregador e tente novamente.	Bateria com pouca carga.
A255	Tente novamente mais tarde ou envie o comprovante agora por e-mail ou sms.	Terminal está enviando confirmação da transação.
A256	Erro de impressão. Arquivo não encontrado.	Arquivo para impressão não encontrado.
A09404		Prolema na comunicação com o Mobile.
M1000	Requisição não pode ser completada.	Por favor tente novamente mais tarde.
M1003	A requisição não pode ser executada.	Por favor tente novamente mais tarde.
M2006	Valor de parcelamento invalido.	O valor da parcela deve ser igual ou maior que R$5,00.
M2007	Quantidade de parcelas inválida.
M2010	Tipo de parcelamento inválido.
M2017	Erro ao estornar transação.	Por favor tente novamente mais tarde.
M2018	Valor para parcelamento inválido.
M2019	Número do cartão inválido.
M2020	Valor da transação deve ser igual ou maior que R$1,00.
M2022	Não foi possível identificar o cartão.
M2035	Transação não autorizada pelo emissor do cartão.
M2036	Dados do cartão inválidos.
M2042	Sua conta PagSeguro foi encerrada.	Entre em contato com o PagSeguro.
M2047	Transação não autorizada.
M2048	Por favor, verifique sua senha.
M2049	Por favor, digite no máximo 10 caracteres.	O campo userReferece só recebe até 10 caracteres.
M2050	Por favor, digite somente letras e números.	O campo userReferece só recebe letras e números.
M2054	Atualize a versão do aplicativo para prosseguir com a operação.
M2060	Operação não realizada.
M2069	Para voltar a vender, atualize sua moderninha.
M3004	Transação não encontrada.	A transação já pode ter sido estornada.
M3005	Data máxima para estorno da transação foi excedida.
M3006	Transação não pode ser estornada.
M3008	Transação não pode ser estornada.
M3009	Transação não pode ser confirmada.
M3010	Transação não pode ser cancelada.
M3011	Transação não autorizada.
M3012	Transação não autorizada Pagseguro.	Contate seu gerente comercial/área de risco.
M3013	Vendedor bloqueado.	Contate seu gerente comercial.
M3014	Email não confirmado no Pagseguro. Por favor verique o seu email.
M3017	Tente novamente.
M3020	Não é possível realizar a venda por cartão internacional.
M3021	Por favor, refaça o login no aplicativo.	Refaça a ativação do terminal.
M3022	Não foi possível configurar o parcelamento.
M3023	Não foi possível localizar, o reference está duplicado.
M3024	Transação não autorizada Pagseguro.	Contate seu gerente comercial/área de risco.
M5000	Leitor ou código de ativação inválido.	Verificar se o código de ativação está correto
M5001	Bin inválido.
M5002	Holder inválido.
M5003	Serial number do leitor embarcado inválido.
M5004	Numero serial do leitor não identificado.
M5005	Leitor inativo.
M5007	Código incorreto verificar se o código de ativação digitado está correto	Aguarde 30 minutos para tentar novamente.

Códigos de erro de leitura de cartão

Códigos de retorno também podem ser recebidos em casos de falha durante a leitura do cartão. Nesses casos, o erro está associado a algum problema de conexão entre a aplicação selecionada e o terminal. A tabela abaixo apresenta os possíveis códigos de retorno que você pode receber e as respectivas descrições.

Valor	Descrição	Ação
C010	Erro Pinpad.	Equipamento deve ser trocado.
C013	Operação cancelada.	Tentar Novamente.
C018	Função não disponível na Biblioteca do pinpad.	Falha no processamento dos dados, solicitar que o vendedor tente novamente.
C033	Chave Pos inválida.	Equipamento deve ser trocado.
C040	Erro interno do pinpad.	Equipamento deve ser trocado.
C042	Leitor sem a chave requerida.	Forçar nova carga de tabelas.
C060	Cartão com erro ou mal inserido.	Tentar novamente, se não funcionar, usar outro cartão.
C061	Cartão com erro ou mal inserido.	Tentar novamente, se não funcionar, usar outro cartão.
C062	Cartão inválido.	Cartão não é aceito. Usar outro cartão.
C063	Cartão bloqueado.	Cartão está bloqueado. Desbloquear ou usar outro cartão.
C064	Cartão inválido.	Cartão não é aceito. Usar outro cartão.
C065	Cartão expirado.	Usar outro cartão.
C066	Cartão inválido.	Cartão não é aceito. Usar outro cartão.
C067	Cartão invalidado.	Cartão está bloqueado. Entre em contato com o banco emissor ou use outro cartão.
C068	Cartão inválido.	Cartão não é aceito. Usar outro cartão.
C069	Cartão inválido.	Cartão não é aceito. Usar outro cartão.
C070	Modo inválido.	Pode ter sido selecionado um modo que o cartão não possui(débito, crédito ou financiamento).
C071	Cartão não aceito.	Bandeira não aceita. Usar um cartão com uma das bandeiras aceitas.
C076	Cartão inválido.	Cartão não é aceito. Usar outro cartão.
C84	Opção selecionada Inválida.	Produto contatless diferente do selecionado para pagamento.