# 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](http://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**. ![](https://cdn.nortgraf.com.br/help_center/articles/2026/10/artigo_6ac7bd67af70d2.50309015.png)### 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**. ![](https://cdn.nortgraf.com.br/help_center/articles/2026/10/artigo_6ac7bd78118115.35128132.png)### 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**. ![](https://cdn.nortgraf.com.br/help_center/articles/2026/10/artigo_6ac7bd93e9be19.88674488.png)### 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. ![](https://cdn.nortgraf.com.br/help_center/articles/2026/10/artigo_6ac7bda0542ca0.17705275.png)### 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. ![](https://cdn.nortgraf.com.br/help_center/articles/2026/10/artigo_6ac7bdb09c3b82.39258455.png)### 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. ![](https://cdn.nortgraf.com.br/help_center/articles/2026/10/artigo_6ac7bdbd4ba689.56545941.png)### 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**. ![](https://cdn.nortgraf.com.br/help_center/articles/2026/10/artigo_6ac7bdce305208.47765188.png)### 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.