Gateways e taxas
As mensagens da conexão de gateways, dos erros de configuração, da ordem de cobrança, do saque automático e das faturas de taxas.
Esta página reúne as mensagens das telas de Ferramentas > Gateways e de Minhas faturas. Elas tratam da conexão das credenciais, dos erros detectados nos gateways já conectados, da ordem de cobrança, do saque automático e das taxas da modalidade Billing.
Conexão de gateways
| Mensagem | Onde aparece | O que significa | O que fazer |
|---|---|---|---|
| Falha na validação das credenciais | Formulário do gateway, ao salvar. | O gateway recusou as chaves informadas. | Copie as chaves de novo no painel do gateway, do ambiente de produção, e salve. |
| Erro de conexão | Teste de conexão do gateway. | O ggCheckout não conseguiu falar com o gateway usando as credenciais salvas. | Confira as credenciais e teste de novo. |
| Nome do gateway seguido de indisponível | Card ou formulário do gateway. | O gateway não está disponível para novas conexões no ggCheckout. | Conecte outro gateway da lista. |
| Valor deve estar entre seguido do intervalo em minutos | Prazo de expiração do Pix, no formulário do gateway. | O prazo informado está fora do intervalo aceito. | Informe um prazo dentro do intervalo. |
| Sua conexão com o Mercado Pago expirou. Reconecte para voltar a receber pagamentos. | Card do Mercado Pago. | A autorização dada ao ggCheckout venceu. | Clique para conectar de novo e autorize no Mercado Pago. |
| Token do Mercado Pago inválido ou expirado. Reconecte o gateway. | Ações em pagamentos do Mercado Pago. | A autorização do Mercado Pago não vale mais. | Conecte o Mercado Pago de novo. |
| A autorização expirou. Inicie a conexão novamente. / Não foi possível validar a autorização. Inicie a conexão novamente. | Volta da tela de autorização do Mercado Pago. | A autorização demorou ou foi interrompida. | Inicie a conexão de novo pelo painel. |
| Autorização negada. | Volta da tela de autorização do Mercado Pago. | A permissão foi recusada na tela do Mercado Pago. | Inicie a conexão de novo e aceite a permissão. |
| O PayPal recusou o Client ID e o Client Secret. | Formulário do PayPal. | As credenciais não são do app REST em produção. Credenciais de Sandbox não são aceitas. | Copie as credenciais Live do app REST certo. |
| Credencial PayPal salva, mas não conseguimos configurar o webhook no seu app PayPal. | Formulário do PayPal. | As vendas funcionam, mas a confirmação automática dos pagamentos fica mais lenta. | Salve de novo em alguns minutos. |
| A Adyen recusou a API Key. | Formulário da Adyen. | A chave não é da credencial certa ou é de outro ambiente. | Use a API Key do mesmo ambiente da Client Key (Produção ou Teste). |
| A API Key não tem acesso a essa Merchant Account. / A API Key não pode criar pagamentos nessa Merchant Account. | Formulário da Adyen. | Faltam papéis na credencial da Adyen. | Confira o nome da Merchant Account e os papéis indicados na mensagem. |
| A credencial não tem permissão para configurar webhooks. | Formulário da Adyen. | Sem esse papel, o ggCheckout não cria o webhook que confirma os pagamentos. | Na Customer Area da Adyen, habilite o papel indicado na mensagem e salve de novo. |
| Certificado deve ser um arquivo .p12 ou .pem | Formulário da EfiBank. | O arquivo enviado não é um certificado aceito. | Envie o certificado no formato .p12 ou .pem. |
| Certificado expirado / Certificado inválido | Formulário da EfiBank. | O certificado venceu ou não corresponde à conta. | Gere um novo certificado no painel da EfiBank e envie. |
Erros de configuração
O ggCheckout acompanha os gateways conectados e avisa quando encontra um erro que pode impedir vendas. O painel mostra a faixa 1 erro de configuração detectado ou a quantidade de erros, com o botão Ver erros, e um contador de erros de gateway no menu lateral. A tela Erros de configuração lista cada erro, que pode ser marcado como resolvido ou dispensado depois da correção.
| Erro | O que significa | O que fazer |
|---|---|---|
| Chave PIX inválida | A chave Pix cadastrada no gateway não é aceita. | Corrija a chave Pix no gateway. |
| Credenciais inválidas | O gateway recusou as credenciais salvas. | Copie as credenciais de novo e salve no ggCheckout. |
| Certificado inválido | O certificado do gateway não é aceito ou venceu. | Envie um certificado válido. |
| Falha no webhook | O gateway não está avisando o ggCheckout sobre os pagamentos. | Confira a configuração de webhook descrita na página do gateway. |
| Limite operacional excedido | O gateway recusou cobranças por limite da conta. | Consulte o limite com o gateway. |
| Credencial removida ou expirada | A credencial deixou de existir ou venceu. | Conecte o gateway de novo. |
| Erro de configuração | Outro erro de configuração informado pelo gateway. | Revise as configurações do gateway. |
A mensagem Não foi possível ler os erros das suas gateways agora. Isso não quer dizer que está tudo certo. indica que a lista não carregou. Recarregue a tela antes de considerar que não há erros.
Ordem de cobrança
| Mensagem | Onde aparece | O que significa | O que fazer |
|---|---|---|---|
| Reconecte sua gateway para colocá-la na ordem de cobrança. | Ordem de cobrança. | Só gateway conectado entra na ordem. Um gateway com a conexão vencida fica de fora. | Conecte o gateway de novo. |
| Você já tem seguido do número ordens de cobrança. Exclua uma para criar outra. | Ordem de cobrança. | A conta chegou ao limite de ordens. | Exclua uma ordem que não esteja em uso. |
| Ajuste o que está em vermelho para salvar. | Ordem de cobrança, ao salvar. | Algum item da ordem está incompleto. | Corrija os itens marcados em vermelho. |
| Ranking indisponível agora. Tente de novo em instantes. | Ordem de cobrança, modo automático. | O ranking de estabilidade não carregou. A reordenação acontece na passagem seguinte. | Tente de novo em instantes. |
| Ordem de cobrança excluída: o que a usava agora usa seguido do nome de outra ordem | Ordem de cobrança, depois de excluir. | Os checkouts passaram para a ordem indicada. A integração da API que envia o ID da ordem excluída passa a receber erro. | Troque o ID na integração da API. |
| Não conseguimos atualizar suas ordens de cobrança. Você está vendo a última lista carregada. | Ordem de cobrança. | A lista na tela pode estar desatualizada. | Recarregue a página. |
| Esta ordem nova já foi salva em outra aba. | Ordem de cobrança. | A mesma ordem foi salva em outra aba do navegador. | Feche a aba repetida e recarregue a página. |
Quando todos os gateways da ordem falham ao gerar o Pix, o comprador vê o Pix indisponível no checkout. O funcionamento da ordem está em Ordem de cobrança.
Saque automático
| Mensagem | Onde aparece | O que significa | O que fazer |
|---|---|---|---|
| ligado, mas parado | Linha do gateway em Saques. | O saque está ligado, mas o gateway recusou a transferência. O motivo aparece na linha, com o código do erro. | Corrija o motivo indicado no gateway. |
| Chave confirmada. O saque já está valendo. | Saques. | A chave Pix de destino foi confirmada. | Nenhuma ação. |
| Não foi possível ler seus saques agora. Isso não quer dizer que não houve saque. | Saques. | A lista não carregou. | Recarregue a página. |
Minhas faturas
As mensagens abaixo aparecem para quem usa gateways na modalidade Billing, em que as taxas do ggCheckout se acumulam em uma fatura.
| Mensagem | Onde aparece | O que significa | O que fazer |
|---|---|---|---|
| Atenção: Limite de crédito próximo! | Faixa de aviso no painel. | As taxas acumuladas estão perto do limite de crédito. Acima dele, a fatura fecha antes da data. | Acompanhe a fatura em Minhas faturas. |
| Pagamento pendente! | Faixa de aviso no painel. | Existe uma fatura sem pagamento. Se ela não for paga, os checkouts são despublicados. | Pague a fatura em Minhas faturas. |
| Conta Bloqueada | Faixa de aviso no painel. | Os checkouts que usam gateways de billing foram despublicados por limite de crédito excedido. | Pague o valor indicado. O desbloqueio é automático depois da confirmação. |
| O PIX desta fatura expirou. Gere um novo para pagar. | Pagamento da fatura. | O Pix gerado venceu. | Gere um novo Pix. |
| Muitas tentativas de gerar o PIX. Tente de novo em seguido de minutos | Pagamento da fatura. | Muitos Pix foram gerados em pouco tempo. | Aguarde o tempo indicado. |
| Valor mínimo é R$ 3,25 | Adicionar crédito. | O valor informado está abaixo do mínimo. | Informe R$ 3,25 ou mais. |
| A lista chegou ao limite de seguido do número faturas e pode estar incompleta. Restrinja o período. | Extrato de taxas. | A lista mostra só parte das faturas do período. | Escolha um período menor. |
| As taxas consomem mais que o ticket | Simulador de Taxas. | No valor simulado, as taxas passam do preço do produto. | Revise o valor simulado. |
Páginas relacionadas
- Conectando um gateway: a conexão das credenciais de cada gateway.
- Modalidade Billing: a fatura de taxas e o limite de crédito.
- Saques: o saque automático para uma chave Pix.