Configurações de Gateway
Veja as dúvidas frequentes sobre gateways de pagamento e configurações: como ativar o Cartpanda Pay, conectar um gateway externo e resolver os erros mais comuns.
Quais gateways a Cartpanda tem integração?
A Cartpanda tem o Cartpanda Pay, gateway próprio, e também integra com gateways externos:
Para ver a lista completa e como gerenciar cada um, acesse Gerencie seus provedores de pagamento.
Preciso de um gateway para vender na Cartpanda?
- Sim. A Cartpanda é a plataforma e o checkout, e quem processa o pagamento é o gateway. O que muda é qual gateway você pode usar, conforme o seu perfil.
Se você é produtor:
- As vendas só são processadas com um gateway.
- Você pode usar o Cartpanda Pay ou um dos gateways externos integrados.
- Vendas internacionais só funcionam pelo Cartpanda Pay.
Se você é afiliado ou coprodutor:
- Você precisa ter o cadastro no Cartpanda Pay. sendo o único gateway que funciona com o sistema de afiliados da Cartpanda.
- É por ele que você recebe e e realiza o saque as suas comissões.
- Veja como se cadastrar em Cadastro no Cartpanda Pay.
Devo usar o CartPanda Pay ou um gateway externo?
Depende de como você quer vender:
- Mercado global (outras moedas): exige o Cartpanda Pay.
- Atuar como afiliado, produtor com afiliados ou coprodutor: exige o CartPanda Pay.
- Mercado nacional sem afiliados: você pode escolher o Cartpanda Pay ou um gateway externo.
Onde configuro um gateway externo?
- Em Admin > Pagamentos > Gerenciar provedores terceiros. É lá que você insere as credenciais e ajusta as configurações de cada gateway. O passo a passo de cada um está no artigodo gateway correspondente, confira aqui: artigos de integrações com gateways
Posso usar um gateway para cada método de pagamento?
- Se você vende no mercado nacional, sem afiliados, Sim. você pode ativar um gateway para cartão e outro para Pix ou boleto. Por exemplo.
Configurei meu gateway, mas não aparece métodos de pagamento no checkout. O que fazer?
Causas mais comuns:
- O método de pagamento não foi ativado. Após finalizar a configuração de um gateway, é preciso ir em Admin > Pagamentos>adicionar método de pagamento, abrir o método (cartão, Pix ou boleto) e selecionar o gateway.
- Credenciais incorretas ou incompletas. Confira se as chaves foram copiadas do painel do gateway sem espaços e se são as do ambiente certo, verifique também se o endereço de e-mail preenchido é o e-mail de login da plataforma do gateway correspondente.
- Ambiente em modo teste. na configuração do gateway em admin>pagamentos>provedores terceiros, se estiver como Sandbox, pedidos feitos nesse modo só existem na Cartpanda e não geram cobrança real. Para vendas reais, use Produção.
- Limitação do gateway. Nem todo gateway aceita todos os métodos. Confira no artigo do seu provedor.
Para testar o funcionamento do seu gateway, faça um pedido de teste. Se não resolver, fale com o suporte e envie: o gateway usado, um print da tela de Pagamentos e a URL do checkout, e o erro que está ocorrendo.
Uso um gateway externo. Onde consulto meu saldo e como faço reembolsos?
- Se você utiliza um gateway de pagamento externo, deve consultar diretamente no painel desse gateway provedor as informações financeiras relacionadas aos pagamentos processados por ele, como saldo, recebimentos, repasses, taxas e extratos.
A Cartpanda registra os pedidos realizados pelo checkout e integra-se ao gateway escolhido para processar os pagamentos. No entanto, a consulta dos valores recebidos e das movimentações financeiras deve ser feita na plataforma do provedor.
Consulte também o artigo de configuração do seu gateway na Central de Ajuda da Cartpanda.
Onde configuro um gateway externo?
Para configurar um gateway externo, acesse o painel da Cartpanda e siga o caminho:
- Acesse Admin > Pagamentos > Provedores de terceiros.
- Selecione o gateway que deseja configurar e informe as credenciais solicitadas.
- Salve as configurações e ative o método de pagamento correspondente.
Importante: se sua conta estiver configurada para operar no Mercado Global, a opção de configurar gateways externos pode não estar disponível, pois as vendas internacionais são processadas exclusivamente pelo Cartpanda Pay.
Uma venda aparece na Cartpanda, mas não encontro o repasse no gateway, por que?
Se uma venda aparece na Cartpanda, mas você não encontra o recebimento no painel do gateway utilizado, siga estas orientações:
- Acesse Pedidos > Todos os pedidos e abra o pedido em questão.
- Consulte a linha do tempo do pedido e verifique se há um registro de aprovação do gateway.
- Se houver a confirmação, mas o recebimento não aparecer no painel do provedor, entre em contato com o suporte do próprio gateway para verificar a transação do pedido.
Caso o gateway confirme que não recebeu ou não processou o pagamento, entre em contato com o suporte da Cartpanda, informando o número do pedido e o retorno recebido do provedor, para que o caso seja analisado.
A existência de um pedido na Cartpanda, por si só, não garante que o pagamento tenha sido aprovado.
Posso realizar o reembolso diretamente pela Cartpanda?
Se o pagamento foi processado pelo Cartpanda Pay, você pode solicitar o reembolso diretamente pelo painel da Cartpanda.
Para isso:
- Acesse os detalhes do pedido.
- No canto superior direito clique em Reembolsar.
- Selecione os itens e valores que deseja reembolsar e confirme a operação.
Consulte os requisitos, os prazos e as regras aplicáveis no artigo: Entenda o Processo de Reembolso de Pagamentos com Cartpanda Pay.
Se você utiliza um gateway externo, o procedimento depende da integração e dos recursos disponíveis para o provedor. Consulte as instruções específicas do gateway utilizado para verificar onde o reembolso deve ser realizado.
Como faço para desconectar ou substituir um gateway?
O procedimento depende de qual gateway você deseja remover.
Para remover um gateway externo:
- Acesse Admin > Pagamentos.
- Entre em Provedores de terceiros.
- Abra as configurações do gateway que deseja desconectar.
- Remova as credenciais configuradas e salve as alterações, conforme as opções disponíveis na integração.
Para remover o Cartpanda Pay de um método de pagamento:
- Acesse Admin > Pagamentos.
- Abra a configuração do método de pagamento que deseja alterar.
- Remova o Cartpanda Pay desse método e selecione outro provedor, caso aplicável.
Antes de desconectar um gateway, confira se ele ainda está sendo utilizado para processar pagamentos na sua loja. Se pretende substituí-lo, configure o novo provedor e confirme que o método de pagamento está funcionando corretamente antes de interromper a integração anterior.
Estou tendo recusas de pagamento no checkout, mas meu gateway está conectado, Por quê?
- Uma recusa de pagamento pode ocorrer por diferentes motivos, como dados de pagamento incorretos, uma decisão do banco emissor do cartão, uma análise antifraude ou alguma pendência na conta do gateway.
Se você utiliza um gateway externo, recomendamos verificar primeiro se a integração está configurada corretamente, se as credenciais utilizadas são válidas e se existe alguma pendência na sua conta junto ao provedor.
Você também pode consultar o registro do erro na Cartpanda:
- Acesse Pedidos > Checkouts abandonados.
- Clique no checkout relacionado à tentativa de compra.
- Localize a seção Logs de Checkout e consulte a mensagem apresentada.
O registro pode ajudar a identificar a origem da recusa. Se o erro indicar “antifraude ou AF”, a transação pode ter sido bloqueada por uma análise de segurança, do sistema antifraude do gateway atual configurado.
Se indicar “CC”, pode estar relacionado à recusa do cartão/banco emissor do cliente final, ou dados do cartão preenchidos incorretamente.
Se a recusa estiver relacionada ao cartão, e o cliente relatar erro no pagamento, oriente o cliente a conferir os dados preenchidos no checkout e a verificar com o banco emissor se existe alguma restrição para a transação. Ele também pode tentar novamente mais tarde.
Ficou com alguma dúvida? Chame nosso time no chat da plataforma ou mande um e-mail para suporte@cartpanda.com
Atualizado em: 27/10/2026
Obrigado!