Pagamentos

Asaas

Asaas — Integração de Pagamentos Receba pagamentos por Pix, boleto bancário e cartão de crédito diretamente na sua loja, com geração automática de cobranças e atualização dos pedidos por meio da integração com o Asaas. Para que serve a integração? A integração conecta sua loja na Nortgraf à plataforma Asaas, permitindo disponibilizar diferentes formas de pagamento aos clientes durante a finalização dos pedidos. Com a integração configurada, você pode: - Receber pagamentos por Pix, boleto bancário e cartão de crédito. - Gerar cobranças automaticamente ao finalizar pedidos. - Configurar valores mínimos, parcelamento e juros. - Consultar informações da conta e do saldo disponível. - Receber notificações de pagamento por meio de webhooks. - Atualizar automaticamente a situação dos pedidos conforme os pagamentos são processados. 1 - Atenção e Segurança Antes de iniciar a configuração, observe algumas informações importantes: - Conta no Asaas: É necessário possuir uma conta no Asaas para receber pagamentos. - Chave de API: A credencial permite acessar informações e realizar operações na sua conta. Nunca compartilhe sua chave publicamente. - Conta habilitada: A disponibilidade do Pix, boleto e cartão depende da habilitação desses serviços pelo Asaas. - Webhooks: São responsáveis por comunicar à Nortgraf os eventos relacionados aos pagamentos, como confirmação, recebimento e estorno. - Ambiente de Produção: Utilize a chave da sua conta de produção para processar pagamentos reais. - Segurança: Se suspeitar que sua chave foi comprometida, revogue-a e gere outra no painel do Asaas. Importante: O Asaas desabilita chaves de API após 3 meses consecutivos de inatividade e as expira permanentemente após 6 meses de inatividade. Caso isso aconteça, poderá ser necessário reativar ou substituir a credencial. 2 - Criando uma conta no Asaas Caso ainda não possua uma conta, você poderá realizar seu cadastro diretamente pelo painel da Nortgraf. Passo 1 - Acessar a integração 1. Entre no painel administrativo da sua loja na Nortgraf. 2. No menu lateral, acesse Configurações > Formas de Pagamento. 3. Localize a opção Asaas. 4. Clique em Configurar. Na página de configuração, localize a seção Criar conta no Asaas. Passo 2 - Realizar o cadastro 1. Clique em Criar conta no Asaas. 2. Você será direcionado à página de cadastro do Asaas. 3. Preencha os dados solicitados. 4. Siga as orientações para verificar e ativar sua conta. 5. Após concluir o cadastro, retorne à Nortgraf para configurar a chave de API. Caso já possua uma conta no Asaas, não é necessário criar outra. Basta utilizar sua conta existente e seguir as próximas etapas. 3 - Gerando sua chave de API no Asaas A chave de API é necessária para permitir a comunicação entre a Nortgraf e sua conta no Asaas. Passo 1 - Acessar as integrações 1. Acesse www.asaas.com e entre na sua conta. 2. No canto superior direito, clique no ícone do seu perfil. 3. No menu apresentado, selecione Integrações. 4. Na página seguinte, clique na aba Chaves de API. ### Passo 2 - Criar uma nova chave Na seção Chaves de API, clique em Gerar chave de API. Na janela exibida, preencha: Campo O que informar Nome da chave Nortgraf Data de expiração Opcional, conforme sua política de segurança Hora de expiração Opcional, quando definida uma data Permitir operações de saque Deixe desmarcado Atenção: Não é necessário permitir operações de saque via API para receber pagamentos pela loja. Recomendamos manter essa permissão desativada. Após preencher as informações, clique em Avançar. ### Passo 3 - Confirmar e copiar a chave O Asaas poderá solicitar uma confirmação de segurança, como o envio de um código para validar a operação. 1. Realize a verificação solicitada. 2. Confirme a geração da chave. 3. Copie a API Key apresentada. 4. Guarde-a temporariamente em local seguro. Essa chave será utilizada na próxima etapa para conectar sua loja. Importante: Não utilize uma chave pertencente a outra conta ou ao ambiente Sandbox. Para receber pagamentos reais, utilize a chave gerada no ambiente de produção. 4 - Conectando o Asaas à Nortgraf Com a chave de API em mãos, retorne ao painel administrativo da sua loja. Passo 1 - Acessar a configuração 1. No menu lateral, acesse Configurações > Formas de Pagamento. 2. Localize o cartão Asaas. 3. Clique em Configurar. ### Passo 2 - Informar a chave de API Na seção Credenciais de Integração, localize o campo Chave da API. 1. Cole a chave gerada anteriormente no Asaas. 2. Confira se não existem espaços adicionais no início ou no final. 3. Salve as configurações conforme as opções disponíveis na página. ### Passo 3 - Configurar as regras de cobrança Na seção Regras de Cobrança, configure as condições financeiras utilizadas pela sua loja. Configuração Finalidade Pedido Mínimo (R$) Valor mínimo permitido para o pedido Valor Mín. por Parcela (R$) Valor mínimo de cada parcela Parcelas s/ Juros Quantidade de parcelas oferecidas sem juros Máximo de Parcelas Limite de parcelamento disponibilizado Juros ao Mês (%) Taxa utilizada nas condições de parcelamento com juros Defina esses valores conforme a política comercial da sua loja, considerando também as condições aplicáveis à sua conta no Asaas. Passo 4 - Selecionar os métodos de pagamento Na seção Métodos Ativos, habilite as formas de pagamento que deseja oferecer aos seus clientes: - Cartão de Crédito: Permite pagamentos à vista ou parcelados. - Boleto Bancário: Permite gerar boletos para pagamento. - Pix (Instantâneo): Permite receber pagamentos por Pix. Você pode habilitar uma, duas ou todas as formas de pagamento disponíveis. Passo 5 - Ativar o módulo Na seção Situação do Módulo, habilite a opção Operação Ativa. Após concluir as configurações, salve as alterações. A integração estará configurada para processar cobranças conforme os métodos habilitados e as permissões disponíveis na sua conta. 5 - Configurando o Webhook no Asaas O webhook é responsável por enviar notificações à Nortgraf quando ocorrerem alterações nas cobranças. Por exemplo, quando um cliente realiza um pagamento, o Asaas envia uma notificação ao endereço configurado. A Nortgraf recebe o evento e pode atualizar automaticamente a situação do pedido. Essa etapa é importante para evitar que os pedidos permaneçam pendentes após a confirmação do pagamento. Passo 1 - Acessar os Webhooks 1. Entre na sua conta do Asaas. 2. No canto superior direito, clique no ícone do seu perfil. 3. Selecione Integrações. 4. Clique na aba Webhooks. 5. Na seção Meus Webhooks, escolha a opção para adicionar um novo webhook. ### Passo 2 - Preencher os dados do webhook Na tela Adicionar Webhook, preencha os campos solicitados: Campo Configuração Este Webhook ficará ativo? Ativado Nome do Webhook Nortgraf URL do Webhook URL de recebimento de eventos disponibilizada pela Nortgraf E-mail Seu e-mail para notificações de falhas Versão da API v3 Token de autenticação Token de segurança compatível com a configuração da Nortgraf Tipo de envio Não sequencial, se suportado pela integração Fila de sincronização ativada? Ativada Importante sobre a URL: Utilize o endereço exato do webhook fornecido pela Nortgraf. Não copie URLs demonstrativas ou endereços utilizados por outras plataformas. Importante sobre o token: O Asaas disponibiliza a opção Gerar Token, que cria um token para autenticar as notificações. Esse token precisa ser reconhecido pela integração da Nortgraf. Não utilize sua chave de API como token de webhook. O tipo de envio e a autenticação devem ser compatíveis com a configuração disponibilizada pela Nortgraf. ### Passo 3 - Selecionar os eventos Role a página até a seção Adicionar Eventos. Na categoria Cobranças, estão disponíveis eventos relacionados à criação, alteração, confirmação, recebimento e cancelamento de pagamentos. Entre os eventos apresentados pelo Asaas estão: - PAYMENT_CREATED — Cobrança criada. - PAYMENT_UPDATED — Cobrança atualizada. - PAYMENT_CONFIRMED — Pagamento confirmado. - PAYMENT_RECEIVED — Pagamento recebido. - PAYMENT_OVERDUE — Cobrança vencida. - PAYMENT_DELETED — Cobrança removida. - PAYMENT_REFUNDED — Pagamento estornado. Selecione os eventos de cobrança necessários para a integração da Nortgraf. Se a integração estiver preparada para receber todos os eventos da categoria, utilize Selecionar Todos. ### Passo 4 - Salvar o webhook Após preencher as informações e selecionar os eventos: 1. Confira se o webhook está ativo. 2. Verifique se a URL está correta. 3. Confirme que a fila de sincronização está habilitada. 4. Clique em Salvar. Pronto! O webhook estará cadastrado no Asaas. A partir desse momento, os eventos selecionados poderão ser enviados à Nortgraf para processamento. 6 - Verificando o funcionamento da integração Após configurar a chave de API e o webhook, recomendamos realizar um teste antes de disponibilizar os pagamentos aos clientes. Testando um pagamento 1. Acesse sua loja. 2. Adicione um produto ao carrinho. 3. Avance até a finalização do pedido. 4. Selecione uma das formas de pagamento habilitadas. 5. Confira se a cobrança é gerada corretamente. 6. Após um pagamento real confirmado pelo Asaas, verifique se o pedido foi atualizado na Nortgraf. Atenção: Um teste com pagamento real poderá gerar cobranças ou taxas conforme as condições da sua conta Asaas. Verificando as notificações Caso o pagamento seja identificado no Asaas, mas o pedido permaneça pendente: 1. Acesse Integrações > Webhooks no Asaas. 2. Localize o webhook cadastrado. 3. Confirme se está ativo. 4. Acesse Logs de Webhooks. 5. Verifique se existem falhas no envio das notificações. Caso identifique problemas recorrentes, entre em contato com o suporte da Nortgraf e informe os detalhes do pedido e da cobrança. 7 - Seções de Configuração Criar Conta no Asaas Permite acessar o cadastro do Asaas e iniciar o processo de habilitação da conta para recebimentos. Credenciais de Integração Campo destinado à chave de API responsável pela autenticação das operações entre a Nortgraf e o Asaas. Regras de Cobrança Configurações de valores mínimos, parcelamento e juros utilizados nos pagamentos. Situação do Módulo Permite habilitar ou desabilitar a operação do Asaas na loja. Métodos Ativos Permite controlar individualmente a disponibilidade de Pix, boleto bancário e cartão de crédito. Saldo Disponível no Asaas Apresenta o saldo disponibilizado pela integração quando a consulta está funcionando corretamente. Notificações do Asaas Controla as notificações do módulo destinadas aos clientes, conforme a funcionalidade disponível na Nortgraf. Essa configuração não substitui o webhook responsável pela comunicação dos pagamentos. 8 - Problemas Comuns Minha chave de API não funciona. Verifique se a chave pertence ao ambiente correto, se está habilitada e se foi copiada integralmente. Caso esteja expirada ou revogada, será necessário gerar outra. O Pix ou o cartão não aparece na loja. Confirme se o método de pagamento está habilitado na Nortgraf e se a modalidade está disponível para sua conta no Asaas. O pagamento foi realizado, mas o pedido continua pendente. Confira a configuração do webhook, os eventos selecionados e os registros em Logs de Webhooks no Asaas. A atualização depende do recebimento e processamento correto das notificações. O webhook apresenta falhas. Verifique se a URL está correta, se o token de autenticação corresponde ao esperado pela integração e se o endereço pode receber notificações do Asaas. O cliente não consegue parcelar a compra. Confira as configurações de parcelamento sem juros, máximo de parcelas, valor mínimo por parcela e as condições disponibilizadas pelo Asaas. O saldo aparece indisponível. Verifique se a chave de API está válida e se a conta possui permissão para consultar as informações financeiras. Eventuais indisponibilidades de comunicação também podem afetar a consulta. Dica: Após concluir a configuração, mantenha a chave de API protegida e acompanhe os registros de webhook periodicamente. Isso ajuda a identificar falhas de comunicação e garantir que os pedidos sejam atualizados corretamente após o processamento dos pagamentos.

Depósito/Transferência

Depósito / Transferência Organize contas bancárias e exiba instruções claras para pagamentos manuais via transferência ou Pix. Como funciona este método? Ao ativar este módulo, as contas cadastradas são apresentadas ao cliente na finalização da compra. O processo é manual: o cliente realiza a transferência no banco dele e envia o comprovante pelo painel da loja para que você aprove o pedido. Nota: Diferente de gateways (como Asaas ou Mercado Pago), este método não baixa o estoque nem aprova o pedido automaticamente. 1 - Atenção e Regras - Dados Precisos: Mantenha nome do titular, agência e conta sempre atualizados. Informações incorretas causam desconfiança e perda de vendas. - Requisito: É necessário cadastrar o Banco (instituição) antes de criar a Conta bancária. - Pix: O QR Code é opcional, mas altamente recomendado para agilizar o pagamento via celular. 2 - Passo a Passo de Configuração 1. Cadastrar Banco: Se o banco ainda não existir na lista, clique em Novo Banco. Envie o logo e informe o nome da instituição. 2. Criar Conta: Clique em Nova Conta. Selecione o banco recém-criado na lista. 3. Dados: Preencha Agência, Número da Conta, Nome do Titular e CPF/CNPJ. Escolha o tipo (Corrente, Poupança ou Pix). 4. Instruções: No campo de observações, escreva orientações claras (ex: "Envie o comprovante para o WhatsApp X"). Se tiver um QR Code Pix, faça o upload da imagem. 5. Ativar: Salve a conta. Por fim, verifique no painel lateral se o módulo geral de Depósito está marcado como Operando. 3 - Funcionalidades - Modal Novo Banco Permite cadastrar a instituição financeira (ex: Nubank, Itaú) com logotipo para identificação visual no checkout. - Modal Nova Conta Onde você insere os dados sensíveis (Agência, Conta, Titular) que o cliente usará para fazer a transferência. - QR Code Pix Campo de upload de imagem dentro da conta. Exibe o código escaneável na tela de sucesso do pedido. - Regras e Limites Permite definir descontos para quem paga por depósito ou valores mínimos/máximos para habilitar essa opção. Dica: Antes de divulgar, faça uma compra de teste na loja. Verifique se as instruções aparecem claras na tela de "Pedido Recebido" e se você consegue enviar um comprovante.

Mercado Pago

Mercado Pago — Integração de Pagamentos Processe cartões, boletos e Pix com segurança e receba atualizações automáticas de status via webhooks. Para que serve a integração? Este módulo conecta sua loja ao Mercado Pago para criar cobranças e sincronizar o status dos pedidos. Quando um cliente paga, o Mercado Pago avisa a loja automaticamente, aprovando o pedido sem necessidade de conferência manual. Nota: O sistema suporta o modo Sandbox, permitindo que você teste todo o fluxo de compra sem gastar dinheiro real. 1 - Atenção e Segurança - Credenciais Sensíveis: Nunca compartilhe seu Access Token. Ele dá acesso total à sua conta do Mercado Pago. - Sandbox vs. Produção: Use o modo Sandbox apenas para testes. Lembre-se de desmarcar essa opção e inserir as credenciais de produção antes de inaugurar a loja. - Webhooks: Para que a atualização automática funcione, seu servidor não pode bloquear as requisições vindas do Mercado Pago. 2 - Passo a Passo de Configuração 1. Obter Chaves: Acesse o painel de desenvolvedor do Mercado Pago para copiar sua Public Key e Access Token. 2. Inserir na Loja: Cole as chaves nos campos correspondentes do módulo. Certifique-se de não trocar a chave de produção pela de teste (ou vice-versa). 3. Regras Comerciais: Configure descontos para pagamento à vista, acréscimos, valores mínimos e o número máximo de parcelas sem juros. 4. Modo de Operação: Marque a opção Sandbox se estiver em fase de testes. Para vender de verdade, deixe desmarcado. 5. Ativar e Testar: Ative o módulo e clique em Salvar. Faça um pedido de teste para confirmar se o pagamento é processado e se o status muda. 3 - Seções de Configuração - Credenciais Campos para Public Key e Access Token. Estas chaves autenticam sua loja junto ao Mercado Pago. - Regras e Taxas Defina descontos automáticos, juros de parcelamento e limites de valor para aceitar o pagamento. - Apresentação Opções para personalizar como o checkout transparente aparece para o cliente (ex: título, ícones). - Painel Lateral (Status) Controles para ativar o módulo, ligar o modo Sandbox e verificar informações sobre Webhooks. Dica: Se os pedidos ficarem "Pendentes" mesmo após o pagamento, verifique suas credenciais e se os Webhooks não estão sendo bloqueados.

PagBank

PagBank — Integração de Pagamentos Conecte seu checkout ao PagBank para centralizar cartão, boleto e Pix, tratando notificações automaticamente. Como funciona a integração? Esta integração utiliza OAuth (conexão direta). Você conecta sua conta PagBank clicando em um botão e o sistema gerencia a autorização e as notificações. Isso elimina a necessidade de copiar e colar tokens manualmente e garante maior segurança. Nota: Quando ativo, o status dos pedidos é atualizado automaticamente (ex: de "Pendente" para "Pago") conforme o retorno do banco. 1 - Atenção e Segurança - Conexão: Desconectar o módulo interrompe imediatamente o fluxo automático. Trate essa conexão como uma credencial de conta sensível. - Parcelamento: O checkout transparente exige que você configure o limite máximo de parcelas. Ajuste isso conforme sua política comercial. - Webhooks: As notificações são configuradas automaticamente. Apenas certifique-se de que não há bloqueios de rede no seu servidor que impeçam a entrega. 2 - Passo a Passo de Configuração 1. Acesso: Vá na lista de formas de pagamento e clique no módulo PagBank. 2. Conectar: Clique no botão Conectar PagBank. Siga as instruções na janela de autorização externa para vincular sua conta. 3. Regras de Preço: Defina descontos para pagamento à vista, acréscimos e valores mínimos ou máximos para aceitar pedidos. 4. Parcelamento: Configure o número máximo de parcelas e a quantidade de parcelas sem juros que você deseja oferecer. 5. Ativar e Testar: Salve as configurações. Faça uma transação de teste para confirmar que o pagamento está sendo processado e o status atualizado. 3 - Seções de Configuração - Conexão (OAuth) Área com os botões para Conectar ou Desconectar sua conta PagBank. Mostra o status atual do vínculo. - Regras e Taxas Campos para aplicar descontos automáticos ou taxas extras sobre o valor do pedido ao selecionar este método. - Apresentação e Parcelas Personalize o título exibido no checkout (ex: "Cartão de Crédito") e as regras de parcelamento. - Webhooks Bloco informativo confirmando que o gerenciamento de notificações é automático pelo sistema. Dica: Se houver problemas com notificações de pagamento, verifique primeiro se a conta consta como "Conectada" na tela e se não há bloqueios de rede.

Pagar.me — Configure o gateway de pagamento

Pagar.me — Como configurar o gateway de pagamento Integre o Pagar.me à sua loja para aceitar PIX, boleto bancário e cartão de crédito com parcelamento, usando chaves de API, formas de pagamento configuráveis e webhook para atualização automática dos pedidos. Para que serve a integração com o Pagar.me? O Pagar.me é um gateway de pagamento usado para processar cobranças em tempo real. No checkout, o cliente pode escolher PIX, boleto bancário ou cartão de crédito, conforme os métodos habilitados no painel da loja. Atenção: para o status dos pedidos ser atualizado automaticamente, o webhook precisa estar configurado corretamente no painel do Pagar.me. 1 - Antes de começar - Conta Pagar.me: é necessário ter acesso ao painel do Pagar.me para copiar as chaves de API. - Ambiente correto: use Sandbox para testes e Produção para cobranças reais. - Chave pública: usada no fluxo de pagamento do checkout, quando aplicável. - Chave secreta: usada pelo backend para criar e consultar transações. Essa chave não deve ser exposta publicamente. - Webhook: necessário para o sistema receber notificações automáticas de pagamento, falha, cancelamento ou estorno. 2 - Obtendo as chaves de API no Pagar.me Antes de configurar o gateway no painel da loja, copie as chaves de API da sua conta no Pagar.me. 1. Acesse o painel do Pagar.me: entre em dash.pagar.me e faça login na sua conta. 2. Abra as chaves de API: no menu lateral, acesse Configurações > Chaves de API. 3. Identifique o ambiente: copie as chaves de Produção para cobranças reais e as chaves de Sandbox para testes. 4. Copie as credenciais: copie a Chave Secreta, que começa com sk_, e a Chave Pública, que começa com pk_. 3 - Configurando no painel Acesse Configurações > Pagamentos > Pagar.me e preencha as informações do gateway. 1. Selecione o ambiente: escolha Produção para cobranças reais ou Sandbox para testes. Durante a configuração inicial, prefira Sandbox. 2. Preencha a Chave Secreta: cole a chave secreta correspondente ao ambiente selecionado. 3. Preencha a Chave Pública: cole a chave pública correspondente ao ambiente selecionado. 4. Escolha as formas de pagamento: marque os métodos que ficarão disponíveis no checkout, como PIX, Boleto Bancário e Cartão de Crédito. 5. Salve as configurações: após preencher as chaves e selecionar as formas de pagamento, salve para ativar o módulo. Importante: confira se as chaves usadas pertencem ao mesmo ambiente selecionado. Misturar chaves de Sandbox com Produção pode impedir a criação das cobranças. 4 - Formas de pagamento disponíveis O gateway pode disponibilizar diferentes métodos de pagamento no checkout, conforme a configuração da loja. - PIX O sistema gera um QR Code para pagamento. Após a confirmação, o Pagar.me notifica a loja pelo webhook. - Boleto bancário O sistema gera um link de boleto para pagamento. A confirmação ocorre após compensação e notificação do gateway. - Cartão de crédito O pagamento é processado no checkout e pode permitir parcelamento, conforme as regras configuradas. 5 - Configurando o parcelamento no cartão As regras de parcelamento definem como o cartão de crédito será apresentado no checkout. - Parcelas sem juros Número máximo de parcelas sem cobrança de juros para o cliente. Exemplo: configurar 3 significa que de 1x a 3x o valor total não muda. - Total de parcelas Número máximo de parcelas disponíveis no checkout, incluindo parcelas com juros. Pode ser configurado de acordo com a política da loja. - Juros ao mês (%) Taxa mensal aplicada às parcelas acima do limite sem juros. O sistema calcula o total corrigido e exibe o valor atualizado de cada parcela no checkout. - Valor mínimo do pedido Define o valor mínimo para finalizar pedidos pelo Pagar.me. Configure 0 para não aplicar limite mínimo. 6 - Configurando o webhook O webhook é a URL que o Pagar.me chama automaticamente quando um pagamento é confirmado, recusado, cancelado ou estornado. Sem ele, o sistema não recebe as atualizações automáticas do gateway. 1. Copie a URL do webhook: na tela de configuração do Pagar.me no painel da loja, copie a URL do Webhook exibida. 2. Acesse os webhooks no Pagar.me: no painel do Pagar.me, vá em Configurações > Webhooks. 3. Adicione um endpoint: clique em Adicionar endpoint e cole a URL copiada do painel da loja. 4. Selecione os eventos: marque os eventos necessários para atualização dos pedidos, como order.paid, order.payment_failed, order.canceled, charge.paid e charge.refunded. 5. Salve o webhook: finalize o cadastro do endpoint no Pagar.me e mantenha a URL atualizada sempre que ela for alterada no painel da loja. Importante: a URL do webhook contém um token de segurança. Se a URL for regenerada ou alterada no painel da loja, atualize também o endpoint no painel do Pagar.me. 7 - Resumo do fluxo de pagamento Depois de configurado, o fluxo do pedido passa a ser automatizado entre a loja, o cliente e o Pagar.me. 1. Cliente finaliza o carrinho: o cliente escolhe a forma de pagamento disponível no checkout. 2. O sistema cria a cobrança: a loja envia os dados do pedido para o Pagar.me e recebe o QR Code, link do boleto ou confirmação do cartão. 3. Cliente realiza o pagamento: o pagamento é feito pelo aplicativo do banco, boleto ou cartão de crédito, conforme o método escolhido. 4. Pagar.me chama o webhook: o gateway envia uma notificação para a loja informando o status atualizado do pagamento. 5. Pedido é atualizado: o sistema altera automaticamente o status do pedido e pode enviar a confirmação ao cliente. 8 - Boas práticas de configuração Para evitar falhas no checkout e inconsistências nos pedidos, valide a configuração antes de liberar o gateway em produção. - Configure primeiro o ambiente Sandbox e realize uma compra de teste. - Confirme se as chaves pertencem ao ambiente selecionado. - Nunca exponha a Chave Secreta em páginas públicas ou scripts de frontend. - Cadastre o webhook antes de ativar o gateway em produção. - Verifique se os eventos necessários foram selecionados no painel do Pagar.me. - Atualize o webhook no Pagar.me sempre que a URL for alterada no painel da loja. - Teste PIX, boleto e cartão separadamente, se todos estiverem habilitados. Dica: antes de ativar a produção, realize uma compra de teste em Sandbox e confirme se o pedido foi criado, se o pagamento foi processado e se o webhook atualizou o status corretamente.

Tela de Pagamentos — Aprove e gerencie recebimentos

Tela de Pagamentos — Como aprovar e gerenciar recebimentos Centralize os recebimentos da loja, aprove comprovantes enviados pelos clientes, registre formas de pagamento, informe a conta bancária de destino e acompanhe o status de cada pagamento. Para que serve a tela de pagamentos? A tela de pagamentos permite controlar recebimentos vindos de pedidos online, vendas no PDV e cobranças avulsas. Ela é usada principalmente para validar pagamentos manuais, como depósito, transferência ou comprovantes enviados pelo cliente. Atenção: pagamentos via gateway, como PIX, boleto ou cartão, normalmente são aprovados automaticamente por webhook. Pagamentos manuais exigem conferência do operador. 1 - Antes de começar - • Pagamentos manuais: precisam ser conferidos e aprovados por um operador antes do pedido avançar. - • Comprovantes: devem ser analisados com atenção para confirmar valor, data, titularidade e identificação do pedido. - • Conta bancária: deve ser informada corretamente para manter a conciliação financeira organizada. - • Impacto no pedido: ao aprovar o pagamento, o pedido pode avançar automaticamente para o próximo status configurado. 2 - Entendendo os status de pagamento Pendente Aguardando ação do operador. O cliente pode ter enviado o comprovante ou ainda não ter realizado o pagamento. Aprovado Pagamento confirmado. O pedido avança para o próximo status e o cliente pode receber a confirmação por e-mail. Reprovado Comprovante recusado. O cliente poderá enviar um novo comprovante para reanálise, se o fluxo estiver disponível. Cancelado Pagamento cancelado. Nesse caso, nenhuma ação adicional é esperada para aquele recebimento. 3 - Como aprovar um pagamento Clique no pagamento com status Pendente e selecione a opção Aprovar. 1. 01 Confirme a forma de pagamento: selecione como o valor foi recebido, como PIX, depósito, dinheiro, cartão, cheque ou crédito da loja. 2. 02 Defina a condição de pagamento: informe se o recebimento foi à vista, parcelado, parcial, a prazo ou cortesia. - À vista: recebimento integral de uma só vez. - Parcelado: recebimento dividido em parcelas. - Pagto parcial: cliente pagou apenas parte do valor do pedido. - A prazo: pagamento combinado para uma data futura. - Cortesia: pedido liberado sem cobrança. 3. 03 Selecione a conta bancária: informe em qual conta o valor foi depositado ou recebido. Essa informação é importante para a conciliação financeira. 4. 04 Informe a data do pagamento: registre quando o valor foi recebido. Por padrão, o sistema pode preencher com a data atual. 5. 05 Ajuste o valor, se necessário: use esse campo apenas quando o valor aprovado for diferente do valor original do pedido, como em pagamentos parciais ou correções operacionais. 6. 06 Confirme a aprovação: clique em Aprovar Pagamento. O status será alterado para Aprovado, o pedido será atualizado e o cliente poderá receber a confirmação. 4 - Como reprovar um pagamento Use a reprovação quando o comprovante enviado pelo cliente for inválido, ilegível, duplicado ou não corresponder ao valor do pedido. 1. 01 Abra o pagamento pendente: localize o registro na listagem e clique para visualizar os detalhes. 2. 02 Clique em Reprovar: confirme a ação após revisar as informações do comprovante. 3. 03 Aguarde novo envio: o cliente poderá ser notificado e enviar um novo comprovante para análise, conforme o fluxo configurado na loja. 5 - Filtrando e buscando pagamentos A listagem possui filtros para facilitar a localização dos recebimentos. Origem Filtra por pedido, cobrança avulsa ou venda no PDV. Status Pendente, Aprovado, Reprovado ou Cancelado. Forma de pagamento PIX, boleto, cartão, depósito, dinheiro, cheque ou outras formas cadastradas. Cliente Busca por nome, CPF ou CNPJ do cliente. Período Filtra os pagamentos por data inicial e final. Número do pedido Busca diretamente pelo pedido associado ao pagamento. 6 - Boas práticas no dia a dia Para evitar atrasos na produção e inconsistências no financeiro, mantenha uma rotina de conferência dos pagamentos pendentes. - • Verifique os pagamentos pendentes diariamente. - • Confirme se o valor recebido corresponde ao valor do pedido. - • Informe corretamente a conta bancária de destino. - • Reprove comprovantes inválidos para permitir novo envio pelo cliente. - • Evite aprovar pagamentos parciais sem registrar corretamente a condição de pagamento. Dica: pedidos com pagamento aguardando aprovação podem ficar travados até que o operador aprove ou reprove o recebimento. Crie uma rotina de conferência para evitar atrasos no atendimento e na produção.

PayPal — Configure o gateway de pagamento

PayPal — Configure o gateway de pagamento Aceite pagamentos com saldo PayPal ou cartão, usando redirecionamento ou uma experiência integrada à página da loja. Para que serve este módulo? A integração com PayPal adiciona uma forma de pagamento ao checkout. A loja utiliza as credenciais do aplicativo PayPal para criar e confirmar pagamentos com segurança. 1 - Pré-requisitos - Conta comercial PayPal apta a receber pagamentos. - Aplicativo REST criado no PayPal Developer Dashboard. - Client ID e Client Secret do ambiente Live. - Permissão para editar Formas de Pagamento. 2 - Criando o aplicativo no PayPal 1. Acesse o PayPal Developer Dashboard com a conta da empresa. 2. Abra a área de aplicativos e crie um aplicativo REST. 3. Selecione o ambiente de produção para obter as credenciais Live. 4. Copie o Client ID e o Client Secret. Não envie o Client Secret por mensagens, e-mail ou capturas de tela. 3 - Configurando na loja 1. Acesse Configurações > Formas de Pagamento > PayPal. 2. Cole o Client ID e o Client Secret nos campos de produção. 3. Escolha o estilo do checkout. 4. Defina valores mínimo e máximo, se desejar. 5. Mantenha o módulo inativo enquanto conclui o webhook e os testes. 6. Salve as configurações. 4 - Escolhendo o estilo do checkout Padrão O cliente é direcionado ao PayPal para aprovar o pagamento e retorna à loja ao finalizar. Transparente O botão PayPal aparece na página da loja e abre a aprovação sobre o checkout, sem trocar a página principal. 5 - Configurando o webhook 1. Copie a URL do Webhook exibida na configuração. 2. No aplicativo PayPal, crie um webhook usando essa URL. 3. Marque eventos de aprovação/conclusão do pedido e captura concluída, negada, reembolsada ou pendente. 4. Copie o Webhook ID gerado e cole na loja. 5. Salve novamente. O Webhook ID permite verificar se as notificações realmente foram enviadas pelo PayPal. 6 - Ativação e teste 1. Revise credenciais, webhook, estilo e limites de valor. 2. Ative o módulo e salve. 3. Faça um pedido de teste de baixo valor. 4. Confirme retorno para a loja e atualização do pagamento no painel. 5. Verifique também cancelamento e tentativa negada. O ambiente Sandbox pode estar disponível apenas em ambientes autorizados da plataforma. Na loja em produção, utilize credenciais Live. 7 - Problemas comuns PayPal não aparece no checkout Confira se o módulo está ativo e se o valor do pedido respeita os limites configurados. Credenciais inválidas Confirme que Client ID e Secret pertencem ao mesmo aplicativo e ao ambiente correto. Pagamento aprovado não atualizou Revise URL, eventos e Webhook ID. Consulte também o pagamento no painel antes de alterar o status manualmente. Atenção: Nunca publique ou compartilhe o Client Secret. Se houver suspeita de exposição, gere uma nova credencial no PayPal e atualize imediatamente a configuração da loja.

Cobranças e links públicos de pagamento

Cobranças e links públicos de pagamento Gere um link seguro para cobrar valores avulsos ou pendências vinculadas a pedidos e pagamentos. Para que serve este módulo? A cobrança pública permite enviar ao cliente uma página de pagamento sem criar uma nova compra na loja. Ela pode ser avulsa ou nascer com dados preenchidos a partir de um pedido ou pagamento existente. 1 - Quando usar - Cobrar um serviço adicional. - Receber ajuste de orçamento. - Cobrar saldo pendente de um pedido. - Gerar uma cobrança administrativa sem adicionar produtos ao carrinho. Quando a cobrança se refere a um pedido existente, prefira iniciá-la pela ação daquele pedido ou pagamento para manter o vínculo. 2 - Criando uma cobrança 1. Acesse Pagamentos e clique em Nova cobrança. 2. Selecione o cliente, caso os dados não tenham vindo preenchidos. 3. Informe uma descrição clara. 4. Digite o valor e a data de vencimento. 5. Escolha uma forma sugerida ou permita que o cliente escolha no link. 6. Clique em Gerar cobrança. 3 - Cobrança vinculada Ao gerar a cobrança a partir de um pedido ou pagamento, o sistema preenche origem, cliente, descrição e valor disponíveis. Revise tudo antes de gerar o link. O vínculo ajuda a identificar por que o valor foi cobrado, mas não dispensa a conferência do pedido e de seu saldo. 4 - Enviando o link 1. Abra a cobrança gerada. 2. Copie o link público usando a ação disponível. 3. Envie somente ao cliente correto por um canal confiável. 4. Informe valor, vencimento e motivo da cobrança na mensagem. O cliente acessa uma página segura e escolhe entre as formas disponíveis para aquela cobrança. 5 - Formas de pagamento As opções exibidas dependem dos módulos ativos e configurados na loja. A forma sugerida orienta o fluxo, mas o cliente poderá escolher outra quando a cobrança permitir. Em depósito ou Pix manual, pode ser necessário enviar comprovante. Em integrações automáticas, aguarde a confirmação do gateway. 6 - Acompanhando o pagamento Acompanhe o estado pela tela de Pagamentos. O link pode apresentar aguardando, confirmado ou erro conforme o processamento. - Não marque como pago apenas com base em uma captura enviada pelo cliente. - Confirme o recebimento no gateway ou na conta bancária quando necessário. - Evite gerar várias cobranças para o mesmo saldo. 7 - Problemas comuns O cliente não consegue pagar Confira vencimento, valor, situação da cobrança e módulos de pagamento ativos. O pagamento continua aguardando Aguarde o retorno do gateway e consulte novamente. Pagamentos manuais dependem da conferência do comprovante. Dados incorretos Não envie o link. Cancele ou desconsidere a cobrança conforme o fluxo disponível e gere outra com os dados corretos. 8 - Boas práticas - Use descrições que o cliente reconheça. - Defina vencimento realista. - Confirme o cliente antes de compartilhar. - Registre observações no pedido quando houver saldo ou serviço adicional. - Confira a baixa antes de liberar produto, entrega ou serviço. Atenção: O link é individual e contém informações da cobrança. Envie-o somente ao cliente correspondente e nunca considere um pagamento confirmado antes da validação no painel ou no gateway.

Pagamento parcial — Sinal e saldo restante

Pagamento parcial — Sinal e saldo restante Permita que clientes autorizados paguem um percentual como entrada e quitem o restante depois. Para que serve este módulo? O pagamento parcial divide a cobrança em duas etapas: sinal e saldo restante. A loja define o percentual padrão, autoriza clientes individualmente e acompanha o que já foi recebido antes da quitação. 1 - Como funciona 1. A loja ativa o recurso e define o percentual padrão. 2. O cliente precisa estar autorizado para pagamento parcial. 3. No checkout, ele escolhe pagar apenas o sinal. 4. Após a confirmação, o pedido registra sinal pago e saldo restante. 5. O saldo é quitado posteriormente pelo link ou pelo painel. 2 - Ativando na loja 1. Acesse Configurações > Preferências Gerais. 2. Localize a seção de pagamento parcial. 3. Ative o recurso. 4. Informe o percentual do sinal entre 1% e 99%. 5. Salve as configurações. O percentual é usado no checkout da loja. Em fluxos administrativos, o operador pode registrar um valor parcial específico quando a tela permitir. 3 - Autorizando um cliente 1. Acesse Vendas > Clientes. 2. Abra o cadastro do cliente. 3. Na seção de acesso ou condições comerciais, ative Permitir pagamento parcial. 4. Salve o cadastro. A configuração global sozinha não libera a opção para todos os clientes; a autorização individual também precisa estar ativa. 4 - Pagamento do sinal No checkout, o cliente autorizado pode escolher o pagamento parcial. O sistema calcula o sinal usando o percentual configurado e envia somente esse valor ao meio de pagamento selecionado. Depois da confirmação do gateway ou da aprovação manual, o pedido passa a exibir o sinal pago e o valor restante. 5 - Quitando o saldo restante O cliente pode acessar o pedido em sua conta e usar a opção de pagar o restante quando disponível. A equipe também pode abrir o pedido ou a tela de Pagamentos e gerar/confirmar a cobrança do saldo. 1. Confira o valor do sinal confirmado. 2. Verifique o saldo restante. 3. Escolha a ação para cobrar ou confirmar o restante. 4. Aguarde a confirmação do pagamento. 5. Confira se o pedido ficou integralmente pago. 6 - Acompanhamento no painel As telas de Pedidos e Pagamentos distinguem valor total, sinal e saldo. Recibos e páginas do cliente também podem apresentar essa divisão. Não altere manualmente o status para pago se o saldo ainda não tiver sido recebido. 7 - Problemas comuns A opção não aparece no checkout Confira a configuração global, a permissão do cliente e se ele está identificado na loja. O sinal foi pago, mas não atualizou Verifique o retorno do gateway ou a aprovação manual antes de cobrar novamente. Valor do sinal incorreto Revise o percentual configurado e confirme se o pedido foi criado antes ou depois da alteração. Saldo não pode ser pago Confirme que o sinal está marcado como pago e que ainda existe valor restante. 8 - Boas práticas - Defina uma política clara para sinal e produção. - Libere a condição somente para clientes aprovados. - Não inicie etapas críticas sem confirmar o sinal quando essa for a regra. - Confira o saldo antes da entrega. - Evite cobranças duplicadas do restante. Atenção: Pagamento parcial não significa pedido quitado. Verifique sempre o sinal confirmado e o saldo restante antes de liberar produção, entrega ou retirada.

Minha Assinatura — Plano, limites e faturas

Minha Assinatura — Plano, limites e faturas Consulte o plano atual, acompanhe o consumo de recursos e gerencie cobranças e adicionais da plataforma. ● Para que serve este módulo? A página Minha Assinatura centraliza o estado do contrato da Nortgraf. Ela mostra plano, período, limites, utilização, faturas e ações disponíveis para alteração ou cancelamento. ## 1 - Resumo do plano atual Confira nome do plano, valor, ciclo de cobrança e estado da assinatura. Os estados podem indicar ativa, período de teste, expirada, cancelada ou com cancelamento agendado. Observe também a data de renovação ou término apresentada. ## 2 - Acompanhando limites Os indicadores comparam o uso atual aos limites do plano, como armazenamento ou outros recursos contratados. Quando o limite aparece como Ilimitado, não há uma cota numérica para aquele item. Percentuais altos indicam que é hora de revisar arquivos, usuários ou capacidade contratada. ## 3 - Alterando o plano 1. Acesse Minha Assinatura. 2. Confira o plano e o consumo atuais. 3. Abra a opção de ver ou alterar planos. 4. Compare recursos, limites, ciclo e preço. 5. Revise o resumo financeiro antes de confirmar. 6. Aguarde a confirmação do pagamento ou da alteração. ## 4 - Recursos adicionais Quando disponível, a área de adicionais permite contratar capacidade ou funcionalidades sem trocar todo o plano. Confira quantidade, recorrência, preço e impacto na próxima cobrança. Um adicional pode depender de assinatura ativa e das regras do plano atual. 5 - Faturas e pagamentos Use o histórico para consultar cobranças, vencimentos e estados de pagamento. Se houver uma cobrança pendente, abra o fluxo de pagamento e confirme o resultado antes de tentar novamente. Evite gerar várias tentativas para a mesma fatura sem conferir o retorno anterior. ## 6 - Cancelamento agendado Quando o cancelamento estiver agendado, a assinatura pode continuar ativa até a data indicada. Leia as condições apresentadas e confirme o que acontecerá com acesso, dados e recursos após o encerramento. ## 7 - Problemas comuns Pagamento não atualizou Aguarde o retorno do provedor, atualize a página e confira a fatura antes de repetir. Recurso bloqueado Verifique estado da assinatura, limite consumido e se o recurso pertence ao plano. Percentual acima do esperado Revise o consumo detalhado e adicionais ativos. Alteração não aparece Confirme se o pagamento ou a solicitação foi concluído. 8 - Boas práticas - Revise o uso antes da renovação. - Mantenha os dados de cobrança atualizados. - Guarde comprovantes e faturas. - Compare limites antes de trocar de plano. - Não interrompa uma tentativa de pagamento durante o processamento. Atenção: Alterações de plano, adicionais e cancelamentos podem mudar valores ou acesso a recursos. Revise sempre o resumo e as datas antes de confirmar.

Créditos da plataforma — Saldo e movimentações

Créditos da plataforma — Saldo e movimentações Consulte o saldo disponível e acompanhe entradas e utilizações de crédito na Nortgraf. ● Para que serve este módulo? Créditos da plataforma são valores usados em serviços, assinatura ou recursos aceitos pela Nortgraf. Eles são diferentes do crédito comercial concedido a clientes da loja. ## 1 - Entendendo o saldo A página mostra o saldo disponível em reais. Esse valor considera as movimentações já efetivadas; créditos pendentes ou em validação podem não estar incluídos. 2 - Histórico de movimentações Consulte data, descrição, origem, tipo e valor de cada entrada ou saída. Use o histórico para relacionar bônus, indicações, ajustes e utilizações. 3 - Como os créditos entram Créditos podem vir de programas, promoções ou ajustes autorizados. No programa de indicações, o valor só entra após cumprir as regras e o período de validação. 4 - Utilização Quando uma cobrança aceitar crédito, confira o valor aplicado e o saldo restante antes de confirmar. A disponibilidade depende do serviço e das regras mostradas no pagamento. 5 - Validade A página atual informa que os créditos não expiram e podem ser usados livremente na plataforma. Se as condições forem alteradas, considere sempre a informação exibida no momento. 6 - Diferença para crédito de cliente Crédito de cliente pertence ao relacionamento comercial entre a gráfica e seu comprador. Crédito da plataforma pertence à conta da Nortgraf e não deve ser lançado como saldo do cliente. 7 - Problemas comuns Crédito não apareceu Confira se ainda está em validação e identifique a origem. Saldo diminuiu Revise as saídas no histórico. Não foi aplicado Confirme se a cobrança aceita crédito e se o saldo estava disponível. Movimento desconhecido Registre data, valor e descrição e procure o suporte. Atenção: Não confunda créditos da plataforma com créditos concedidos aos clientes da gráfica. Sempre confira o histórico antes de solicitar ajustes.