# Referência de códigos de erro

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](https://docs.globalgetnet.com/pt/products/in-store-payments/getnet-toolbox?doc=sdk-wl-troubleshooting).

## 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. |

<Callout type="note">

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.

</Callout>

## 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. |
| POST | `dpm/payments-gwproxy/v2/payments/cancel` | Cancela ou estorna um pagamento. |
| POST | `dpm/payments-gwproxy/v2/payments/qrcode/pix` | Gera um QR Code Pix. |
| GET | `dpm/hub-payment-info/v1/payments/info/{payment_id}` | Consulta o status de uma transação ou de um Pix. Use após um timeout. |
| POST | `authentication/oauth2/access_token` | Token OAuth2 (`client_credentials`), injetado como Bearer em toda chamada ao SEP. |
| POST | `tms/terminal-management-adp/v1/configuration` | Busca a configuração do terminal durante o warm-up. |
| PATCH | `tms/terminal-management-adp/v1/configuration/confirmation` | Confirma a configuração do terminal. |

## Recursos relacionados

* [Solução de problemas](https://docs.globalgetnet.com/pt/products/in-store-payments/getnet-toolbox?doc=sdk-wl-troubleshooting) — diagnostique uma falha e decida o que fazer.
* [Referência do resultado da transação](/pt/getnet-toolbox/sdk-white-label/reference-sdk/transaction-result) — os campos e payloads de resultado retornados ao seu aplicativo.
* [Referência de inicialização](/pt/getnet-toolbox/sdk-white-label/reference-sdk/initialization) — os estados do warm-up e como se recuperar de um `Failure`.