Central de Ajuda Ir para o site da Olist Meus chamados

Como funciona o Gateway de pagamentos da Olist

Bruna
Por Bruna Miranda

Através do Gateway de Pagamentos da Olist, você obtém o melhor processamento das suas vendas com mais segurança, agilidade e autonomia. A solução conecta pagamentos, conta digital e crédito em um só lugar, permitindo aceitar Pix, boleto e cartão de crédito com taxas competitivas, antecipação de recebíveis, conciliação automática, proteção antifraude e fluxos financeiros em tempo real.

Pré-requisitos

Para utilizar essa solução, é necessário possuir ativos:

  • O ERP
  • O E-commerce da Olist
  • A Conta Digital Olist

Dica: caso você ainda não possua a conta digital, acesse o artigo explicativo sobre como abrir sua Conta Digital pelo ERP.

 

Por que realizar estas configurações?

  • Automação financeira: garante que os pedidos sejam importados com as formas de recebimento corretas e lancem contas a receber automaticamente.
  • Prevenção de erros: cadastra previamente as regras de negócio no sistema para evitar falhas de comunicação e retrabalhos.
  • Sincronização em tempo real: conecta estoque, preços, status de pedidos e transações financeiras diretamente entre o ERP e o e-commerce.

Configurar Parcelamento e Juros

Para ajustar o parcelamento e as regras de juros do cartão de crédito no painel do e-commerce:

  1. Na plataforma do E-commerce da Olist, acesse Configurações > Pagamentos.
  2. Clique em Cartão de crédito.
  3. Na seção Gateways, clique em Gateway de Pagamentos.
  4. Clique no ícone de três pontos e selecione Editar os dados.
  5. Preencha os campos conforme as regras do seu negócio:
  • Número de parcelas: defina o limite de parcelamento (até o máximo de 12 vezes).
  • Juros: defina se as parcelas serão com ou sem juros.
  • Taxa de juros para parcelamento: informe o percentual de juros aplicável, se houver.
  1. Clique em Enviar.
 
 

Habilitar e configurar as formas de recebimento no ERP

Antes de conectar a integração, habilite os métodos de recebimento no ERP para garantir o vínculo correto dos pedidos:

  1. Acesse menu > configurações > aba finanças > Formas de Recebimento.
  2. Visualize as opções disponíveis e clique sobre cada uma para ajustar:

Cartão de Crédito, Débito e Boleto

  1. No campo Situação, selecione Habilitada.
  2. No campo Validar limite de crédito: ajuste conforme a preferência da sua empresa.
  3. Verifique se Conta Digital Olist está selecionado.
  4. Clique em Salvar.
 
 

PIX

  1. No campo Situação, selecione Habilitada.
  2. No campo Validar limite de crédito: ajuste conforme a preferência.
  3. No campo Destino de Valores, selecione Contas a Receber.
  4. Verifique se Conta Digital Olist está selecionado.
  5. Clique em Salvar.
 
 

Link de Pagamento

  1. No campo Situação, selecione Habilitada.
  2. No campo Validar limite de crédito: ajuste conforme a preferência.
  3. Clique em Salvar.
 
 

Configurar sincronização automática dos recebimentos

Dentro de qualquer uma das Formas de Recebimento habilitadas (Cartão de Crédito, PIX, Boleto ou Cartão de Débito):

  1. Clique em editar no gateway da Conta Digital selecionado.
  2. Na seção Sincronização automática, habilite as opções:
  • Importar Recebimentos
  • Importar Pagamentos
  • Importar Transferências
  1. Em Dados Adicionais, ajuste de acordo com as necessidades da sua operação.
  2. Clique em Salvar.
 
 

Conectar o canal de vendas ao ERP

  1. No menu lateral esquerdo do ERP, acesse início > Integrações.
  2. Pesquise por Ecommerce Olist.
  3. Clique em Instalar.
  4. Insira as suas credenciais habituais (e-mail/usuário e senha do painel de administração da plataforma) para autorizar a conexão segura.
 
 

Mapear situações de pedidos e formas de recebimento no ERP

Situação de Pedidos

  1. Na configuração da integração no ERP, acesse Mapeamentos.
  2. Clique no botão Adicionar situações padrão para preencher automaticamente os status do pedido.
  3. Mantenha a opção Permitir retroceder situações dos pedidos na sincronização de situações na posição DESLIGADO para preservar a sequência lógica das etapas do pedido.
 
 

Formas de Recebimento

  1. Acesse menu > ERP Olist > Início > Integrações.
  2. Clique na integração Ecommerce da Olist.
  3. Clique em Mapeamentos > Formas de Recebimento.
  4. Habilite a opção Importar forma de recebimento nos pedidos.
 
 
 
 

Configurar Webhooks no E-commerce e Lançamentos no ERP

Obter a chave de notificação no ERP

  1. Na configuração da integração no ERP, clique na aba Conexão.
  2. Na seção Urls de notificação no ERP, copie o código no campo Importação de pedidos.
 
 

Cadastrar os Webhooks no E-commerce

  1. No painel do e-commerce, acesse Configurações > Integrações > Webhooks.
  2. Clique no botão + adicionar webhook.
  3. Selecione e cadastre cada uma das opções abaixo (uma por vez), colando a URL do ERP:
  • order-received: importa pedidos ao serem salvos.
  • order-confirmed: importa pedidos ao serem confirmados.
  • order-canceled: importa pedidos ao serem cancelados ou estornados.
  • order-sent: importa pedidos enviados.
 
 

Configurar o lançamento automático de contas a receber no ERP

  1. Acesse menu > configurações > configurações ERP.
  2. Vá até a Aba finanças > Configurações Gerais.
  3. No campo Lançamento de contas a receber, selecione a opção Automático ao salvar o pedido.
  4. Clique em Salvar.
 
 
 
 

Segurança e proteção antifraude (ClearSale)

O Gateway de Pagamentos da Olist possui integração nativa com a ClearSale no fluxo de carteira de cartões (Card Wallet), links de pagamento e checkout.

  • O sistema mapeia o comportamento da sessão de forma automática para bloquear transações falsas e proteger suas vendas contra fraudes.
  • O processo ocorre em segundo plano, sem necessidade de contratação de ferramentas externas adicionais.
 
 

Como gerenciar e visualizar os pedidos e transações no ERP

Importar pedidos não sincronizados

Caso algum pedido realizado no e-commerce não apareça automaticamente no ERP:

  1. Acesse Menu > Vendas > Pedidos no e-commerce.
  2. Clique no botão Processar fila de pedidos.
  3. Acompanhe a aba lateral e verifique a atualização dos pedidos na tela de Vendas.
 
 

Configurar informações visíveis na tela de Pedido de Venda

  1. Na tela de Pedidos de Venda, acesse Configurar informações visíveis.
  2. Habilite os campos: Cliente, CNPJ/CPF, Status do Pagamento, Total, N pedido, Integrações e Situação.
 
 

Configurar informações visíveis na tela de Transação de Vendas

  1. Na tela de Transações de Vendas, acesse Configurar informações visíveis.
  2. Habilite os campos: Cliente, Histórico, Vencimento, Valor, Valor Líquido, Recebido, Data Emissão, Documento Origem, Antecipada, Meio de Pagamento, Integrações e Situação.
 
 
 
 

 

Sua dúvida foi esclarecida?

Artigos relacionados

ClearSale Total Integração ClearSale Start e ClearSale Total