Esta página cataloga os códigos de resultado que o SDK White Label retorna. Use-a para associar um código à sua causa e decidir como reagir. Para um passo a passo orientado a tarefas, consulte Solução de problemas.
Esquema de códigos de resultado
Todo desfecho carrega um código de resultado. O prefixo identifica a classe da falha.
Prefixo
Tipo
Significado
00
SUCCESS
Transação aprovada ou paga.
1-
POS_ERROR
Erro local, do terminal, de leitura do cartão ou do operador (família ADQ).
3-
Criptográfico
Reservado para erros criptográficos. Está definido, mas hoje não é emitido.
33-
HOST_ERROR
Erro do serviço de pagamento (SEP) — um erro HTTP ou uma recusa do host.
Exemplos
Código
Significado
00
Aprovada.
1-02
Cancelada pelo usuário ou pelo operador (ou um TIMEOUT / CANCELED do kernel).
1-21
Recusa offline ou erro genérico do terminal.
33-<reason>
Recusa do host. <reason> é o reason_code da resposta do SEP (HTTP 200, DENIED).
33-<httpCode>
Erro HTTP retornado pelo SEP, por exemplo 33-400, 33-401, 33-500.
33-99
Erro genérico do host, sem código utilizável.
Os erros de host estão migrando do prefixo antigo 4-xx para 33-xx: os dígitos não mudam (4-503 passa a ser 33-503). Terminais que ainda não foram atualizados podem retornar 4-xxx. Trate 4-xxx e 33-xxx como equivalentes.
Categorias de causa
Toda não aprovação pertence a uma categoria, que indica como reagir. Cada código de host abaixo traz a sua categoria.
Categoria
Significado
Portador / cartão
O emissor ou o cartão recusou a operação. Peça outro cartão ou oriente o cliente a falar com o banco.
Transitório — nova tentativa
Condição temporária. Tente de novo após uma breve espera; se houve timeout, consulte a transação antes.
Duplicada / em andamento
A transação pode já estar concluída ou cancelada. Consulte antes de tentar de novo.
Referência não encontrada
O paymentId ou a referência não corresponde a nenhuma transação. Confirme o valor e o ambiente.
Configuração do estabelecimento / produto
O estabelecimento, o produto, a bandeira ou o terminal não está habilitado. Fale com a Getnet.
Autenticação
O terminal não conseguiu se autenticar no gateway. Verifique as credenciais e o ambiente.
Integração / requisição
A requisição estava malformada ou foi rejeitada pela validação. Corrija a integração.
Plataforma / sistema
Falha no lado do servidor. Tente de novo uma vez; se persistir, trate como incidente.
Estrutura do erro de host
Os erros de host (33-) têm origem no gateway do SEP. O campo em que você deve ramificar é o error_code; o reason_code traz o motivo do emissor em uma recusa.
Campo
Descrição
message
Mensagem de erro legível.
name
Tipo do erro, por exemplo GetnetTransactionError.
status_code
Status HTTP da resposta, por exemplo 400.
details[].status
Status da transação, por exemplo DENIED.
details[].error_code
O código de erro em que você deve ramificar, por exemplo PAYMENTS-999.
details[].reason_code
Motivo do emissor em uma recusa, por exemplo 503.
Erros de host (33-) por status HTTP
HTTP 400 — 33-400
error_code
Categoria
Descrição
PAYMENTS-012
Integração / requisição
Valor informado é maior ou igual ao valor da transação.
PAYMENTS-013
Integração / requisição
Valor da parcela inválido.
PAYMENTS-015
Portador / cartão
Entre em contato com o emissor.
PAYMENTS-016
Integração / requisição
NSU inválido.
PAYMENTS-019
Portador / cartão
Data de emissão do cartão inválida.
PAYMENTS-020
Portador / cartão
Data de validade inválida.
PAYMENTS-024
Transitório — nova tentativa
Transação revertida.
PAYMENTS-025
Portador / cartão
Autenticação inválida.
PAYMENTS-026
Portador / cartão
Autorização inválida.
PAYMENTS-029
Integração / requisição
Pré-autorização inválida.
PAYMENTS-044
Integração / requisição
Erro de formato.
PAYMENTS-050
Portador / cartão
Entre em contato com a instituição.
PAYMENTS-051
Portador / cartão
Recusada por uma regra configurada.
PAYMENTS-054
Duplicada / em andamento
Confirmação pendente.
PAYMENTS-055
Transitório — nova tentativa
Transação cancelada.
PAYMENTS-056
Portador / cartão
Transação não permitida neste ciclo.
PAYMENTS-058
Transitório — nova tentativa
Reverta a transação.
PAYMENTS-060
Integração / requisição
Cartão obrigatório para a transação.
PAYMENTS-061
Portador / cartão
Rejeição genérica.
PAYMENTS-066
Configuração do estabelecimento / produto
Meio de pagamento inválido.
PAYMENTS-068
Portador / cartão
Dígito do cartão inválido.
PAYMENTS-069
Duplicada / em andamento
Transação repetida.
PAYMENTS-070
Portador / cartão
Número do cartão não corresponde.
PAYMENTS-072
Integração / requisição
A transação não pode ser cancelada.
PAYMENTS-073
Duplicada / em andamento
Transação já cancelada.
PAYMENTS-078
Integração / requisição
Dados inválidos no cancelamento.
PAYMENTS-079
Integração / requisição
Valor de cancelamento inválido.
PAYMENTS-080
Portador / cartão
Cartão inválido.
PAYMENTS-081
Integração / requisição
Após a data permitida.
PAYMENTS-082
Integração / requisição
Cancelamento inválido.
PAYMENTS-083
Portador / cartão
Use a função débito.
PAYMENTS-084
Portador / cartão
Use a função crédito.
PAYMENTS-085
Duplicada / em andamento
Transação já realizada.
PAYMENTS-090
Portador / cartão
Transação não autorizada pelo cartão.
PAYMENTS-091
Integração / requisição
Fora do período permitido.
PAYMENTS-093
Duplicada / em andamento
Autorização já em processamento.
PAYMENTS-094
Transitório — nova tentativa
Autorização aguardando confirmação de recebimento.
PAYMENTS-098
Configuração do estabelecimento / produto
Cliente não cadastrado.
PAYMENTS-117
Portador / cartão
Peça ao portador que ligue para o emissor.
PAYMENTS-118
Configuração do estabelecimento / produto
Cartão inválido ou produto não habilitado.
PAYMENTS-999
Transitório — nova tentativa
Transação não processada.
GENERIC-400
Portador / cartão
Cartão de crédito inválido.
GENERIC-400
Integração / requisição
Erro de validação.
GENERIC-400
Integração / requisição
Validação de cabeçalho.
GENERIC-400
Integração / requisição
Erro ao solicitar o cancelamento.
GENERIC-400
Plataforma / sistema
Erro de serviço.
GENERIC-400
Integração / requisição
Parâmetro inválido.
GENERIC-400
Integração / requisição
Argumento inválido.
GENERIC-400
Configuração do estabelecimento / produto
Código da bandeira não habilitado.
GENERIC-400
Integração / requisição
Erro de validação da consulta.
HTTP 401 — 33-401
error_code
Categoria
Descrição
GENERIC-401
Autenticação
Não autorizado.
HTTP 402 — 33-402
error_code
Categoria
Descrição
PAYMENTS-001
Integração / requisição
Valor não informado.
PAYMENTS-002
Portador / cartão
Cartão inválido.
PAYMENTS-003
Portador / cartão
Cartão expirado.
PAYMENTS-004
Integração / requisição
Parâmetro inválido.
PAYMENTS-005
Portador / cartão
Código de segurança inválido.
PAYMENTS-006
Configuração do estabelecimento / produto
Bandeira inválida.
PAYMENTS-007
Configuração do estabelecimento / produto
Operação não permitida.
PAYMENTS-008
Integração / requisição
Dados inválidos.
PAYMENTS-009
Integração / requisição
Valor mínimo da parcela inválido.
PAYMENTS-010
Integração / requisição
Número de parcelas inválido.
PAYMENTS-011
Integração / requisição
Número de parcelas acima do limite.
PAYMENTS-014
Configuração do estabelecimento / produto
Parcelamento não permitido.
PAYMENTS-022
Configuração do estabelecimento / produto
Código de moeda inválido.
PAYMENTS-023
Configuração do estabelecimento / produto
Bandeira não pertence à rede.
PAYMENTS-030
Portador / cartão
Erro na autenticação do usuário.
PAYMENTS-032
Portador / cartão
Negada pelo emissor.
PAYMENTS-033
Configuração do estabelecimento / produto
Estabelecimento inválido.
PAYMENTS-034
Configuração do estabelecimento / produto
Solicitação não autorizada.
PAYMENTS-036
Integração / requisição
Identificador da requisição inválido.
PAYMENTS-037
Duplicada / em andamento
Transação em andamento.
PAYMENTS-038
Integração / requisição
Transação inválida.
PAYMENTS-039
Integração / requisição
Valor da transação inválido.
PAYMENTS-041
Transitório — nova tentativa
Refaça a transação.
PAYMENTS-045
Portador / cartão
Cartão restrito.
PAYMENTS-046
Portador / cartão
Cartão perdido.
PAYMENTS-047
Portador / cartão
Cartão roubado.
PAYMENTS-048
Portador / cartão
Cartão não cadastrado.
PAYMENTS-049
Portador / cartão
Transação não permitida para este cliente.
PAYMENTS-052
Duplicada / em andamento
Transação duplicada.
PAYMENTS-053
Portador / cartão
Cartão bloqueado.
PAYMENTS-067
Portador / cartão
Valor limite excedido.
PAYMENTS-077
Portador / cartão
Número do cartão inválido.
PAYMENTS-096
Portador / cartão
Crédito excedido.
PAYMENTS-101
Plataforma / sistema
Autorizador offline.
PAYMENTS-102
Portador / cartão
Cliente sem limite de crédito.
PAYMENTS-103
Portador / cartão
Transação não autorizada pela rede autorizadora.
PAYMENTS-104
Integração / requisição
Erro de integração.
PAYMENTS-105
Portador / cartão
Transação não autorizada.
PAYMENTS-109
Duplicada / em andamento
Existe uma transação a confirmar.
PAYMENTS-112
Referência não encontrada
Nenhum documento correspondente para cancelar.
PAYMENTS-113
Portador / cartão
Saldo insuficiente.
PAYMENTS-114
Portador / cartão
Excede o limite de valor para aprovação.
PAYMENTS-115
Portador / cartão
Excede o limite de frequência de saques.
PAYMENTS-116
Portador / cartão
Autorização recusada.
SERVICE-402
Plataforma / sistema
Erro ao capturar a transação de crédito.
SERVICE-402
Plataforma / sistema
Erro ao ajustar a transação de pré-autorização de crédito.
GENERIC-402
Plataforma / sistema
Erro ao criar a transação diferida.
GENERIC-402
Integração / requisição
Pagamento diferido expirado.
GENERIC-402
Portador / cartão
Recusada pela análise antifraude.
GENERIC-402
Integração / requisição
Documento inválido.
GENERIC-402
Plataforma / sistema
Erro ao cancelar a transação de crédito.
GENERIC-402
Integração / requisição
Erro ao validar as regras de negócio.
HTTP 403 — 33-403
error_code
Categoria
Descrição
GENERIC-403
Configuração do estabelecimento / produto
Meio de pagamento não permitido.
GENERIC-403
Configuração do estabelecimento / produto
Tipo de bandeira não permitido.
GENERIC-403
Configuração do estabelecimento / produto
Serviço não habilitado.
GENERIC-403
Autenticação
Token inválido ou já usado.
GENERIC-403
Autenticação
Erro de não autorizado.
GENERIC-403
Configuração do estabelecimento / produto
Produto Pix não habilitado.
HTTP 404 — 33-404
error_code
Categoria
Descrição
PAYMENTS-043
Referência não encontrada
Registro não encontrado.
PAYMENTS-057
Referência não encontrada
A transação não existe.
PAYMENTS-076
Referência não encontrada
Transação não disponível.
PAYMENTS-095
Referência não encontrada
Autorização não encontrada.
GENERIC-404
Referência não encontrada
Erro ao criar a transação diferida.
GENERIC-404
Referência não encontrada
Transação não encontrada.
GENERIC-404
Referência não encontrada
Registro não encontrado.
HTTP 409 — 33-409
error_code
Categoria
Descrição
GENERIC-409
Integração / requisição
Não foi possível processar a requisição por conflito entre parâmetros.
HTTP 412 — 33-412
error_code
Categoria
Descrição
GENERIC-412
Integração / requisição
Parâmetro não encontrado.
GENERIC-412
Integração / requisição
Parâmetro não definido.
HTTP 422 — 33-422
error_code
Categoria
Descrição
GENERIC-422
Integração / requisição
Entidade não processável.
HTTP 500 — 33-500
error_code
Categoria
Descrição
PAYMENTS-042
Plataforma / sistema
Resposta inválida.
PAYMENTS-059
Transitório — nova tentativa
Problema na rede local.
PAYMENTS-062
Plataforma / sistema
Instituição temporariamente fora de operação.
PAYMENTS-063
Plataforma / sistema
Falha no sistema.
PAYMENTS-064
Plataforma / sistema
Erro no banco de dados.
PAYMENTS-071
Plataforma / sistema
Autorizador temporariamente bloqueado.
PAYMENTS-086
Plataforma / sistema
Erro na transação.
PAYMENTS-099
Plataforma / sistema
Autorizador não inicializado.
PAYMENTS-100
Plataforma / sistema
Canal desconectado.
PAYMENTS-107
Transitório — nova tentativa
Erro de comunicação.
PAYMENTS-500
Plataforma / sistema
Erro interno do servidor.
GENERIC-500
Plataforma / sistema
O servidor encontrou um erro inesperado.
HTTP 501 — 33-501
error_code
Categoria
Descrição
GENERIC-501
Plataforma / sistema
Resposta inválida do servidor upstream.
HTTP 503 — 33-503
error_code
Categoria
Descrição
PAYMENTS-021
Transitório — nova tentativa
Sistema do emissor indisponível — tente de novo.
GENERIC-503
Transitório — nova tentativa
O servidor não pode atender à requisição agora — tente mais tarde.
HTTP 504 — 33-504
error_code
Categoria
Descrição
PAYMENTS-031
Transitório — nova tentativa
Tempo excedido (timeout).
PAYMENTS-089
Transitório — nova tentativa
Timeout interno.
GENERIC-504
Transitório — nova tentativa
Timeout de conexão.
Erros de cartão / EMV (1-)
Origem: o kernel EMV e o hardware do terminal. A coluna Tipo de leitura agrupa os códigos pela forma como o cartão foi apresentado; Nova tentativa marca os códigos que o SDK pode repetir e Fallback indica o método de leitura para o qual recorrer. Os códigos marcados como Interno não são exibidos ao portador e normalmente exigem suporte da Getnet.
Constante
Código de resultado
Tipo de leitura
Nova tentativa
Fallback
Descrição
CTLSFALLBACK
1-53
Contactless (NFC)
Sim
Contactless
Não foi possível ler por contactless. Insira o chip ou passe a tarja. Fallback normal.
ERRCTLSS
1-33 (tarja 1-08)
Contactless (NFC)
Sim
—
Erro na leitura por contactless. Tente o chip ou a tarja.
CTLSSPROBLEMS
1-33 (tarja 1-08)
Contactless (NFC)
Sim
Contactless
Problema na leitura por contactless. Tente de novo ou insira o cartão.
CTLSSMULTIPLE
1-21
Contactless (NFC)
—
—
Vários cartões detectados. Apresente um único cartão ao leitor.
CTLSSAPPNAV
1-50
Contactless (NFC)
Sim
—
O cartão não suporta contactless. Insira o chip.
CTLSSAPPNAUT
1-50
Contactless (NFC)
Sim
—
Contactless não autorizado para este cartão. Insira o chip.
CTLSSINVALIDAT
1-34
Contactless (NFC)
Sim
Contactless
Cartão contactless não válido (expirado ou inativo). Fale com o banco.
CTLSSEXTCVM
1-21
Contactless (NFC)
Sim
—
O cartão exige PIN. Insira o chip.
CARDBLOCKED
1-34
Cartão com chip
—
—
O cartão está bloqueado. Fale com o banco.
CARDINV
1-21
Cartão com chip
—
—
O cartão não é válido. Tente outro cartão.
CARDINVALIDAT
1-34
Cartão com chip
Sim
Chip
Cartão expirado ou ainda não ativo. Fale com o banco.
CARDNOTEFFECT
1-21
Cartão com chip
—
—
Cartão ainda não válido. Fale com o banco.
CARDINVDATA
1-21
Cartão com chip
—
—
Não foi possível ler os dados do chip. Tente de novo ou use outro método.
CARDAPPNAV
1-50
Cartão com chip
Sim
—
Cartão não compatível com este terminal. Tente outro cartão.
CARDAPPNAUT
1-21
Cartão com chip
—
—
O cartão não autorizou a transação. Fale com o banco.
CARDPROBLEMS
1-21
Cartão com chip
Sim
Chip
Problema na leitura do chip. Limpe o cartão e tente de novo.
DUMBCARD
1-36
Cartão com chip
Sim
Chip
O cartão não tem chip. Passe a tarja magnética.
ERRFALBACK
1-36
Fallback
Sim
Chip
Não foi possível ler o chip. Passe a tarja magnética.
NOCARD
1-36
Leitura
Sim
Contactless
Nenhum cartão detectado. Aproxime, insira ou passe o cartão.
TIMEOUT
1-02
Leitura
—
—
O tempo de espera acabou. Tente de novo. Tratado como cancelamento.
CANCELED
1-02
Operação
—
—
A transação foi cancelada pelo operador ou pelo cliente.
ERRPIN
1-21
PIN
—
—
Erro na digitação do PIN. Verifique e tente de novo.
NOBALANCE
1-21
Autorização
—
—
Saldo insuficiente. Tente outro cartão.
LIMITEXC
1-21
Autorização
—
—
O valor excede o limite do cartão. Fale com o banco.
LOCKED
1-21
Terminal
—
—
O terminal está travado. Anote o número de série e fale com a Getnet.
TABLE_ERROR
1-21
Interno
—
—
Erro nas tabelas de configuração EMV (AID/terminal) carregadas no kernel.
NO_MATCH
1-21
Interno
Sim
—
Nenhum AID do cartão corresponde aos AIDs configurados no terminal.
INVPARM
1-21
Interno
—
—
Parâmetro inválido enviado ao kernel EMV (erro de programação).
EXECERR
1-21
Interno
—
—
Erro interno de execução no kernel EMV.
TABERR
1-21
Interno
—
—
Erro ao acessar uma tabela interna do EMV.
UNKNOWNSTAT
1-21
Interno
—
—
Estado desconhecido retornado pelo kernel.
RSPERR
1-21
Interno
—
—
Erro na resposta recebida do host ou do autorizador.
COMMTOUT
1-21
Interno
—
—
Timeout de comunicação com o host. Consulte a transação antes de tentar cobrar de novo.
INTERR
1-21
Interno
Sim
—
Erro interno do kernel. Emitido em todo onPanic e no onError(INTERR) do kernel.
MCDATAERR
1-33 (tarja 1-08)
Interno
Sim
—
Erro nos dados lidos da tarja magnética.
PINBUSY
1-21
Interno
—
—
O módulo de PIN está ocupado processando outra requisição.
ERRCARD
1-36
Interno
Sim
Chip
Erro genérico de cartão, sem classificação específica.
CARDERRSTRUCT
1-21
Interno
Sim
Chip
Erro na estrutura do chip (TLV malformado).
Erros de warm-up
O SDK informa estes erros antes de uma venda, por meio de setOnWarmUpStatus.
Código
Constante
Categoria
O que significa
Ação
-1
ERROR_NO_CONNECTION
Transitório — nova tentativa
Sem conexão de rede.
Verifique o Wi-Fi ou os dados móveis e tente de novo na tela de warm-up.
-2
ERROR_TIMEOUT
Transitório — nova tentativa
Timeout de rede durante o warm-up.
Verifique a conexão e tente de novo. Se persistir em vários terminais, escale o caso.
-3
ERROR_SSL
Plataforma / sistema
Falha no handshake SSL/TLS.
Confira a data e a hora do dispositivo; se estiverem corretas, fale com a Getnet.
-4
ERROR_CONNECT
Transitório — nova tentativa
Não foi possível conectar ao host.
Verifique a conexão e o ambiente; tente de novo.
-5
ERROR_SOCKET
Transitório — nova tentativa
Erro de socket durante a transferência.
Tente de novo; se persistir, escale o caso (conexão instável).
400
HTTP_BAD_REQUEST
Integração / requisição
Requisição de warm-up ou de configuração rejeitada como malformada.
Fale com a Getnet — credenciais ou configuração do terminalCode.
401
HTTP_UNAUTHORIZED
Autenticação
client_id / client_secret inválidos (falha no OAuth2).
Fale com a Getnet — credenciais ou ambiente incorretos.
404
HTTP_NOT_FOUND
Referência não encontrada
Terminal ou recurso de configuração não encontrado.
Anote o código do terminal e fale com a Getnet — o terminal pode não estar cadastrado.
422
HTTP_UNPROCESSABLE
Integração / requisição
Requisição de configuração rejeitada semanticamente.
Fale com a Getnet — valores de configuração do sub-merchant ou do terminal.
Ambientes
Ambiente
Build
URL base
Pré-produção / Desenvolvimento
debug
https://api.pre.globalgetnet.com/
Homologação (HML)
hml
https://api.sbx.globalgetnet.com/
Produção
release
https://api.globalgetnet.com/
Mapeamento dos meios de pagamento
Como cada meio de pagamento é mapeado da configuração no SDK para o valor enviado ao SEP e o tipo de aplicação.
Meio
Configuração no SDK
Valor no SEP
Tipo de aplicação
Crédito
BrSaleSetup.Credit / IBrSaleMethod.CreditCard
DIRECT_CREDIT
01
Débito
BrSaleSetup.Debit / IBrSaleMethod.DebitCard
DIRECT_DEBIT
02
Voucher
BrSaleSetup.Voucher / IBrSaleMethod.Voucher
DIRECT_VOUCHER
12
Pix
BrSaleSetup.Pix / IBrSaleMethod.Pix
Fluxo de QR Code (não o corpo de cartão)
30
Serviços que o SDK chama
Você não chama esses serviços diretamente — o SDK chama. Eles estão listados para mostrar de onde vêm os erros de host (33-) e de warm-up.
Método
Caminho
Finalidade
POST
dpm/payments-gwproxy/v2/payments
Cria um pagamento (venda / etapa única). É a principal transação presencial.