Como funciona o Gateway de pagamentos da Olist
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
.png)
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 os parâmetros das formas de pagamento no E-commerce da Olist
Para ativar ou alterar as regras das formas de pagamento no painel do e-commerce:
- Na plataforma do E-commerce da Olist, acesse Configurações > Pagamentos.
- Clique na opção desejada: Cartão de crédito, Pix ou Boleto.
- Na seção Gateways, localize o Gateway de Pagamentos, clique no ícone de três pontos e selecione Utilizar esse meio de Pagamento.
Importante: a opção Editar os dados ficará disponível somente após a ativação da forma de pagamento.
O gateway de pagamentos necessita obrigatoriamente de uma Conta Digital Olist ativa para processar as vendas. Ao solicitar a ativação, o sistema valida automaticamente o status da sua conta digital:
- Lojista sem conta criada: caso você ainda não tenha iniciado o cadastro da conta digital, uma tela é exibida. Clique no botão Ativar Conta Digital para abrir o fluxo de cadastramento em uma nova aba.
- Criação da conta pendente: caso o cadastro da conta não tenha sido finalizado, o sistema exibe o aviso Status: Criação da conta pendente. Clique no botão continue o cadastro para prosseguir de onde parou.
- Documentação pendente: caso haja documentos pendentes de envio, o sistema exibe o aviso Status: Documentação pendente. Clique no botão reenviar documentos para anexar os arquivos.
- Abertura em análise: após o envio das informações, o sistema exibe o aviso Status: Sua conta digital está em análise. Os dados são conferidos em até 2 dias úteis e a confirmação é enviada por e-mail. Assim que a análise for concluída, o gateway é ativado automaticamente.
- Conta digital negada: caso não seja possível aprovar a conta digital, o sistema exibe o aviso Status: Conta digital negada. Clique em saiba mais para entender os motivos de reprovação ou clique em Fale com suporte para obter ajuda.
- Credenciamento negado para cartão de crédito: se a conta digital for aprovada, mas a modalidade de cartão de crédito não for liberada, o sistema exibe a mensagem Conta Liberada apenas para Pix e Boleto. Você pode vender por Pix e Boleto normalmente. Para entender o motivo referente ao cartão, clique em saiba mais ou clique em Fale com suporte.
Após a liberação da conta digital e do meio de pagamento, você pode clicar no ícone de três pontos para Editar os dados (como parcelamento e juros) ou Remover esse meio de pagamento.
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:
- Acesse menu > configurações > aba finanças > Formas de Recebimento.
- Visualize as opções disponíveis e clique sobre cada uma para ajustar:
Cartão de Crédito, Débito e Boleto
- No campo Situação, selecione Habilitada.
- No campo Validar limite de crédito: ajuste conforme a preferência da sua empresa.
- Verifique se Conta Digital Olist está selecionado.
- Clique em Salvar.
PIX
- No campo Situação, selecione Habilitada.
- No campo Validar limite de crédito: ajuste conforme a preferência.
- No campo Destino de Valores, selecione Contas a Receber.
- Verifique se Conta Digital Olist está selecionado.
- Clique em Salvar.
Link de Pagamento
- No campo Situação, selecione Habilitada.
- No campo Validar limite de crédito: ajuste conforme a preferência.
- 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):
- Clique em editar no gateway da Conta Digital selecionado.
- Na seção Sincronização automática, habilite as opções:
- Importar Recebimentos
- Importar Pagamentos
- Importar Transferências
- Em Dados Adicionais, ajuste de acordo com as necessidades da sua operação.
- Clique em Salvar.
Conectar o canal de vendas ao ERP
- No menu lateral esquerdo do ERP, acesse início > Integrações.
- Pesquise por Ecommerce Olist.
- Clique em Instalar.
- 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
- Na configuração da integração no ERP, acesse Mapeamentos.
- Clique no botão Adicionar situações padrão para preencher automaticamente os status do pedido.
- 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
- Acesse menu > ERP Olist > Início > Integrações.
- Clique na integração Ecommerce da Olist.
- Clique em Mapeamentos > Formas de Recebimento.
- 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
- Na configuração da integração no ERP, clique na aba Conexão.
- 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
- No painel do e-commerce, acesse Configurações > Integrações > Webhooks.
- Clique no botão + adicionar webhook.
- 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
- Acesse menu > configurações > configurações ERP.
- Vá até a Aba finanças > Configurações Gerais.
- No campo Lançamento de contas a receber, selecione a opção Automático ao salvar o pedido.
- 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:
- Acesse Menu > Vendas > Pedidos no e-commerce.
- Clique no botão Processar fila de pedidos.
- 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
- Na tela de Pedidos de Venda, acesse Configurar informações visíveis.
- 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
- Na tela de Transações de Vendas, acesse Configurar informações visíveis.
- 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.
