Suporte: seg. a sex., das 9h às 18h

Como configurar os serviços de pagamento

Atualizado em 22/10/2026

Ativar um meio de pagamento passa por três etapas: guardar as credenciais do gateway, ativar o serviço que aparece no checkout e definir as condições de parcelamento. Tudo começa em Pagamentos > Serviços.

Etapa 1: as credenciais do gateway

O botão Ajustes, no topo da tela de Serviços, abre a Visão geral dos ajustes de pagamento. Ela lista cada empresa em três grupos (Gateways, Manual e Obsoletos), com um selo que resume a situação e o botão Configurar, que abre a tela daquela empresa. Os obsoletos são as versões antigas, mantidas para quem já as usa: em uma configuração nova, prefira a versão atual.

Na tela da empresa, você preenche os dados que ela fornece no painel dela, como o Client ID e o Client Secret. Algumas empresas, como Stone, PagSeguro v4 e PayPal v2, não pedem chave: o botão Conectar leva você até elas para autorizar a loja, e você volta com a conta conectada.

  • Campos de chave — por segurança, a chave gravada nunca volta para a tela. O campo aparece vazio, com o aviso "Chave gravada" abaixo do nome. Deixar em branco ao gravar mantém a chave atual.
  • Credencial em uso — muitas empresas guardam duas contas, a Credencial 1 e a Credencial 2. Você escolhe qual processa os novos pedidos, e os pedidos antigos seguem com a conta em que foram pagos.
  • Usar o ambiente de testes — liga a conta de testes da empresa no lugar da conta real. Na maioria das telas, o interruptor fica no título da seção de mesmo nome, que guarda as credenciais de testes (os campos terminam em "de testes"). Os pagamentos de testes não valem.

Atenção: depois de validar a integração em testes, desligue o interruptor Usar o ambiente de testes. Com ele ligado, os pedidos passam pela conta de testes, e nenhum pagamento é cobrado de verdade. O selo Ativo em testes, na Visão geral, avisa quando isso está acontecendo.

Etapa 2: o serviço que aparece no checkout

A tela da empresa não tem botão de ativar: a ativação fica na listagem de Pagamentos > Serviços. Em Adicionar, você escolhe o serviço no campo Serviço (como "Crédito PayPal" ou "Pix Itaú"; a lista mostra só os que a loja ainda não cadastrou) e preenche:

  • Status — Ativo coloca o serviço no checkout.
  • Visível somente para administradores — ligado, o checkout esconde o serviço dos clientes, para a equipe testar antes de liberar. A listagem marca esses serviços com "Visível apenas para administradores".
  • Nome no checkout — o que o cliente vê, como "Cartão de Crédito", "Pix" ou "PayPal". Se a loja vende em inglês ou espanhol, aparecem também os campos do nome nesses idiomas.
  • Descrição no checkout — opcional, uma frase curta como "em até 6x sem juros", em texto puro, sem formatação.

Atenção: o serviço não muda depois de cadastrado. Para trocar, cadastre outro. O Crédito Rede (versão antiga) foi descontinuado e não pode ser ativado: use o Crédito Rede v2.

A loja pode ter vários serviços ativos ao mesmo tempo: Pix, boleto e cartão por diferentes gateways, por exemplo.

Com o serviço ativo, a tela da empresa passa a conferir a credencial: ela não grava se faltar um dado obrigatório da conta em uso, e mostra o aviso no campo que falta. Isso evita que o checkout ofereça um pagamento que não consegue cobrar. Por isso, a ordem mais tranquila é preencher a tela da empresa primeiro e ativar o serviço depois.

Etapa 3: as condições de parcelamento

Por fim, você define como o cliente pode parcelar naquele meio de pagamento. Isso é feito na tela Pagamentos > Parcelas / Condições, onde você marca as parcelas oferecidas e define, para cada uma, o tipo (com ou sem juros, ou com desconto), a taxa ou o desconto e o valor mínimo. Pela listagem de Serviços, o menu de ações do serviço tem a opção Parcelas / Condições, que abre a grade dele direto.

Essa parte tem o seu próprio artigo, que detalha as condições, mas o ponto a guardar é que sem ela o meio de pagamento não fica completo. A listagem de Serviços avisa, em vermelho, quando um serviço de cartão de crédito ativo ainda não tem nenhuma condição de parcelamento.

Concluídas as três etapas, o novo meio de pagamento já aparece no checkout, pronto para uso.

Os selos da Visão geral

  • Ativo — o serviço está ligado e a credencial está completa.
  • Ativo em testes — ligado, mas usando a conta de testes.
  • Sem credencial ou Não conectado (em amarelo) — o serviço está ligado, mas falta a credencial ou a conexão. Resolva logo, porque o cliente já vê esse pagamento no checkout.
  • Desligado — a credencial está guardada, mas nenhum serviço da empresa está ativo.
  • Não configurado — nem credencial, nem serviço ativo.

O selo confere só o que está guardado na loja. Para ter certeza de que a empresa aceitou as credenciais, faça um pedido de teste.

Por segurança, as telas de ajuste de pagamento abrem só para administradores com acesso total, e cada clique em Gravar nelas envia um e-mail de aviso para a loja, explicado no artigo "Aviso de ajuste de pagamento alterado ou atualizado".

A listagem de Serviços

Cada linha da listagem é um serviço, na ordem em que aparece no checkout. As colunas são Posição, Status, Serviço, Exibição no Checkout (o nome, o aviso de visibilidade e a descrição), Cadastro e Atualizado. Clicando no nome do serviço, o menu de ações traz:

  • Editar — muda o status, a visibilidade, o nome e a descrição.
  • Ajustes — abre a tela de credenciais daquele gateway, em uma aba nova.
  • Parcelas / Condições — abre a grade de parcelamento do serviço.
  • Ver pedidos — lista os pedidos feitos por ele.
  • Apagar — remove o serviço.

Para mudar a ordem do checkout, arraste a linha pela alça da coluna Posição (no computador) e clique em Gravar posições, que aparece depois do arraste. O botão Organizar > Colocar em ordem alfabética substitui a ordem manual pela alfabética.